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内 容 提 要 

本 书 是 C# 领域 久 负 辟 名 的 经 典 著 作 ， 深 入 全 面 地 讲解 了 C# 编程 语言 和 .NET 平台 的 核心 内 容 ， 并 结 
合 大 量 示例 剖析 相关 概念 。 全 书 分 为 八 部 分 : C# 和 .NET 平台 、C# 核心 编程 结构 、C# 面向 对 象 编程 、 高 
级 C# 编程 结构 、 用 .NET 程序 集 编程 、.NET 基础 类 库 、WPEF 和 ASPNET Web Forms。 第 6 版 是 对 第 5 版 
的 进一步 更 新 和 完善 ， 内 容 涵 盖 了 最 先进 的 .NET 编程 技术 和 技巧 ， 并 准确 呈现 出 C# 编程 语言 的 最 新 变化 
和 .NET 4.5 Framework 的 新 特性 。 

本 书 由 微软 C# MVP Andrew Troelsen 编写 , 第 6 版 专门 针对 C#5.0 和 .NET 4.5 进行 了 细致 入 微 的 修订 ， 
是 各 层次 .NET 开发 人 员 的 必 读 之 作 。 
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大 约 2001 年 ， 我 有 幸 获得 一 个 机 会 ， 为 即将 兴起 的 一 种 微软 技术 撰写 一 本 书 ， 那 时 这 种 技术 被 称 
为 NGWS (Next Generation Windows Software， 下 一 代 视 窗 服务 ) 。 在 检查 微软 提供 的 源 代码 的 过 程 
中 ， 我 发 现 大量 代 码 注释 与 一 种 COOL ( Common Object Oriented Language ) 编程 语言 相关 。 

在 我 使 用 预览 版 创作 C#and the .MET Platformt 第 1 版 ) 初 稿 的 过 程 中 ,NGWS 最 终 更 名 为 微软 .NET 
平台 ， 而 COOL， 你 应 该 能 猜 到 ， 就 是 今天 众所周知 的 C#。 

本 书 第 1 版 与 NET 1.0 Beta 2 同时 推出 。 从 那 以 后 ， 随 着 C# 编 程 语言 的 更 新 以 及 新 发 布 的 NET 平 
台 引 入 大 量 API， 本 书 内 容 也 不 断 修订 。 

这 些 年 来 ， 本 书 得 到 了 出 版 社 ( 曾 入 围 Jolt 大奖 提名 ， 获 得 2003 年 Referenceware 编程 类 图 书 卓 
越 大 奖 )、 读 者 、 计 算 机 科学 和 软件 工程 类 大 学 课程 的 认可 。 对 此 我 甚 是 感激 。 

更 重要 的 是 ， 很 高 兴 收 到 全 世界 读者 和 教育 工作 者 发 来 的 邮件 ,与 他 们 交谈 感觉 很 棒 。 感 谢 所 有 
人 的 意见 、 评 论 ， 当 然 还 有 批评 。 也 许 有 些 邮 件 我 来 不 及 回复 ， 但 我 充分 考虑 了 每 一 封 邮 件 提 出 的 问 
题 ， 这 一 点 可 以 保证 。 


你 和 我 ， 我 们 是 一 个 团队 


技术 作家 所 面 对 的 是 一 群 苛 刻 的 读者 (我 知道 ， 因 为 我 就 是 他 们 中 的 一 员 )。 无 论 使 用 什么 平台 ， 
对 部 门 、 公 司 、 客 户 和 任何 课题 来 说 ， 构 建 软件 解决 方案 都 是 非常 复杂 而 且 有 针对 性 的 事情 。 可 能 你 在 
电子 出 版 行业 工作 ， 或 者 为 政府 开发 系统 ， 或 者 是 在 科研 机 构 或 军队 的 某 个 部 门 工作 。 就 我 自己 而 言 ， 
我 开发 过 儿童 教育 软件 ( Oregon Trail、Amazon Trail 等 游戏 软件 )、 各 种 n 层 系 统 以 及 许多 医疗 和 金融 行 
业 的 项 目 。 你 工作 时 编写 的 代码 和 我 编写 的 代码 百分之百 是 不 同 的 ( 除非 我 们 恰巧 以 前 在 一 起 工作 )。 

因此 , 在 这 本 书 中 , 我 特意 避免 选择 那些 和 具体 行业 紧密 相关 的 例子 ,而 是 用 与 行业 无 关 的 例子 
来 解释 C#、OOP、CLR 和 .NET 基础 类 库 。 我 不 使 用 诸如 数据 填充 表格 、 薪 水 计算 或 者 其 他 的 一 些 例 
子 ， 而 是 坚持 用 与 我 们 都 有 联系 的 主题 : 汽车 ， 另 外 再 加 上 几何 结构 和 雇员 薪水 系统 作为 补充 示例 。 
你 不 用 担心 会 有 什么 陌生 的 背景 知识 。 

我 要 做 的 是 尽 最 大 可 能 解释 C# 编 程 语言 和 .NET 平 台 的 核心 内 容 。 同 时 ， 我 会 尽 可 能 把 进一步 学 
习 本 书 的 工具 和 策略 提供 给 你 。 

你 要 做 的 是 理解 这 些 内 容 并 将 其 付 诸 具体 编程 工作 中 。 我 很 清楚 ， 你 的 项 目 可 能 与 具有 友好 昵称 
的 汽车 ( 比如 ，BMW 的 Zippy 和 Yugo 的 Clunker ) 根本 无 关 ， 但 是 所 用 到 的 知识 是 相通 的 。 

放心 ， 只 要 理解 了 这 本 书 中 的 概念 ， 你 便 能 够 很 好 地 构建 一 个 和 实际 编程 环境 紧密 相关 的 .NET 
解决 方案 。 
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本 书 内 容 
本 书 从 逻辑 上 分 为 8 个 部 分 , 每 个 部 分 包含 一 些 相 关联 的 章节 。 下 面 先 按 部 分 , 再 按 章 来 分 解 本 书 。 


第 一 部 分 : C# 与 .NET 平 台 


第 一 部 分 的 目的 在 于 让 你 初步 适应 并 了 解 .NET 平台 以 及 在 构造 .NET 应 用 中 用 到 的 各 种 开发 工具 
(其 中 很 多 是 开源 的 )。 

第 1 章 : .NET 之 道 

这 一 章 讲述 本 书 其 余部 分 的 脉络 。 该 章 的 主要 目的 是 介绍 许多 .NET 相关 的 构建 块 ， 如 CLR ( 公 
共 语 言 运 行 库 )、CTS ( 公共 类 型 系统 )、CLS ( 公共 语言 规范 ) 以 及 基础 类 库 。 该 章 让 你 对 C# 编 程 语 
言 和 .NET 程序 集 格 式 有 一 个 初步 了 解 ， 此 外 ， 本 章 还 会 介绍 Windows 8 操作 系统 中 .NET 平 台 的 作用 ， 
并 讲述 Windows 8 应 用 程序 和 .NET 应 用 程序 之 间 的 区 别 。 

第 2 章 : 构建 C# 应 用 程序 

这 一 章 介绍 如 何 使 用 各 种 工具 和 技术 来 编译 C# 源 代码 文件 。 先 介绍 了 如 何 使 用 命令 行 编译 器 
(csc.exe ) 和 C# 啊 应 文件 ， 接 着 介绍 了 许多 代码 编辑 器 和 IDE ( 集成 开发 环境 )， 包 括 Notepad++、 
SharpDevelop 、Visual C# Express 以 及 Visual Studio; 同时 也 会 介绍 如 何 通过 在 本 地 安装 .NET Framework 
4.5 SDK 文档 来 配置 自己 开发 用 的 电脑 。 


第 二 部 分 : C# 核 心 编程 结构 


这 部 分 很 重要 ， 因 为 所 有 类 型 的 .NET 软件 开发 都 必须 用 到 它 ， 如 Web 应 用 、GUI 桌面 应 用 、 代 
码 库 和 Windows 服务 。 你 将 会 在 这 里 了 解 .NET 基本 数据 类 型 ， 学 习 文本 处 理 以 及 各 种 C# 参 数 修饰 符 的 
作用 (包括 可 选 参 数 和 命名 参数 ) 。 

第 3 章 : C# 核 心 编程 结构 [ 

这 一 章 正式 开始 研究 C# 编 程 语言 ， 其 中 介绍 了 Main() 方 法 的 作用 和 .NET 平 台 的 内 部 数据 类 型 ， 
以 及 使 用 了 System.String 和 System.Text.StringBuilder 的 文本 数据 操作 。 本 章 还 讨论 了 迭代 和 选择 
构造 、 宽 化 和 罕 化 操作 以 及 unchecked 关键 字 的 用 法 。 

第 4 章 : C# 核 心 编程 结构 [I 

这 一 章 完成 了 C# 核 心 方面 的 研究 ,首先 介绍 重 载 类 型 方法 的 结构 以 及 如 何 通过 out ,ref 和 params 
关键 字 定 义 参 数 ， 接 着 介绍 了 C# 的 两 个 特性 参数 ( argument ) 和 可 选 参 数 ( optional parameter ) ， 然 
后 介绍 了 如 何 创建 和 操作 数据 数组 ， 定 义 可 空 数据 类 型 ( 使 用 ?和 ?? 操 作 符 ) 以 及 值 类 型 ( 包括 枚 举 
和 自 定义 结构 ) 和 引用 类 型 之 间 的 区 别 。 


第 三 部 分 : C# 面向 对 象 编 程 


从 这 一 部 分 开始 我 们 深入 学 习 C# 语 言 的 核心 构造 ， 其 中 包括 面向 对 象 编程 语言 (OOP ) 的 细节 。 
此 外 ， 我 们 还 要 研究 一 下 如 何 处 理 运 行 时 异常 ， 并 详细 阐述 强 类 型 接口 的 使 用 方法 。 





前 


dg 
LD 


第 5 章 : 封装 

从 这 一 章 开始 ， 我 们 会 研究 如 何 使 用 C# 编 程 语言 进行 面向 对 象 编程 。 在 探讨 了 OOP 的 支柱 概念 
( 封装、 继承 和 多 态 ) 之 后 ， 会 介绍 如 何 使 用 构造 函数 、 属 性 、 静 态 成 员 、 常 量 以 及 只 读 字段 来 构建 
健壮 的 类 类 型 。 我 们 最 后 会 研究 分 部 类 型 定义 、 初 始 化 对 象 的 语法 和 自动 属性 。 

第 6 章 : 继承 和 多 态 

这 一 章 研究 OOP 其 余 的 支柱 概念 ( 继承 和 多 态 )， 通 过 它 ， 我 们 就 能 构建 相关 类 类 型 的 家 族 。 我 
们 还 会 研究 虚 方 法 、 抽 象 方法 ( 和 抽象 基 类 ) 以 及 多 态 接口 的 本 质 。 这 一 章 最 后 介绍 .NET 平台 最 高 
层 基 类 System.0bject 的 作用 。 

第 7 章 : 结构 化 异常 处 理 

这 一 章 的 关键 在 于 讨论 如 何 使 用 结构 化 异常 处 理 来 处 理 运行 时 的 异常 情况 。 你 不 但 可 以 学 到 
C# 控 制 这 些 异常 的 关键 字 ( try、catch、throw 和 finally ), 还 将 了 解 应 用 程序 级 异常 和 系统 级 异 
常 的 区 别 。 另 外 ， 该 章 还 讲述 了 Visual Studio 中 不 同 的 调试 工具 ， 这 些 工具 能 让 你 调试 那些 被 忽 
略 的 异常 。 

第 8 章 : 接口 

这 一 章 的 内 容 建立 在 对 面向 对 象 开发 的 理解 之 上 ,涵盖 了 基于 接口 的 编程 主题 。 你 将 学 到 如 何 定 
义 类 和 支持 多 行为 的 结构 ， 如 何在 运行 时 发 现 这 些 行为 ， 以 及 如 何 使 用 显 式 接口 实现 来 选择 性 地 隐藏 
特定 的 行为 。 除 了 创建 大 量 自 定义 接口 外 ， 还 介绍 了 如 何 实现 .NET 平台 中 的 标准 接口 ， 以 及 使 用 这 
些 接口 构建 可 以 排序 、 复 制 、 枚 举 和 比较 的 对 象 。 


第 四 部 分 : 高 级 C# 编 程 结构 


这 部 分 介绍 了 许多 重要 的 高 级 技术 ， 能 让 你 对 C# 噩 言 有 更 深 的 理解 。 通 过 对 接口 和 委托 的 学 习 ， 
你 将 会 了 解 .NET 类 型 系统 ; 同时 你 会 学 到 泛 型 的 作用 ,初步 了 解 LINQ， 以 及 更 多 C# 高 级 特性 ( 例 
如 扩展 方法 、 分 部 方法 和 指针 操作 )。 

第 9 章 : 集合 与 泛 型 

这 一 章 首先 研究 泛 型 ( generic ) 的 概念 。 你 将 看 到 ， 泛 型 编程 提供 了 一 种 创建 类 型 和 类 型 成 员 的 
方式 ， 它 包含 由 调用 者 指定 的 变量 占 位 符 。 简 而 言 之 , 泛 型 编程 大 大 加 强 了 应 用 程序 的 性 能 和 类 型 安 
全 。 你 不 仅 可 以 在 System.Collections.Generic 命名 空间 中 看 到 各 种 泛 型 ， 而 且 可 以 学 习 如 何 创建 自 
己 的 泛 型 方法 和 类 型 ( 有 限制 或 没有 限制 )。 

第 10 章 : 委托 、 事 件 和 Lambda 表达 式 

这 一 章 的 目的 在 于 阐明 委托 ( delegate ) 类 型 。 可 以 简单 地 认为 ， 一 个 .NET 委托 就 是 指向 应 用 程 
序 中 其 他 方法 的 一 个 对 象 。 使 用 这 个 类 型 ,可 以 构建 允许 多 个 对 象 进行 双向 会 话 的 系统 。 在 分 析 了 .NET 
委托 的 使 用 后 , 将 介绍 C# 的 event 关键 字 , 使 用 这 个 关键 字 可 以 简化 原始 委托 编程 的 操作 。 随 后 研究 
C# Lambda 操作 符 =>， 并 探讨 了 委托 、 匿 名 方法 和 Lambda 表达 式 之 间 的 联系 。 

第 11 章 : 高 级 C# 语 言 特性 

这 一 章 介 绍 了 许多 高 级 的 .NET 编程 技术 , 这 些 技术 能 够 让 你 对 C# 编 程 语言 有 更 深 的 理解 。 例如， 
你 将 学 到 如 何 重 载 操作 符 、 创 建 自 定义 类 型 转换 例 程 ( 包括 隐 式 的 和 显 式 的 )、 构 建 类 型 索引 器 并 与 
之 交互 ， 使 用 扩展 方法 、 匿 名 类 型 、 分 部 方法 以 及 使 用 不 安全 的 代码 上 下 文 来 操作 C# 指 针 。 
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第 12 章 : LINQ to Object 

这 一 章 开始 研究 LINQ ( 语言 集成 查询 )， 它 可 以 用 来 构建 强 类 型 的 查询 表达 式 ， 并 且 可 以 把 它 应 
用 到 很 多 LINQ 目标 来 操作 最 广义 的 数据 。 我 们 还 会 学 习 把 LINQ 表达 式 应 用 到 数据 容器 (例如 ， 数 
组 、 集 合 和 自 定义 类 型 ) 的 LINQ to Object。 这 对 于 本 书 其 余部 分 所 涉及 的 其 他 LINQ API 同样 适用 ( 如 
LINQ to XML、 LINQ to DataSet、PLINQ 和 LINQ to Entity )。 

第 13 章 : 对 象 的 生命 周期 

这 一 章 分 析 了 CLR 如 何 使 用 .NET 垃圾 收集 器 来 管理 内 存 。 你 将 会 了 解 应 用 程序 根 、 对 象 产 生 和 
System.GC 类 型 的 作用 。 理解 了 这 些 之 后 , 接 下 来 学 习 可 处 置 的 对 象 (通过 IDisposable 接口 ) 和 终结 
过 程 (通过 System.0bject.Finalize() 方 法 )。 这 一 章 还 将 研究 Lazy<T> 类 ， 它 用 来 定义 一 个 直到 调用 
者 发 出 请 求 时 才 会 分 配 的 数据 。 你 将 看 到 ， 当 你 的 程序 不 希望 托管 堆 散 乱 不 堪 时 ， 这 个 特性 将 有 助 于 
确保 堆 的 整洁 。 


第 五 部 分 : 用 .NET 程 序 集 编程 


这 一 部 分 深入 分 析 了 .NET 程序 集 格 式 的 细节 。 你 不 仅 会 学 到 如 何 部 署 和 配置 NET 代码 库 ， 而 且 
会 理解 .NET 二进制 映像 的 内 部 结构 。 这 部 分 也 阐述 了 .NET 特性 的 作用 和 运行 时 解析 类 型 信息 的 作用 ， 
还 介绍 了 动态 语言 运行 时 ( DLR, Dynamic Language Runtime ) 和 C# dynamic 关键 字 的 作用 。 后 面 的 章 
节 分 析 了 一 些 程序 集 相 关 的 高 级 主题 ( 如 应 用 程序 域 、CIL 语法 和 在 内 存 中 构建 程序 集 )。 

第 14 章 : .NET 程序 集 入 门 

从 一 个 比较 高 的 层次 来 看 ， 程 序 集 ( assembly ) 是 用 于 描述 托管 的 *.dll 或 *.exe 二 进 制 文件 的 一 
个 术语 ， 但 是 其 真正 内 涵 实 际 上 远 远 不 仅 于 此 。 通 过 这 一 章 ， 你 将 学 到 单 文件 程序 集 和 多 文件 程序 
集 的 区 别 ， 以 及 如 何 构建 和 部 署 每 一 个 实体 ; 你 还 会 学 到 如 何 利用 基于 XML 的 *.config 文 件 和 发 布 
策略 程序 集 来 配置 私有 的 和 共享 的 程序 集 。 通 过 这 些 内 容 ， 你 将 看 到 GAC ( 全 局 程序 集 缓存 ) 的 内 
部 结构 。 

第 15 章 : 类 型 反射 、 晚 期 绑 定 和 基于 特性 的 编程 

这 一 章 通 过 System.Reflection 命名 空间 ,分 析 了 运行 时 类 型 发 现 的 过 程 ， 来 继续 探讨 .NET 程序 
集 。 使 用 这 些 类 型 ， 你 能 够 创建 一 个 可 以 实时 读 取 程 序 集 元 数据 的 应 用 程序 。 该 章 还 将 介绍 如 何在 运 
行 时 使 用 晚期 绑 定 来 动态 加 载 和 创建 类 型 。 最 后 的 主题 是 NET 特性 (包括 标准 的 和 自 定义 的 ) 的 作 
用 。 为 了 说 明 每 个 主题 的 用 法 ， 该 章 最 后 将 构造 一 个 可 扩展 的 Windows Forms 应 用 程序 。 

第 16 章 : 动态 类 型 和 动态 语言 运行 时 

.NET 4.0 引 入 了 一 个 新 的 .NET 运行 时 环境 ， 叫 做 动态 语言 运行 时 。 使 用 DLR 和 C# 2010 dynamic 
关键 字 ， 可 以 定义 直到 运行 时 才 真正 处 理 的 数据 。 这 些 特性 可 以 显著 地 简化 一 些 极其 复杂 的 .NET 编 
程 任务 。 在 这 一 章 中 , 你 将 学 习 一 些 动态 数据 的 实际 用 法 , 包括 如 何 用 简单 的 方式 使 用 .NET 反射 API， 
以 及 如 何 用 最 小 的 代价 与 遗留 的 COM 库 通 信 。 

第 17 章 : 进程 、 应 用 程序 域 和 对 象 上 下 文 

既然 你 已 经 对 程序 集 有 了 一 定 的 了 解 ， 这 一 章 将 深入 探讨 加 载 的 .NET 执行 单元 的 组 成 。 这 一 章 
的 目标 是 阐明 进程 、 应 用 程序 域 和 上 下 文 边界 的 关系 。 该 章 所 叙述 的 内 容 为 第 19 章 做 了 很 好 的 铺垫 ， 
那 一 章 讨 论 的 是 多 线程 应 用 程序 的 构造 。 


第 18 章 : CIL 和 动态 程序 集 的 作用 

这 一 章 有 两 个 目的 。 在 前 半 部 分 (大致) 中 ,将 会 比 之 前 章节 更 具体 地 介绍 CIL 的 语法 和 语义 ， 
余下 的 部 分 主要 讲述 System.Reflection.Emit 命名 空间 的 作用 。 使 用 这 些 类 型 ,可 以 构建 一 个 能 在 运 
行 时 在 内 存 中 产生 .NET 程序 集 的 软件 。 正 式 地 说 ， 一 个 能 在 内 存 中 定义 并 执行 的 程序 集 称 为 动态 程 
序 集 。 


第 六 部 分 : .NET 基 础 类 库 


到 本 书 的 这 一 部 分 ， 你 应 该 已 经 很 好 地 掌握 了 C# 语 言 以 及 .NET 程序 集 格式 的 细节 。 这 一 部 分 将 
通过 探索 基础 类 库 中 的 一 些 常 用 服务 程序 来 讲授 一 些 新 的 知识 , 包括 多 线程 应 用 程序 的 创建 、 文 件 的 
输入 /输出 和 利用 ADO.NET 的 数据 库 访 问 ， 通 过 WCF 构造 分 布 式 应 用 程序 以 及 构建 使 用 了 WF API 
和 LINQto XML API 的 支持 工作 流 的 应 用 程序 。 

第 19 章 : 多 线程 、 并 行 和 异步 编程 

这 一 章 介 绍 了 如 何 构建 多 线程 应 用 程序 ， 演 示 了 大 量 用 于 编写 线程 安全 代码 的 技术 。 首 先 复习 
了 .NET 委托 类 型 ， 解 释 了 委托 对 于 异步 方法 调用 的 内 在 支持 。 接 下 来 ， 研 究 了 System.Threading 命 
名 空间 中 的 类 型 。 最 后 ， 介 绍 了 TPL ( Task Parallel Library， 任 务 并 行 库 )。 使 用 TPL，.NET 开发 者 
可 以 用 一 种 极其 简单 的 方式 ,将 应 用 程序 的 工作 分 配给 所 有 可 用 的 CPU。 与 此 同时 ,你 还 将 学 习 PLINQ 
的 作用 ， 它 提供 了 一 种 在 多 个 机 器 内 核 中 执行 LINQ 查询 的 方法 。 本 章 结 尾 处 总 结 了 .NET 4.5 引入 的 
几 个 新 的 C# 关 键 字 ， 它 们 能 够 将 异步 方法 调用 直接 集成 到 语言 中 。 

第 20 章 : 文件 输入 输出 和 对 象 序列 化 

System.I0 命名 空间 允许 与 机 器 的 文件 和 目录 结构 交互 。 通 过 这 一 章 的 学 习 ， 你 将 学 会 如 何以 编 
程 方式 创建 ( 和 删除 ) 一 个 目录 系统 ， 以 及 如 何 将 数据 从 不 同 的 (例如 ,基于 文件 的 、 基 于 字符 串 的 、 
基于 内 存 的 等 ) 数据 流 中 移 进 移出 。 本 章 的 后 半 部 分 探讨 了 .NET 平 台 的 对 象 序列 化 服务 。 简 单 地 说 ， 
序列 化 〈serialization ) 就 是 将 一 个 对 象 ( 或 一 组 相关 对 象 ) 的 状态 持久 化 为 流 ， 以 便 今后 使 用 。 反 序 
列 化 (Deserialization ) 是 一 个 从 流 中 取出 对 象 并 放 入 供应 用 程序 使 用 的 内 存 中 的 过 程 。 只 要 理解 了 基 
本 原理 ， 你 就 会 学 到 如 何 通过 ISerializable 接口 和 一 组 .NET 特性 来 定制 序列 化 过 程 。 

第 21 章 : ADO.NET 之 一 : 连接 层 

本 书 中 有 3 章 介绍 数据 库 相 关 操 作 ， 这 是 第 一 章 ， 介 绍 .NET 平 台 ADO.NET 的 数据 库 访问 API。 
具体 而 言 ， 涉 及 .NET 数据 提供 程序 的 作用 以 及 如 何 使 用 由 连接 对 象 、 命 令 对 象 、 事 务 对 象 以 及 数据 
读 取 器 对 象 构 成 的 ADO.NET 连接 层 与 关系 数据 库 进 行 通信 。 该 章 引导 你 创建 一 个 在 本 书 剩余 部 分 会 
用 到 的 自 定 义 数据 库 和 自 定义 数据 访问 类 库 ( AutoLotDAL.dll )。 

第 22 章 : ADO.NET 之 二 : 断 开 连接 层 

这 一 章 将 通过 研究 ADO.NET 的 断 开 连 接 层 继 续 探 讨 数据 库 操作 。 在 这 里 ， 我 们 会 学 习 Dataset 
类 型 、 数 据 适 配器 对 象 以 及 各 种 可 以 大 幅 简化 创建 数据 驱动 应 用 程序 的 Visual Studio 工具 。 此 后 ,我 
们 会 学 习 如 何 把 DataTable 对 象 绑 定 到 用 户 界面 元 素 以 及 如 何 使 用 LINQto DataSet 将 LINQ 查 询 应 用 于 
内 存 对 象 DataSet。 

第 23 章 : ADO.NET 之 三 : Entity Framework 

这 一 章 研究 了 ADO.NET 的 最 后 一 部 分 内 容 





Entity Framework ( EF ) 的 作用 。 实 质 上 ，EF 是 
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一 种 用 直接 映射 到 业务 模型 上 的 强 类 型 类 编写 数据 访问 代码 的 方式 。 在 这 里 ， 你 将 了 解 EF 对 象 服务 
的 作用 、 实 体 客户 端 和 对 象 上 下 文 , 以 及 *.edmx 文件 的 构成 。 同 时 , 还 将 学 习 如 何 使 用 LINQ to Entity 
与 关系 型 数据 库 交 互 。 你 还 将 构建 最 终 版 本 的 自 定义 数据 访问 库 ( AutoLotDAL.dll )， 本 书 其 他 章节 中 
将 会 使 用 这 个 库 。 

第 24 章 : LINQ to XML 简介 

第 14 章 介绍 核心 的 LINQ 编程 模型 ,特别 是 LINQ to Object。 在 这 里 ,我 们 会 通过 研究 如 何 把 LINQ 
查询 应 用 到 XML 文档 来 深入 理解 LINQ。 我 们 首先 学 习 在 使 用 System.XML.dll 程序 集 的 类 型 进行 .NET 
XML 操作 时 所 暴露 出 的 一 些 “ 缺 点 "， 然 后 探索 如 何 使 用 LINQ 编程 模型 (LINQ to XML ) 在 内 存 中 
创建 XML 文档 、 将 文档 持久 化 到 硬盘 驱动 以 及 对 其 内 容 进行 导航 。 

第 25 章 : WCF 

到 现在 为 止 ， 所 有 的 示例 程序 都 是 在 一 台 计 算 机 上 执行 的 。 在 这 一 章 中 ， 我们 将 学 习 WCF API 以 
便 无 须 考虑 底层 管道 ， 以 系统 的 方式 构建 分 布 式 应 用 程序 。 该 章 会 介绍 WCF 服 务 、 服 务 器 端 以 及 客户 
端的 构建 。 我 们 还 会 看 到 ，WCF 服 务 非常 灵活 ， 在 客户 端 和 服务 器 端 中 都 可 以 使 用 基于 XML 的 配置 
文件 以 声明 方式 指定 地 址 、 绑 定 和 契约 。 

第 26 章 : Windows Workflow Foundation 简介 

本 章 你 首先 会 学 习 启 用 工作 流 的 应 用 程序 的 作用 ， 随 后 了 解 使 用 .NET 4.0 WF API 对 业务 流程 进 
行 建 模 的 不 同方 式 ， 接 下 来 学 习 WF 活动 库 的 范围 ， 以 及 如 何 构建 自 定义 活动 。 在 这 个 活动 中 ,将 使 
用 本 书 前 面 所 创建 的 自 定 义 数据 库 访 问 库 。 


第 七 部 分 : WPF 


.NET 3.0 向 程序 员 介绍 了 一 个 绝妙 的 API 一 一 WPF ( Windows Presentation Foundation )， 该 API 
很 快 就 成 为 Windows Forms 桌面 编程 模型 的 继承 者 。 实质 上 , WPF 所 构建 的 桌面 应 用 程序 可 以 包含 向 
量 图 形 、 交 互 式 动画 ， 以 及 使 用 声明 式 标 记 语 法 XAML 所 进行 的 数据 绑 定 操作 。 

此 外 ，WPF 控件 架构 提供 了 一 种 非常 简单 的 方式 ， 仅 仅 使 用 一 些 格式 良好 的 XAML， 就 可 以 彻 
底 改 变 常 用 控件 的 外 观 。 

第 27 章 : WPF 和 XAML 

本 质 上 ，WPF 可 以 为 桌面 应 用 程序 ( 以 及 非 直接 的 Web 应 用 程序 ) 构建 交互 性 极 好 的 富 媒体 前 
端 。 和 Windows Forms 不 同 ， 这 个 超 强 的 UI 框架 把 很 多 关键 服务 ( 例如 2D 和 3D 图形、 动画 、 富 文 
档 等 ) 整合 到 了 一 个 统一 的 对 象 模型 中 。 在 这 一 章 中 ,我 们 会 从 WPF 以 及 XAML ( 可 扩展 应 用 程序 
标记 语言 ) 开始 研究 ， 还 会 学 习 如 何 创建 不 使 用 XAML、 只 使 用 XAML 以 及 两 者 结合 的 WPF 程序 。 
最 后 ， 我 们 创建 了 在 其 余 WPF 相关 章节 中 都 会 用 到 的 自 定义 XAML 编辑 器 。 

第 28 章 : 使 用 WPF 控件 编程 

这 一 章 将 介绍 使 用 内 置 的 WPF 控件 和 布局 管理 器 的 过 程 ， 例 如 ， 构 建 菜单 系统 、 拆 分 窗口 、 工 
有 具 条 和 状态 栏 ， 还 将 介绍 大 量 WPF API (及 其 相关 控件 )， 包 括 WPF Documents API、WPF Ink API 
和 数据 绑 定 模型 。 同 样 重要 的 是 ， 这 一 章 将 开始 研究 Expression Blend IDE， 它 将 简化 为 WPF 应 用 程 
序 创建 富 UI 的 任务 。 


第 29 章 : WPF 图 形 呈 现 服务 

WPF 是 一 个 图 形 密集 型 API， 它 提供 了 3 种 呈现 图 形 的 方式 : 形状 、 绘 图 和 几何 图 形 、 可 视 化 。 
在 这 一 章 中 ， 我 们 将 介绍 这 几 种 方法 ， 并 讨论 大 量 重要 的 图 形 基 元 ( 如 画 刷 、 画 笔 和 图 形变 换 )， 还 
将 学 习 Expression Blend 用 于 简化 创建 WPF 图 形 过 程 的 多 种 方式 ， 以 及 如 何 对 图 形 数据 执行 命中 测试 

第 30 章 : WPF 资源 、 动 画 和 样式 

这 一 章 介 绍 了 3 个 重要 的 (也 是 相互 关联 的 ) 主题 , 它们 将 加 深 你 对 WPF API 的 理解 。 第 一 个 主 
题 是 逻辑 资源 的 作用 。 你 将 看 到 逻辑 资源 (也 叫 对 象 资 源 ) 系统 提供 了 一 种 方式 ， 可 以 在 WPF 应 用 
程序 中 命名 和 引用 常用 的 对 象 。 接 下 来 ， 你 将 学 习 如 何 定义 、 执 行 和 控制 动画 序列 。 你 可 能 会 认为 
WPF 动画 仅 局 限于 视频 游戏 和 多 媒体 应 用 ， 但 实际 上 绝 不 是 这 样 。 最 后 你 将 学 习 WPF 样式 的 作用 。 
与 使 用 CSS 或 ASPNET 主题 引擎 的 Web 页 面 类 似 ，WPF 应 用 程序 也 可 以 定义 常用 控件 的 外 观 。 

第 31 章 : 依赖 属性 、 路 由 事件 和 模板 

本 章 先 介 绍 了 创建 自 定义 控件 时 涉及 的 两 个 重要 话题 : 依赖 属性 和 路 由 事件 。 理 解 了 这 些 内 容 之 
后 ， 我 们 将 学 习 默 认 模 板 的 作用 ， 以 及 如 何在 运行 时 以 编程 的 方式 查看 它们 。 打 好 这 些 基 础 之 后 ， 最 
后 将 学 习 如 何 创建 自 定义 模板 。 


第 八 部 分 : ASP.NET Web Form 


这 一 部 分 主要 研究 使 用 ASP.NET 编程 API 来 构建 Web 应 用 程序 。 我 们 会 看 到 ，ASPNET 基于 标 
准 的 HTTP 请 求 /响应 对 事件 驱动 的 面向 对 象 框架 分 层 ， 以 此 来 对 桌面 用 户 界面 的 创建 进行 建 模 。 

第 32 章 : ASP.NET Web Form 

本 章 开始 介绍 使 用 ASPNET 进行 Web 应 用 开发 。 如 你 所 见 ， 服 务 器 端的 脚本 代码 现在 由 “真正 
的 ”面向 对 象 的 语言 (如 C# 和 VB .NET 等 ) 所 替代 。 这 一 章 将 介绍 ASPNET 网 页 的 构造 、 基 础 的 编 
程 模型 以 及 ASPNET 的 其 他 关键 主题 ， 如 Web 服务 器 的 选择 和 web.config 文件 的 使 用 。 

第 33 章 : ASP.NET Web 控件 、 母 版 页 和 主题 

由 于 前 几 章 介绍 了 ASPNET 页 面 对 象 的 构建 ， 这 一 章 将 会 关注 组 成 内 部 控件 树 的 控件 。 在 这 里 ， 
我 们 会 研究 包括 验证 控件 、 内 置 站 点 导航 控件 以 及 各 种 数据 绑 定 操作 在 内 的 核心 ASPNET Web 控件 。 
同样 ， 还 会 演示 母 版 页 的 作用 以 及 与 传统 样式 表 对 应 的 服务 器 端 ASPNET 主题 引擎 。 

第 34 章 : ASP.NET 状态 管理 技术 

这 一 章 将 通过 研究 .NET 下 处 理 状态 管理 的 多 种 方式 来 扩展 你 对 ASPNET 的 理解 。 和 传统 的 ASP 
一 样 ， 使 用 ASPNET 可 以 轻松 创建 cookie 以 及 应 用 程序 级 变量 和 会 话 级 变量 。 然 而 ，ASPNET 还 引 
入 了 一 项 新 的 状态 管理 技术 : 应 用 程序 高 速 缓存 。 只 要 知道 了 使 用 ASPNET 处 理 状态 的 多 种 方式 ， 
你 就 会 明白 HttpApplication 基 类 的 作用 ， 以 及 如 何 用 web.config 文件 动态 改变 Web 应 用 程序 的 运行 
时 行为 。 


附录 


除了 34 章 正文 ， 本 书 英 文 版 还 包括 附录 A 和 附录 B， 其 内 容 需要 从 Apress 网 站 ( www.apress.com ) 
的 本 书 主页 下 载 。 附 录 A 涵盖 基本 Windows Forms API， 正 文中 有 几 个 UI 示 例 用 到 了 。 附 录 B 通过 
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Mono 平台 研究 了 .NET 不 依赖 于 平台 的 特性 。 

附录 A: Windows Forms 编程 

NET 平台 最 初 发 布 的 桌面 GUI 工具 包 是 Windows Forms。 该 附录 将 介绍 这 个 UI 框 架 的 作用 ， 并 
演示 如 何 构建 主 窗口 、 对 话 框 和 菜单 系统 ， 还 将 说 明 窗 体 继承 的 作用 ， 以 及 如 何 使 用 System.Drawing 
命名 空间 呈现 二 维 图 形 数据 。 最 后 ， 该 附录 将 构建 一 个 绘图 程序 (半成品 )， 演 示 附 录 中 讨论 的 各 
个 主题 。 

附录 B: 使 用 Mono 进行 平台 无 关 的 .NET 开发 

最 后 ,附录 B 介绍 了 一 个 叫做 Mono 的 .NET 平 台 的 开源 实现 。 使 用 Mono 可 以 在 Mac OS X、Solaris 
以 及 各 种 Linux 版 本 的 操作 系统 中 创建 .部 署 和 执行 富 特性 的 .NET 应 用 程序 .由 于 Mono 和 微软 的 .NET 
平台 非常 相似 ， 因 此 你 应 该 知道 Mono 提供 的 大 部 分 内 容 。 因 此 ， 附 录 B 会 重点 介绍 Mono 的 安装 过 
程 、Mono 的 开发 工具 以 及 Mono 运行 时 引擎。 


本 书 源 代码 


本 书 所 包含 的 所 有 代码 示例 都 可 以 从 Apress 网 站 上 的 Source Code/Download 中 免费 下 载 (也 可 以 
从 图 灵 社 区 本 书 主页 http://www.ituring.com.cn/book/1046 免费 下 载 )。 访 问 网 址 http://www.apress.com， 
选择 Source Code/Download 链接 ， 然 后 按 书 名 查找 。 找 到 本 书 的 主页 后 ， 就 可 以 下 载 一 个 压缩 的 *.zip 
文件 。 解 开 压缩 文件 就 会 看 到 ， 所 有 代码 都 是 按 章 编排 的 。 

需要 提醒 你 注意 的 是 , 本 书 的 很 多 章节 都 包含 有 如 下 所 示 的 源 代码 说 明 , 书 中 讨论 的 例子 都 可 以 
依 此 线索 下 载 ， 并 加 载 到 Visual Studio 中 ， 以 便 进一步 讨论 和 修改 。 


源 代码 ”这 里 给 出 了 源 代码 在 压缩 文件 中 的 具体 目录 。 


要 打开 一 个 Visual Studio 解决 方案 ， 可 以 使 用 File-*Open 一 Project/Solution 菜单 选项 ， 然 后 导航 
到 解压 缩 文 档 所 在 的 子 目录 ， 找 到 正确 的 *.sln 文件 。 


勘误 信息 


阅读 本 书 过 程 ， 你 或 许 偶 尔 会 发 现 一 些 语法 错误 或 代码 错误 (很 显然 我 不 希望 看 到 这 些 )。 如 果 
真 发 现 了 ， 我 在 此 道 歉 。 作 为 一 个 凡人 ， 尽 管 我 已 经 很 尽力 了 ,但 是 一 两 个 小 错误 总 是 难免 的 。 你 可 
以 从 Apress 的 网 页 上 获得 勘误 表 ( 还 是 在 这 本 书 的 “主页 ”上 )。 如 果 你 发 现 错误 的 话 ， 请 在 那里 找 
到 我 的 联系 方式 ， 与 我 联系 。 


联系 作者 


如 果 你 有 任何 关于 本 书 源 代码 的 问题 , 或 者 需要 进一步 阐明 这 里 所 举 的 例子 ， 亦 或 者 只 是 想 简单 
地 向 我 传达 你 关于 .NET 平 台 的 想法 , 请 通过 以 下 电子 邮件 地 址 与 我 联系 : atroelsen@intertech.com ( 为 
了 确保 你 的 邮件 不 会 被 我 的 信箱 划 为 垃圾 邮件 ， 请 在 主题 栏 中 包含 “C# SixthEd”)。 
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请 你 们 相信 ， 我 会 尽 我 所 能 在 较 短 的 时 间 里 回复 你 们 。 但 是 ， 就 如 同 各 位 一 样 ， 我 有 时 也 会 比较 
忙 。 如果 我 没 能 在 一 周 或 两 周 的 时 间 里 回复 你 们 , 请 不 要 认为 我 是 一 个 怪异 的 人 或 者 不 悄 与 你 们 交流 ， 
我 可 能 只 是 比较 忙 而 已 (或者, 如果 足够 幸运 的 话 , 在 某 处 度假 也 不 一 定 ),。 最 后 ， 感 谢 购买 本 书 (或 
者 至 少 在 你 决定 是 否 购买 的 时 候 ， 曾 经 在 书店 里 翻 看 过 )。 我 希望 你 喜欢 阅读 本 书 ， 并 且 可 以 灵活 运 
用 书 中 所 学 的 知识 。 


Andrew Troelsen 
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ee 
岂 以 台 。 本 书 的 前 言 部 分 已 经 说 过 ， 本 书 的 目的 主要 有 两 个 : 一 是 详细 深入 地 讲解 C# 的 语法 和 
语义 ,二 是 阐述 各 种 .NET API 的 用 法 , 包括 利用 ADO.NET 访 问 数 据 库 、Entity Framework 、LINQ 技 术 、 
WPF、WCFE、WF， 以 及 运用 ASPNET 进 行 Web 站 点 开发 。 常 言 道 :“ 千 里 之 行 ， 始 于 足下 。” 欢迎 从 
本 章 开 始 你 的 “千里 之 行 ”。 

本 章 将 对 本 书 其 余部 分 所 涉及 的 各 个 方面 做 概念 性 的 描述 。 最 开始 将 从 宏观 上 讨论 一 些 .NET 相 关 
主题 ， 如 程序 集 、CIL ( Common Intermediate Language， 公 共 中 间 语 言 ) 和 JIT (just-in-time， 即 时 ) 
编译 。 接 下 来 ， 除 了 预览 C## 咎 言 的 一 些 主要 功能 之 外 ， 还 将 讲述 .NET Framework 不 同方 面 ， 例 如 CLR 
( 公共 语言 运行 库 )、CTS (公共 类 型 系统 ) 和 CLS ( 公共 语言 规范 ) 之 间 的 关系 。 

本 章 还 会 探讨 NET 4.5 基 础 类 库 提供 的 功能 ， 基 础 类 库 的 英文 Base Class Library 缩 写 为 BCL。 本 章 
最 后 概述 .NET 平 台 的 语言 无 关 性 和 平台 无 关 性 ( 别 惊讶 ，.NET 并 不 局 限于 Windows 操 作 系统 )， 还 会 大 
体 讲 一 下 在 Windows 8 操作 系统 下 构建 应 用 程序 时 .NET 的 角色 。 当 然 , 所 有 这 些 主题 都 将 在 本 书 其 余部 
分 详细 探讨 。 | 


1.1 初 识 .NET 平台 


在 微软 发 布 C#i 滞 言 和 .NET 平 台 之 前 ， 为 Windows 操 作 系 统 家 族 创 建 应 用 程序 的 开发 者 常常 使 用 
COM 编 程 模型 。COM ( Component Object Model， 组 件 对 象 模型 ) 允许 个 人 构建 可 由 不 同 编程 语言 共享 
的 代码 库 。 例 如 ，Visual Basic 开 发 者 可 以 使 用 C++ 程序 员 构 建 的 COM 库 。COM 的 语言 无 关 特 点 自然 十 分 
有 用 , 但 它 复杂 的 基础 结构 、 脆 弱 的 部 署 模 型 常常 带 来 很 多 麻烦 ， 并且 只 能 部 署 在 Windwos 操 作 系统 上 。 

尽管 COM 有 很 多 复杂 性 和 局 限 性 ， 但 不 计 其 数 的 应 用 程序 还 是 成 功 地 构建 于 这 个 基础 结构 之 上 。 
然而 在 今天 ， 大 多 数 为 Windows 操 作 系 统 家 族 创 建 的 应 用 程序 都 不 是 用 COM 模 型 构建 的 。 桌 面 应 用 、 
网 站 、 操 作 系 统 服务 、 数 据 访问 或 业务 逻辑 复 用 库 都 是 使 用 NET 平台 创建 的 。 


.NET 平 台 的 主要 优点 


前 面 提 到 过 ，C# 和 .NET 平 台 是 2002 年 正式 发 布 的 ， 当 时 主要 为 了 提供 一 种 比 COM 更 强大 、 更 灵 
活 、 更 简洁 的 编程 模型 。 从 本 书后 面 的 内 容 你 会 看 到 ，.NET Framework 用 于 在 Windows 系 列 操作 系统 
和 其 他 如 Mac OS X 或 Unix/Linux 等 非 微 软 的 操作 系统 中 创建 系统 。 为 了 打 好 基础 ， 我 们 先 来 快速 浏览 
一 下 .NET Framework 的 一 些 核 心 功能 。 
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口 对 已 有 代码 具有 完全 的 互 操作 性 : 这 ( 当然 ) 是 一 件 很 好 的 事情 。 已 有 的 COM 二 进 制 组 件 可 
以 和 更 新 的 .NET 二 进 制 组 件 共 存 , 反之 亦 然 。 在 .NET 4.0 及 后 续 版 本 , 使 用 dynamic 关 键 字 ( 详 
见 第 16 章 ) 可 以 进一步 简化 这 种 互 操 作 性 。 

口 支持 多 种 编程 语言 : 使 用 多 种 编程 语言 ( C#、Visual Basic 、F# 等 ) 创建 .NET 应 用 。 

口 所 有 支持 .NET 的 语言 共享 的 公共 运行 时 引擎: 这 个 引擎 的 一 个 特点 是 具有 一 组 明确 定义 的 类 
型 ， 而 每 一 种 支持 .NET 的 语言 都 能 “明白 ”这 些 类 型 。 

口 语言 集成 : .NET 支 持 跨 语言 的 继承 、 异 常 处 理 和 代码 调试 。 比 方 说 ，C# 中 定义 的 基 类 可 以 在 
Visual Basic 进 行 扩 展 。 

口 全 面 的 基础 类 库 : 这 个 库 除 隐藏 了 原始 API 调 用 的 复杂 性 外 , 还 提供 了 被 所 有 支持 .NET 的 语言 
所 使 用 的 一 致 的 对 象 模型 。 

口 简化 的 部 署 模型 : 与 COM 不 同 , .NET 库 不 需要 将 二 进 制 单元 注册 到 系统 注册 表 了 。 另外 , .NET 
允许 同一 个 *.dll 的 不 同 版 本 存在 于 同一 台 机 右上 。 

这 些 核心 功能 以 及 更 多 内 容 会 在 后 面 的 章节 详细 介绍 。 


1.2” .NET 平台 构造 块 (CLR、CTS 和 CLS) 简介 


了 解 了 NET 的 优点 之 后 ， 让 我 们 来 预览 一 下 使 NET 成 为 现实 的 3 个 关键 ( 而且 相 互 关 联 的 ) 实体 : 
CLR、CTS 和 CLS。 从 程序 员 的 角度 看 ，.NET 可 以 理解 为 一 个 运行 库 环 境 和 一 个 全 面 的 基础 类 库 。 运 行 
库 层 的 正式 名 称 是 CLR ( Common Language Runtime， 公 共 语 言 运行 库 )。 其 主要 作用 是 为 我 们 定位 、 加 
载 和 管理 .NET 类 型 ,同时 也 负责 一 些 低层 细节 的 工作 , 如 内 存 管理 、 应 用 托管 、 处 理 线程 、 安 全 检查 等 。 

.NET 平 台 的 另 一 个 构造 块 是 CTS ( Common Type System， 公 共 类 型 系统 )。CTS 规 范 完整 描述 了 
运行 库 所 支持 的 所 有 可 能 的 数据 类 型 和 编程 结构 , 指定 了 这 些 实体 间 如 何 交 互 , 也 规定 了 它们 在 .NET 
元 数据 格式 中 的 表示 ( 本 章 后 面 将 会 给 出 更 多 关于 元 数据 的 信息 ， 第 15 章 将 详细 介绍 这 方面 的 内 容 )。 

要 注意 的 是 ， 一 种 特定 的 支持 .NET 的 语言 可 能 不 支持 CTS 所 定义 的 所 有 特性 。CLS ( Common 
Language Specification， 公 共 语 言 规范 ) 是 一 个 相关 的 规范 ， 定 义 了 一 个 让 所 有 .NET 语 言 都 支持 的 公 
共 类 型 和 编程 结构 的 子 集 。 这 样 ， 如 果 构 造 的 .NET 类 型 仅 公开 与 CLS 兼 容 的 特性 ,那么 可 以 肯定 其 他 
所 有 支持 .NET 的 语言 都 能 使 用 它们 。 反 之 ， 如 果 使 用 了 与 CLS 不 兼容 的 数据 类 型 或 编程 结构 ， 就 不 能 
保证 所 有 的 .NET 语 言 能 和 你 的 .NET 代 码 库 交互 。 庆 幸 的 是 ， 如 你 在 本 章 后 面 所 看 到 的 那样 ， 让 C# 编 
译 器 遵从 CLS 来 验证 代码 是 十 分 简单 的 。 


1.2.1 基础 类 库 的 作用 


除了 CLR 和 CTS/CLS 规 范 之 外 ，.NET 平 台 提 供 了 一 个 适用 于 全 部 .NET 程 序 语 言 的 基础 类 库 
( BCL )。 这 个 基础 类 库 不 仅 封 装 了 各 种 基本 类 型 ， 如 线程 、 文 件 输入 /输出 (IO )、 图 形 绘制 以 及 与 各 
种 外 部 硬件 设备 的 交互 ， 还 支持 在 实际 应 用 中 用 到 的 一 些 服务 。 

例如 ， 基 础 类 库 定 义 了 一 些 可 创建 任意 类 型 软件 应 用 程序 的 类 型 ， 例 如 ， 使 用 ASPNET 创 建 Web 
站 点 ， 使 用 WCF 创 建 网 络 服务 ， 使 用 WPF 创 建 桌 面 GUI 应 用 程序 ， 等 等 。 基 础 类 库 还 定义 了 另外 一 些 
类 型 ， 可 以 与 特定 计算 机 上 的 XML 文档 、 本 地 目录 和 文件 系统 互动 ， 通 过 ADO.NET 与 关系 数据 库 交 
流 ， 等 等 。 如 图 1-1 所 示 ， 可 以 从 宏观 上 看 到 CLR、CTS、CLS 和 基础 类 库 之 间 的 关系 。 
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图 1-1 CLR、CTS、CLS 和 基础 类 库 之 间 的 关系 


1.2.2 ”C# 的 优点 


C# 的 核心 语法 和 Java 语 法 很 相似 。 然 而 ， 并 不 能 说 C# 抄 袭 了 Java。 本 质 上 ，C# 和 Java 都 属于 C 语 
言 系列 (包括 C、Objective C、C++ 等 )， 它 们 有 类 似 的 语法 。 
实际 上 ，C# 的 许多 语法 结构 与 VB 和 C++ 的 很 多 方面 都 有 渊源 。 例 如 ， 与 VB 类 似 ，C# 支 持 类 型 属 
性 ( property ) ”( 与 传统 的 获取 方法 和 设置 方法 相反 ) 和 可 选 参数 。 与 C++ 类 似 ，C# 人 允许 重 载 操作 符 ， 
且 支 持 创 建 结构 、 枚 举 和 回调 函数 ( 使 用 委托 )。 
此 外 , 在 浏览 本 书 时 ,我 们 很 快 就 会 看 到 C# 支 持 各 种 函数 式 语言 ( 如 LISP 或 Haskell ) 中 的 很 多 特 
性 ， 例 如 Lambda 表 达 式 和 匿名 类 型 。 此 外 ， 由 于 LINQ 的 出 现 ，C# 支 持 很 多 编程 结构 ， 在 编程 语言 中 
显得 非常 独特 。 尽 管 如 此 ，C# 的 核心 始终 受到 C 系 列 语言 的 影响 。 
C# 是 多 种 语言 的 混合 体 ， 因 此 它 像 Java 一 样 语法 简洁 ,， 像 VB 一 样 使 用 简单 ， 像 C++ 一 样 功能 强大 
和 灵活 。 以 下 是 C# 核 心 特 征 的 一 部 分 ， 其 中 大 部 分 特点 也 是 其 他 支持 .NET 的 程序 语言 所 共有 的 特征 。 
口 不 需要 指针 ! C# 程 序 通常 不 需要 直接 对 指针 进行 操作 ( 尽管 在 绝对 必要 时 也 能 自由 地 进行 底 
层 操作 ， 详 见 第 11 章 )。 
口 垃圾 收集 器 能 够 自动 管理 内 存 。 因 此 ，C# 不 支持 delete 关 键 字 。 
口 类 、 接 口 、 结 构 、 枚 举 和 委托 都 有 正式 的 语法 结构 。 
口 具有 与 C+ 类 似 的 功能 ， 可 以 简单 地 重 载 操作 符 为 自 定义 类 型 ( 例如， 不 需要 操心 确保 “返回 
*#this 以 能 够 链接 ”)。 
口 支持 基于 特性 的 编程 。 这 种 方式 的 开发 允许 我 们 注释 类 型 及 其 成 员 来 进一步 限定 其 行为 。 例 
如 ， 用 这 个 [0bsolete] 特 性 标记 某 种 方法 后 ， 后 面 再 使 用 这 种 方法 的 时 候 就 会 打印 自 定 义 的 警告 
信息 。 





中 在 C# 中 ,property (属性 ) 是 一 种 特殊 的 字段 ( 内 部 用 get/set 方 法 实现 ， 外 部 调用 则 与 普通 字段 无 异 )， 而 attribute 
(特性 , 也 常 译 为 属性 或 性 质 ) 是 一 种 为 各 种 语言 构造 添加 元 数据 信息 的 方式 , 二 者 与 一 般 场合 下 所 说 的 属性 ( 往 
往 指 普通 类 字段 ) 和 特性 ( 指 一 般 意 义 上 的 功能 ) 都 不 同 ( 本 书 已 尽量 避免 使 用 后 两 种 说 法 )， 请 读者 注意 区 分 。 

一 一 编者 注 
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随 着 .NET2.0 的 发 布 ( 大 约 在 2005 年 ), C# 编 程 语言 被 更 新 以 支持 很 多 花哨 的 东西 , 主要 是 以 下 几 项 。 
口 构建 泛 型 类 型 和 泛 型 成 员 的 能 力 。 使 用 泛 型 ， 我 们 可 以 构建 非常 高 效 的 并 且 类 型 安全 的 代码 ， 
在 和 泛 型 项 交互 的 时 候 可 以 定义 很 多 占 位 符 。 
口 支持 匿名 方法 ， 它 人 允许 我 们 在 任何 需要 委托 类 型 的 地 方 提供 内 联 函 数 。 
口 使 用 partial 关 键 字 跨 多 个 代码 文件 定义 单个 类 型 的 能 力 (或 者 如 果 有 必要 的 话 ， 可 以 作为 内 
存 中 的 表示 )。 
.NET 3.5 (大约 发 布 于 2008 年 ) 为 C# 编 程 语 言 增加 了 更 多 功能 ， 包 括 如 下 特性 。 
口 支持 强 类 型 的 查询 ( 如 LINQ ), 可 用 于 和 各 种 形式 的 数据 进行 交互 。 从 第 12 章 开始 讲解 LINQ。 
口 支持 匿名 类 型 ， 它 允许 我 们 建 模 一 个 类 型 的 形 ( shape ) 而 不 是 其 行为 。 
口 使 用 扩展 方法 扩展 既 有 类 型 ( 没有 子 类 ) 功能 的 能 力 。 
口 包含 了 Lambda 操 作 符 (=> )， 它 可 以 进一步 简化 .NET 委 托 类 型 的 使 用 。 
口 新 的 对 象 初始 化 语法 ， 它 允许 我 们 在 创建 对 象 时 设置 属性 的 值 。 
.NET 4.0 ( 2010 年 发 布 ) 再 次 为 C# 添 加 了 少量 特性 ， 下 面 举 几 个 例子 。 
口 支持 可 选 的 方法 参数 和 命名 的 方法 参数 。 
口 支持 通过 dynamic 关 键 字 在 运行 时 动态 查找 成 员 。 第 18 章 提供 了 一 个 统一 的 方法 用 于 在 运行 时 
调用 成 员 ， 而 不 必 理 会 成 员 的 实现 框架 (COM 、IronRuby 、IronPython 或 通过 .NET 反 射 服务 )。 
口 泛 型 类 型 的 操作 将 更 加 直观 ， 因 为 你 可 以 使 用 协 变 和 逆 变 ， 轻 易 地 在 泛 型 数据 和 普通 的 
System.0bject 集 合 之 间 进 行 相互 映射 。 
最 后 是 随 .NET 4.5 发 布 的 C# 当 前 版 本 。C# 当 前 版 本 提供 了 一 对 关键 字 ( async 和 await ), 极 大 地 简 
化 了 多 线程 和 异步 编程 。 如 果 你 使 用 过 以 前 版 本 的 C#, 一 定 会 记得 通过 副 线程 调用 方法 需要 大 量 的 含 
义 模 糊 的 代码 ， 并 使 用 不 同 的 .NET 命 名 空间 。 而 现在 C# 提 供 了 语言 关键 字 来 为 我 们 处 理 这 种 复杂 性 ， 
异步 调用 方法 的 过 程 几 乎 像 以 同步 方式 调用 方法 一 样 简 单 。 第 19 章 将 详细 介绍 这 些 话 题 。 


1.2.3 托管 代码 与 非 托 管 代 码 

关于 C# 语 言 , 要 理解 的 最 重要 的 一 点 可 能 是 , 它 生成 的 代码 只 能 在 .NET 运 行 库 中 执行 ( 你 不 能 用 
C# 来 构建 本 机 的 COM 服 务 器 或 非 托 管 的 C/C++ API 应 用 程序 )。 正 式 的 说 法 是 ， 这 种 必须 在 .NET 运 行 
库 下 执行 的 代码 称 为 托管 代码 ( managed code )。 这 些 包含 托管 代码 的 二 进 制 单元 称 为 程序 集 ( assembly )， 
稍 后 将 详细 介绍 。 反之 , 不 能 直接 在 .NET 运 行 库 承 载 (host ) 的 代码 称 为 非 托 管 代 码 (unmanaged code )。 


1.3 ”其 他 支持 .NET 的 编程 语言 


应 该 知道 ，C# 并 不 是 构建 .NET 应 用 的 唯一 一 种 语言 。 在 你 安装 Visual Studio 时 , 你 将 得 到 5 种 托管 
语言 : C#、Visual Basic、C++/CLI、JavaScript 和 F#。 


说 明 F# 是 一 门 基于 函数 式 语言 的 .NET 语 言 。 尽 管 F# 可 以 看 成 是 一 门 纯粹 的 函数 式 语言 ， 但 它 同样 
也 支持 OOP 和 .NET 基 础 类 库 。 如 果 你 想 深 入 了 解 这 门 托管 语言 ， 可 以 访问 F# 官 方 网 页 
http://msdn.microsoft.com/fsharp。 
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除了 微软 提供 的 托管 语言 之 外 , 还 有 Smalltalk、Ruby、Python、COBOL 和 Pascal 的 .NET 编 译 器 等 。 
尽管 本 书 以 C# 为 主 ， 但 你 可 能 有 兴趣 关注 下 面 的 网 站 : 

http://www.dotnetlanguages.net 

如 果 单 击 这 个 网 站 主页 顶部 的 Resources 链 接 , 你 会 看 到 大 量 .NET 编 程 语言 的 列表 和 相关 链接 , 你 
可 以 从 这 里 下 载 各 种 编译 器 (如 图 1-2 所 示 )。 


] .NET Languages 


如 dotnetianguages.net DNi Rese 


|.NET LANGUAGES ner 


INVESTII 


| News | FAQ | Resources | Contact | RSS Feed | Recent Comments Feed 


Resources 


9 Followineg is a listing of resources that you may find useful either to own or bookmark 
during your navigation through the .NET language space. if you feel that there's a resource 
that other .NET developers should know about, please contact me, 


.NET Language Sites 


© Az 
© APL 
| © ASP.NET: ASM to 

® AsmL 

e ASp (Gotham) 

® Basic 
© VB .NET (Microsoft) 
© VB .NET {Mono) 

和 BETA 

@ Boo 

® BlueDragon 

oc 
© lcc 





图 1-2 ”DotNetLanguages.net 中 包含 已 知 .NET 编 程 语言 相关 的 资源 ， 类 似 网 站 还 有 很 多 


如 果 你 对 使 用 C# 语 法 构建 NET 程序 感 兴趣 ， 我 还 是 建议 你 访问 这 个 网 站 ， 因 为 你 肯定 会 发 现 许 
多 .NET 语 言 值得 去 研究 ( 如 LISPNET 等 )。 


多 语言 世界 中 的 生活 

当初 步 了 解 .NET 的 语言 无 关 性 后 ， 开 发 者 会 提出 许多 问题 。 其 中 最 普遍 的 问题 可 能 就 是 :“ 如 果 
所 有 的 .NET 语 言 都 会 编译 成 “托管 代码 " ， 为 什么 我 们 还 需要 多 种 编译 器 呢 ? ” 

这 个 问题 有 多 个 答案 。 首 先 ， 程 序 员 在 选择 编程 语言 时 有 各 自 不 同 的 喜好 ( 包括 我 自己 )。 一 些 人 
喜欢 充满 分 号 和 圆 括号 而 关键 字 相 当 少 的 语言 ， 另 一 些 人 喜欢 更 具有 可 读 性 语法 标记 的 语言 (如 VB )， 
还 有 一 些 人 在 开始 转向 .NET 平 台 时 还 希望 可 以 使 用 他 们 已 掌握 的 技能 (通过 COBOL .NET 编 译 器 )。 

现在 , 平 心 而 论 ， 如 果 微 软 推出 一 门派 生 自 BASIC 语 言 系列 的 “官方 ”.NETi 语 言 ， 你 认为 所 有 的 
程序 员 会 喜欢 这 样 的 选择 吗 ? 或者， 如 果 这 个 唯一 的 “官方 ”.NET 语 言 是 基于 Fortran 语 法 的 ， 那么 可 
以 想象 所 有 人 都 会 对 .NET 置 之 不 理 。 因 为 .NET 运 行 库 并 不 在 意 一 段 托管 代码 是 由 哪 种 语言 生成 的 ， 
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所 以 NET 程 序 员 可 以 继续 使 用 他 们 熟悉 的 语法 ， 且 与 组 员 、 部 门 甚至 其 他 公司 共享 编译 的 程序 集 (不 
管 他 们 用 的 是 哪 种 .NET 语 言 )。 
将 各 种 .NET 语 言 集成 为 一 个 统一 软件 方案 的 另 一 个 好 处 ,就 是 能 够 取长补短 。 所 有 的 编程 语言 
有 各 自 的 优点 和 缺点 。 例如， 一 些 编程 语言 对 高 级 的 数学 处 理 有 相当 完美 的 内 在 支持 能 力 。 另 一 些 则 
精 于 支持 财务 计算 、 逻 辑 计 算 和 与 大 型 机 交互 等 。 当 你 学 习 到 某 种 编程 语言 的 优点 并 将 其 融合 到 .NET 
平台 时 ， 大 家 就 都 能 受益 。 
当然 ， 实 际 上 我 们 大 部 分 时 间 还 是 在 用 自己 习惯 的 .NET 语 言 来 编写 程序 。 但 是 ， 一 旦 学 会 了 一 
种 .NET 语言 的 语法 ,就 很 容易 掌握 其 他 的 了 。 这 是 非常 有 益 的 ， 对 软件 技术 顾问 而 言 尤 其 如 此 。 如 果 
你 熟悉 C#， 在 为 只 使 用 Visual Basic 的 客户 做 咨询 时 ， 你 仍然 能 够 使 用 .NET Framework 的 功能 ,并 且 可 
以 毫 不 费力 地 掌握 代码 的 整体 结构 。 够 棒 的 吧 。 
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不 管 选择 了 哪 种 .NET 语 言 编程 ,需要 明白 的 是 , 尽管 .NET 二 进 制 文件 与 非 托 管 Windows 二 进 制 文 
件 (*.dll 或 *.exe ) 具有 相同 的 文件 扩展 名 ， 但 它们 的 内 部 却 是 完全 不 同 的 。 具 体 说 来 ，.NET 二 进 制 
文件 不 包含 特定 于 平台 的 指令 ， 它 包含 的 是 平台 无 关 的 IL ( Intermediate Language， 中 间 语 言 ) 和 类 
型 元 数据 。 图 1-3 清 楚 显示 了 这 个 流程 。 



















Perl .NET 
源 代码 





Perl .NET 编 译 器 


A 






IL 和 元 数据 
(*.dll 或 *.exe) 













COBOL .NET 


> COBOL .NET 编 译 器 
源 代码 ld ee rr sr EEC 


A 


C++/CLI 
源 代码 














图 1-3 所 有 支持 .NET 的 编译 器 都 生成 IL 指 令 和 元 数据 


说 明 ”需要 说 明 的 一 点 是 开 的 缩写 。 在 .NET 的 开发 过 程 中 ,下 的 官方 术语 是 MSIL ( 微软 中 间 语 言 
或 CIL (公共 中 间 语 言 )。 因 此 ， 当 阅读 .NET 资 料 时 ， 你 应 该 明白 工 、MSIL 和 CIL 指 的 是 同一 
个 概念 。 本 书 谈 到 底层 指令 集 时 使 用 缩写 CIL。 


当 使 用 支持 .NET 的 编译 器 生成 *.dl1 或 *.exe 文 件 时 ,二进制 大 对 象 会 被 打包 成 一 个 程序 集 。 本 书 将 
在 第 14 章 详细 介绍 .NET 程 序 集 。 然 而 为 了 方便 讨论 .NET 运 行 库 环 境 ， 你 需要 理解 这 个 新 文件 格式 的 
基本 属性 。 
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前 文 提 到 ， 程 序 集 包 含 CIL 代 码 ， 后 者 在 概念 上 类 似 于 Java 的 字 节 码 ， 因 为 它 只 在 绝对 必需 的 情 
况 下 才 编 译 为 特定 平台 的 指令 。“ 绝 对 必需 ”通常 是 指 一 段 CIL 指 令 ( 例如 一 个 方法 实现 ) 被 NET 运 
行 库 引 用 时 。 

除了 CIL 指 令 外 , 程序 集 还 包含 元 数据 ( metadata )。 元 数据 详尽 描述 了 二 进 制 文件 中 每 个 “类 型 ” 
的 特征 。 例 如 ， 一 个 名 为 SportsCar 的 类 ， 这 个 类 型 的 元 数据 描述 一 些 详细 信息 ， 比 如 SportsCar 的 基 
类 ， 这 个 基 类 如 果 有 接口 ， 则 其 接口 由 SportsCar 来 实现 ， 元 数据 同时 也 详细 描述 了 由 SportsCar 类 型 
支持 的 各 种 成 员 。.NET 元 数据 总 是 存在 并 且 会 由 某 种 支持 NET 的 编译 器 自动 生成 。 

最 后 ， 除 了 CIL 和 类 型 元 数据 之 外 ， 程 序 集 本 身 也 使 用 元 数据 进行 描述 ， 这 类 元 数据 的 正式 名 称 
是 清单 (manifest ) 。 清 单 记 录 了 程序 集 的 当前 版 本 信息 、 文 化 信息 ( 用 于 本 地 化 字符 串 和 图 像 资源 ) 
和 正确 执行 所 需 的 外 部 引用 程序 集 的 列表 。 在 接 下 来 的 几 章 中 ,将 使 用 各 种 各 样 的 工具 来 检验 程序 集 
的 类 型 、 元 数据 和 清单 信息 。 


1.4.1 CIL 的 作用 


现在 我 们 来 深入 探讨 CIL 代 码 、 类 型 元 数据 和 程序 集 清单 。CI 江 是 一 种 和 平台 无 关 的 语言 。 例 如 ， 
下 列 的 C# 代 码 构 成 一 个 简单 的 计算 器 。 现 在 不 必 在 意 具 体 的 语法 ， 只 要 注意 calc 类 中 的 Add() 方 法 的 
格式 : 

// Calc.cs 

using System; 


namespace CalculatorExample 


{ 
// 这 个 类 包含 应 用 程序 的 入 口 点 
class Program 


static void Main() 


Calc c = new Calc(); 
int ans = c.Add(10, 84); 
Console.WriteLine("10 + 84 is {0}.", ans); 


// 等 待 用 户 按 Enter 键 来 结束 程序 
Console.ReadLine(); 
} 
} 


// C# 计 算 器 
class Calc 


public int Add(int x, int y) 
{ return x + yj } 


; 
C# 编 译 器 ( csc.exe ) 编译 这 段 代 码 后 ， 就 会 得 到 一 个 单 文件 *.exe 程 序 集 ， 其 中 包含 一 个 程序 集 清 
单 、CIL 指 令 和 描述 calc 与 program 类 的 各 方面 信息 的 元 数据 。 


说 明 第 2 章 讲述 了 使 用 C# 编 译 器 编译 代码 的 细节 和 图 形 IDE 的 使 用 ， 如 Microsoft Visual Studio。 
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例如 ， 如 果 用 ildasm.exe ( 本 章 稍 后 会 说 明 ) 打开 该 程序 集 ， 会 发 现 Add() 方 法 被 CIL 表 示 为 : 


.method public hidebysig instance int32 Add(int32 Xx, 
int32 y) cil managed 


{ 
// 代 码 长 度 9(0x9)@… 
.maxstack 2 
.locals init (int32 V_0) 
IL 0000: nop 
IL 0001: ldarg.1 
IL 0002: ldarg.2 
IL 0003: add 
IL 0004: stloc.0 
IL 0005: br.s IL 0007 
IL 0007: 1dloc.0 
IL 0008: ret 
} // Calc::Add 方 法 结束 


如 果 看 不 懂 这 段 CIL 代 码 ， 也 不 必 担 心 ， 第 17 章 会 讲述 CIL 编 程 语 言 的 基础 。 需 要 注意 一 点 ，C# 
编译 器 生成 的 是 CIL， 并 不 是 平台 相关 的 指令 。 
这 一 点 适用 于 所 有 支持 NET 的 编译 器 。 为 了 便于 说 明 ,我 们 假设 用 VB 创建 一 个 和 上 面 C# 目 同 的 程序 : 


" Calc.vb 
Imports System 


Namespace CalculatorExample 


' VB“ 模块 ”是 一 个 只 包含 静态 成 员 的 类 
Module Program 
Sub Main() 
Dim c As New Calc 
Dim ans As Integer = c.Add(10, 84) 
Console.WritelLine("10 + 84 is {0}.", ans) 
Console.ReadLine() 
End Sub 
End Module 


Class Calc 
Public Function Add(ByVal x As Integer, ByVal y As Integer) As Integer 
Return x+y 
End Function 
End Class 


End Namespace 
如 果 查 看 Add() 方 法 的 CIL 指 令 ， 你 会 觉得 它 与 VB 编译 器 vbc.exe 生 成 的 代码 非常 相似 ( 只 有 很 少 
的 差别 ): 


.method public instance int32 Add(int32 Xx, 
int32 y) cil managed 


{ 
// 代 码 长 度 8(0x8) 
.maxstack 2 
.locals init (int32 V_0) 
IL 0000: ldarg.1 
IL 0001: ldarg.2 
IL 0002: add.ovf 





〗 编译 生成 的 原始 CIL 代 码 中 注释 本 身 为 英文 ， 书 中 翻译 是 为 了 阅读 方便 ， 请 读者 留意 。 一 一 编者 注 
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IL 0003: stloc.0 
IL_0004: br.s IL_0006 
IL 0006: 1dloc.0 
IL 0007: ret 

} // Calc::Add 方 法 结 


源 代码 ”Calc.cs 和 Calc.vb 代 码 文 件 位 于 Chapter 1 子 目 录 下 。 


1. CIL 的 好 处 

到 此 ， 你 可 能 很 想 弄 清楚 ， 不 直接 把 源 代 码 编译 为 特定 的 指令 集 而 是 编译 为 CIL 的 好 处 到 底 在 哪 
里 。 有 一 点 好 处 就 是 语言 的 集成 性 。 如 前 所 述 ， 每 种 支持 .NET 的 编译 器 生成 的 是 几乎 完全 相同 的 CIL 
指令 。 因 此 ， 所 有 语言 都 能 很 好 地 在 定义 明确 的 二 进 制 文件 间 交 互 。 

此 外 ，CIL 是 平台 无 关 的 ，.NET Framework 本 身 也 是 平台 无 关 的 。Java 程 序 员 早已 体会 到 了 这 一 
点 好 处 ( 例如， 一 个 代码 库 就 可 以 在 多 种 操作 系统 上 运行 )。 实 际 上 , 已 经 存在 C# 语 言 的 国际 标准 和 
大 量 的 .NET 平 台 和 实现 的 子 集 ,它们 可 以 供 许多 非 Windows 的 操作 系统 使 用 (本章 最 后 会 详细 说 明 )。 

2. 将 CIL 编 译 成 特定 平台 的 指令 

由 于 程序 集 包含 的 是 CIL 指 令 而 不 是 某 一 特定 平台 的 指令 ，CIL 代 码 必须 在 使 用 之 前 进行 即时 编 
译 。 将 CIL 代 码 编译 成 有 意义 的 CPU 指令 的 工具 称 为 JIT (即时 ) 编译 器 ， 有 时 也 称 为 Jitter。.NET 运 行 
库 环 境 将 使 用 针对 各 种 不 同 CPU 的 JIT 编 译 器 ， 每 个 编译 器 都 会 针对 底层 平台 进行 优化 。 

比如 ， 在 手持 设备 ( 如 Windows 移 动 设备 ) 上 部 署 一 个 NET 应 用 程序 ， 就 可 以 配备 相应 的 Jitter 以 
在 低 内 存 环境 下 运行 。 另 一 方面 ， 如 果 为 后 台 服 务 器 部 署 程序 集 ( 通常 内 存 不 是 问题 )， 那 么 Jitter 又 
能 进行 优化 ， 使 代码 在 高 内 存 环境 下 运行 。 这 样 ， 开 发 人 员 只 需 编写 一 套 代 码 ， 就 能 在 不 同体 系 结构 
的 设备 上 通过 JIT 编 译 器 高 效 地 编译 和 执行 。 

另外 ， 当 给 定 的 Jitter 编 译 器 将 CIL 指 令 编译 为 相应 的 机 器 代码 时 ， 它 会 用 适合 目标 操作 系统 的 方 
式 将 结果 缓存 在 内 存 中 。 这 样 ， 如 果 PrintDocument() 方 法 被 调用 ， 则 它 对 应 的 CIL 指 令 将 在 第 一 次 调 
用 中 被 编译 成 特定 平台 的 指令 并 被 保留 在 内 存 中 以 备 以 后 使 用 。 因 此 , 在 下 一 次 调用 PrintDocument() 
时 ， 就 不 需要 编译 CIL 了 。 


说 明 同样 可 以 使 用 NET4.5 Framework SDK 附 带 的 ngen.exe 命 令 行 工具 在 安装 程序 时 执行 “ 预 IT”。 
这 样 做 可 以 改善 图 形 密集 的 应 用 程序 的 启动 时 间 。 


1.4.2 .NET 类 型 元 数据 的 作用 


除了 CIL 指 令 以 外 ，.NET 程 序 集 还 包括 全 部 完整 且 准 确 的 元 数据 ， 这 些 元 数据 描述 了 每 一 个 二 进 
制 文件 中 定义 的 类 型 ( 如 类 、 结 构 、 枚 举 等 ) 以 及 每 个 类 型 的 成 员 ( 比如 属性 、 方 法 和 事件 等 )。 值 
得 庆幸 的 是 , 生成 最 新 的 和 最 大 的 类 型 元 数据 总 是 编译 器 的 工作 而 不 是 程序 员 的 工作 。 因 为 .NET 元 数 
据 非 常 详细 ， 所 以 程序 集 完全 成 了 自 描述 的 实体 。 

为 了 说 明 .NET 类 型 元 数据 的 格式 ， 我 们 来 看 之 前 为 C# Calc 类 的 Add() 方 法 生成 的 元 数据 (为 VB 
版 本 的 Add() 方 法 生成 的 元 数据 是 相似 的 ): 
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TypeDef #2 (02000003) 





TypDefName: CalculatorExample.Calc (02000003) 
Flags : [NotPublic] [AutoLayout] [Class] 
[AnsiClass] [BeforeFieldInit] (00100001) 
Extends  : 01000001 [TypeRef] System.0bject 
Method #1 (06000003) 
MethodName: Add (06000003) 
Flags : [Public] [HideBySig] [ReuseSlot] (00000086) 
RVA : Ox00002090 
ImplFlags : [IL] [Managed] (00000000) 
CallCnvntn: [DEFAULT] 
hasThis 
ReturnType: I4 
2 Arguments 
Argument #1: I4 
Argument #2: I4 
2 Parameters 
(1) ParamToken : (08000001) Name : x flags: [none] (00000000) 
(2) ParamToken : (08000002) Name : y flags: [none] (00000000) 


元 数据 不 仅 用 于 .NET 运 行 库 环 境 的 许多 方面 , 而 且 用 于 各 种 开发 工具 中 。 例如 , 诸如 Visual Studio 
等 工具 提供 的 智能 感知 ( IntelliSense ) 特性 就 能 在 设计 阶段 读 取 程序 集 的 元 数据 。 各 种 对 象 浏览 工具 、 
调试 工具 以 及 C# 编 译 器 自身 都 使 用 元 数据 。 需 要 注意 的 是 , 元 数据 是 许多 .NET 技 术 的 支柱 , 这 些 技术 
包括 WCF、 反 射 、 晚 期 绑 定 和 对 象 序列 化 。 第 15 章 将 正式 讨论 .NET 元 数据 的 作用 。 


1.4.3 ”程序 集 清单 的 作用 


最 后 , 请 记 住 .NET 程 序 集 也 包含 描述 程序 集 自身 的 元 数据 ( 称 为 清单 , manifest )。 在 许多 细节 中 ， 
清单 记录 了 所 有 确保 现 有 程序 集 正常 工作 的 外 部 程序 集 、 程 序 集 的 版 本 号 、 版 权 信 息 等 。 同 类 型 元 数 
据 一 样 ， 生 成 程序 集 清单 也 是 编译 器 的 工作 。 下 面 是 编译 Calc.cs 代 码 文件 ( 本 章 前 面 提 到 过 ) 时 所 生 
成 的 清单 的 一 些 重 要 细节 ( 假设 我 们 指示 编译 器 将 程序 集 命 名 为 Calc.exe ): 


.assembly extern mscorlib 


{ 
.publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
Ver 4:0:0:0 


} 
.assembly Calc 


.hash algorithm Ox00008004 
-Ver 1:0:0:0 


.module Calc.exe 
.imagebase Ox00400000 
.Subsystem Ox00000003 
.file alignment Ox00000200 
.Corflags Ox00000001 


简要 地 说 ， 这 个 清单 记录 了 Calc.exe ( 通过 .assembly extern 指 令 ) 所 需要 的 外 部 程序 集 ， 同 时 也 
记录 了 程序 集 本 身 的 各 种 特性 ( 如 版 本 号 、 模 块 名 称 等 )。 第 14 章 将 详细 介绍 清单 数据 的 优点 。 
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1.5 CTS 


一 个 给 定 的 程序 集 可 能 包含 任意 数量 的 不 同 “ 类 型 ”。 在 .NET 领 域 ， 类 型 (type ) 是 一 个 一 般 性 
的 术语 ， 它 指 的 是 集合 { 类 , 接口， 结构 ， 枚 举 ， 委 托 } 里 的 任意 一 个 成 员 。 当 用 支持 .NET 的 语言 构建 
解决 方案 时 , 很 有 可 能 要 与 这 些 类 型 打交道 。 例如 , 程序 集 可 能 定义 了 一 个 类 , 它 又 实现 了 一 些 接口 。 
或 许 其 中 某 个 接口 方法 采用 枚 举 类 型 作为 输入 参数 ， 而 在 调用 时 返回 一 个 结构 。 

CTS (公共 类 型 系统 ) 是 一 个 正式 的 规范 ， 它 规定 了 类 型 必须 如 何 定 义 才能 被 CLR 承 载 。 通 常 ， 只 
有 那些 创建 针对 .NET 平 台 的 工具 或 编译 器 的 人 才 对 CTS 的 内 部 工作 非常 关心 。 但 是 , 对 于 所 有 .NET 编 程 
人 员 来 说 , 学 习 如 何在 自己 使 用 的 语言 中 使 用 由 CTS 定 义 的 $ 种 类 型 , 是 非常 重要 的 。 这 里 简单 概括 一 下 。 


1.5.1 CTS 类 类 型 


每 一 种 支持 .NET 的 语言 至 少 要 支持 类 类 型 (class type ) 的 概念 ， 这 是 OOP 的 基础 。 类 可 能 由 很 多 成 
员 (诸如 构造 函数 、 属 性 、 方 法 和 事件 ) 和 数据 点 (字段 ) 组 成 。 在 C# 中 ,使 用 class 关 键 字 来 声明 类 : 
// 带 有 1 个 方法 的 C# 类 类 型 


class Calc 


第 5 章 将 讲述 用 C# 构 造 CTS 类 类 型 的 过 程 。 表 1-1 给 出 了 有 关 类 类 型 的 一 些 特征 。 





表 1-1 CTS 类 类 型 
类 的 特征 在 生命 周期 里 的 意义 
类 是 否 被 “密封 ” 密封 类 不 能 作为 其 他 类 的 基 类 
类 实现 任何 接口 了 吗 。” ”接口 是 抽象 成 员 的 集合 , 它 在 对 象 和 对 象 的 用 户 间 提 供 一 个 契约 。CTS 人 允许 类 实现 任何 数目 


的 接口 
类 是 具体 的 还 是 抽象 的 ”抽象 类 是 不 能 直接 创建 的 ， 但 是 可 以 用 来 为 派生 类 型 定义 公共 的 行为 。 具 体 类 可 以 直接 创建 
这 个 类 的 可 见 性 是 什么 每 个 类 必须 用 关键 字 ( 比如 public 或 internal ) 设置 可 见 性 。 基 本 上 ， 可 见 性 定义 了 该 类 是 
被 外 部 程序 集 使 用 ， 还 是 仅 能 在 定义 了 它 的 程序 集中 使 用 


1.5.2 CTS 接口 类 型 


接口 (interface ) 就 是 由 抽象 成 员 定 义 所 组 成 的 一 个 具名 集合 ， 可 通过 一 个 给 定 的 类 或 结构 来 实现 。 
在 C# 中 , 接口 类 型 使 用 interface 关 键 字 来 定义 ,一 般 情况 下 , 所 有 的 .NET 接 口 均 以 大 写字 母 I 开 头 , 例如 : 
// C# 接 口 通 常 被 声明 为 公共 的 ， 这 样 其 他 程序 集中 的 类 型 就 可 以 实现 其 行为 


public interface IDraw 


void Draw(); 


就 它们 自身 而 言 , 接口 没有 什么 用 。 然 而 , 当 一 个 类 或 结构 用 其 独特 方式 来 实现 一 个 给 定 接口 时 ， 
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你 将 能 够 以 多 态 方式 通过 接口 引用 来 请 求 使 用 所 提供 的 功能 。 基 于 接口 的 编程 将 在 第 8 章 中 全 面 介 绍 。 


1.5.3 CTS 结构 类 型 


CTS 中 还 支持 结构 (structure ) 的 概念 。 如 果 你 有 C 语 言 的 背景 ， 应 该 会 很 高 兴 地 发 现 这 种 用 户 自 
定义 类 型 ( UDT ) 也 存在 于 :NET 领域 中 ( 虽然 它们 的 行为 在 底层 不 同 )。 简 单 地 说 ， 结 构 ( struct ) 可 
以 看 做 是 具有 值 语义 的 轻 量 级 类 类 型 。 关 于 结构 的 细节 ， 请 参见 第 4 章 。 通 常 ， 结 构 最 适合 建 模 几 何 
和 数学 数据 。 在 C# 中 ,通常 使 用 struct 关 键 字 创建 结构 : 


// C# 结 构 类 型 
struct Point 


{ 
// 结构 可 以 包含 字段 
public int xPos, yPos; 


// 结构 可 以 包含 参数 化 构造 函数 
public Point(int x, int y) 
{ xPos = x; yPos = y;} 


// 结构 可 以 定义 方法 
public void PrintPosition() 


Console.WriteLine("({0}, {1})", xPos, yPos); 


} 


1.5.4 CTS 枚 举 类 型 


枚 举 ( enumeration ) 是 一 种 便利 的 编程 结构 , 它 可 以 用 来 组 成 名 称 / 值 对 。 例 如 ,假设 你 在 开发 一 
个 视频 游戏 的 程序 ， 要 让 玩家 在 3 种 角色 ( Wizard、Fighter 或 Thief ) 中 选择 一 个 。 你 完全 可 以 用 enum 
关键 字 来 建立 一 个 自 定 义 的 枚 举 ， 而 不 用 老 是 要 记 着 代表 每 种 可 能 性 的 原始 数字 值 : 


// C# 履 举 类 型 
enum CharacterType 


Wizard = 100， 
Fighter = 200， 
Thief = 300 


在 默认 情况 下 ， 每 一 项 是 用 一 个 32 位 的 整数 来 存储 的 ， 但 如 果 需 要 ， 也 可 以 改变 存储 大 小 〈 例 如 ， 
在 为 Windows 移 动 设备 之 类 的 低 内 存 设 备 编程 时 )。 另外 , CTS 要求 枚 举 类 型 派生 自 基 类 System.Enum。 在 
第 4 章 中 你 将 看 到 , 这 个 基 类 定义 了 一 些 有 趣 的 成 员 ，, 允许 通过 编程 提取 、 操 作 和 变换 底层 的 名 称 / 值 对 。 


1.5.5 ” CTS 委托 类 型 


委托 ( delegate ) 在 .NET 中 等 效 于 类 型 安全 的 C 风 格 的 函数 指针 。 它 们 的 主要 不 同 在 于 ，.NET 委 
托 是 派生 自 System.MulticastDelegate 的 类 ， 而 不 是 一 个 简单 地 指向 原始 内 存 地 址 的 指针 。 在 C# 中 ， 
委托 是 使 用 关键 字 delegate 来 声明 的 : 


// 这 个 C# 委 托 类 型 可 以 “指向 ”任意 带 有 两 个 整 型 参数 且 返 回 一 个 整 型 值 的 方法 
delegate int BinaryOp(int x, int y); 
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一 个 实体 可 以 用 委托 向 另 一 个 实体 传递 调用 ,另外 , 委托 也 为 ,NET 事件 架构 提供 了 基础 。 在 第 11 
章 和 第 19 章 中 ， 你 将 看 到 ， 委 托 对 多 路 广播 ( 即将 一 个 请 求 转发 给 多 个 接收 者 ) 和 异步 方法 调用 ( 即 
从 另 一 个 线程 调用 方法 ) 有 着 内 在 支持 。 


1.5.6 CTS 类 型 成 员 


现在 你 已 经 看 到 了 由 CTS 正 式 规定 的 各 种 类 型 ， 但 还 要 认识 到 ， 大 部 分 的 类 型 可 以 含有 任意 数量 
的 成 员 。 说 得 更 正式 一 些 ， 类 型 成 员 是 集合 { 构 造 函 数 ， 终 结 咒 ， 静 态 构造 函数 ， 散 套 类 型 ， 操 作 符 ， 
方法 ， 属 性 ， 索 引 器 ， 字 段 ， 只 读 字段 ， 常 量 ， 事 件 } 中 的 元 素 之 一 。 

CTS 定 义 了 各 种 可 能 与 具体 成 员 关 联 的 修饰 语 (adornment ) 。 例如， 每 个 成 员 都 有 一 个 给 定 的 可 
见 性 特征 ( 如 公共 的 、 私 有 的 和 受 保护 的 等 ) 有些 成 员 可 能 被 声明 成 抽象 的 以 加 强 派生 类 的 多 态 性 ， 
有 些 成 员 可 声明 为 虚拟 的 以 定义 一 个 封装 (但 可 重 写 ) 的 实现 。 同 样 ， 绝 大 部 分 成 员 可 设置 成 静态 的 
(在 类 级 别 绑 定 ) 或 者 实例 〈 在 对 象 级 别 绑 定 )。 类 型 成 员 的 创建 会 在 以 后 的 几 章 中 介绍 。 


说 明 在 第 9 章 中 将 讲 到 ，C# 语 言 也 支持 泛 型 类 型 和 泛 型 成 员 的 创建 。 


1.5.7 ”内 建 的 CTS 数 据 类 型 


CTS 需 要 关注 的 最 后 一 个 方面 是 ， 它 建立 的 一 套 定义 明确 的 核心 数据 类 型 。 尽 管 不 同 的 语言 通常 都 
有 自己 唯一 的 用 于 声明 内 建 CTS 数 据 类 型 的 关键 字 ， 但 是 所 有 语言 的 关键 字 最 终 将 解析 成 定义 在 
mscorlib.dll 程 序 集中 的 相同 类 型 ,参考 表 1-2, 它 描述 了 如 何在 不 同 的 .NET 语 言 中 表示 关键 的 CTS 数 据 类 型 。 


表 1-2 ”内 建 的 CTS 数 据 类 型 


CTS 数 据 类 型 VB 关键 字 C# 关 键 字 C++/CLI 关 键 字 
System.Byte Byte byte unsigned char 
System.SByte SByte sbyte signed char 

System. Int16 Short short short 

System.Int32 Integer int int 或 long 
System.Int64 Long long _ int64 

System.UInt16 UShort ushort unsigned short 
System.UInt32 UInteger uint unsigned int 或 unsigned long 
System.UInt64 ULong ulong unsigned _ int64 
System.Single Single float Float 

System.Double Double double double 

System.Object Object object object^ 

System. ChaT Char char wchar +t 
System.String String string String^ 
System.Decimal Decimal decimal Decimal 
System.Boolean Boolean bool bool 


由 于 各 种 托管 语言 的 关键 字 只 是 System 命名 空间 中 真实 类 型 的 简化 符号 ， 我 们 不 需要 担心 数值 数 
据 的 上 溢 或 下 洲 , 或 是 字符 串 和 布尔 型 数据 在 内 部 是 怎样 跨 不 同 语言 进行 表示 的 。 下 面 的 代码 片段 使 
用 C# 和 和 VB， 通过 语言 关键 字 和 正式 的 CTS 数 据 类 型 分 别 定义 了 32 位 数值 变量 。 
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// 用 C# 定 义 整 型 数据 
dint 4. = O08 
System.Int32 j = 0; 


”用 VB 定义 整 型 数据 
Dim i As Integer = 0 
Dim j As System.Int32 = 0 


1.6 CLS 


我 们 知道 , 不同 的 语言 往往 用 不 同 的 、 语 言 特定 的 术语 表达 相同 的 程序 构造 ， 比 如 ， 在 C# 中 使 用 
加 号 (+ ) 操作 符 表示 字符 串 拼 接 ， 而 在 VB 中 却 使 用 “&” 符 号 。 即 使 两 种 不 同 的 语言 表达 相同 的 编 
程 惯用 法 ( 比如 一 个 不 返回 值 的 函数 )， 在 表面 看 起 来 ， 语 法 也 可 能 非常 不 同 。 


// C# 不 返回 值 的 方法 
public void MyMethod() 


{ 
人 


”VB 不 返回 值 的 方法 
Public Sub MyMethod() 
”一 些 有 趣 的 代码 

End Sub 


正如 你 已 经 看 到 的 ,在 ,NET 运行 库 看 来 这 些 较 小 的 语法 变化 是 微不足道 的 ,因而 不 同 的 编译 器 ( 这 
里 用 到 的 是 vbc.exe 或 csc.exe ) 将 产生 类 似 的 CIL 指 令 集 。 然而 , 语言 也 可 能 在 功能 上 不 同 , 比如 , .NET 
语言 可 能 有 也 可 能 没有 关键 字 来 表示 无 符号 数据 ， 可 能 支持 也 可 能 不 支持 指针 类 型 。 对 于 这 些 可 能 的 
变化 ， 理 想 情 况 是 所 有 支持 .NET 的 语言 都 有 一 个 可 以 遵循 的 基准 。 

CLS 就 是 这 样 一 套 规则 ， 它 清晰 地 描述 了 支持 .NET 的 编译 器 必 须 支持 的 最 小 的 和 完全 的 特征 集 ， 
以 生成 可 由 CLR 承 载 的 代码 ， 同 时 可 以 被 基于 .NET 平 台 的 其 他 语言 用 统一 的 方式 进行 访问 。CLS 可 以 
看 成 是 由 CTS 定 义 的 完整 功能 的 一 个 子 集 。 

如 果 打 算 让 自己 的 产品 功能 无 缝 地 融合 到 .NET 世 界 , 那么 CLS 是 编译 器 创建 者 最 终 必 须 遵循 的 一 
套 规则 。 每 个 规则 被 赋予 一 个 简单 的 名 字 ( 如 CLS 规 则 6 )， 描 述 了 这 个 规则 如 何 影响 创建 编译 器 的 人 
以 及 ( 以 某 种 方式 ) 与 他 们 交互 的 人 。 影 响 最 大 的 是 规则 1。 

口 规则 1: CLS 规 则 仅 适 用 于 类 型 中 向 定义 它 的 程序 集 以 外 公开 的 部 分 。 

根据 这 个 规则 ， 可 以 (正确 地 ) 推断 其 余 的 CLS 规 则 对 于 用 来 建立 一 个 .NET 类 型 内 部 运行 功能 的 
逻辑 是 不 适用 的 。 必 须 遵 循 CLS 的 类 型 的 唯一 一 点 ， 就 是 成 员 定义 本 身 ( 即 命名 规范 、 参 数 和 返回 类 
型 )。 成 员 的 实现 逻辑 可 以 使 用 其 他 的 非 CLS 技 术 ， 程序 外 部 并 不 知道 这 些 不 同 。 

举例 说 明 ， 下 面 的 Add() 方 法 就 没有 遵循 CLS 规 则 , 因为 它 的 参数 和 返回 值 使 用 了 无 符号 数 ( 无 符 
号 数 不 符 合 CLS ): 

class Calc 


{ 
// 公开 的 无 符号 类 型 数据 不 遵循 CLS 规 则 
public ulong Add(ulong x, ulong y) 
{ 


return x + y; 
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然而 ， 如 果 像 下 面 一 样 在 程序 内 部 使 用 无 符号 数 : 


class Calc 
public int Add(int x, int y) 


// 当 ulong 类 型 变量 仅仅 在 内 部 使 用 时 ,仍然 遵循 CLS 规 则 
ulong temp = 0; 


return x + yj 


} 

这 仍然 遵循 CLS 规 则 ， 可 以 保证 所 有 的 .NET 语 言 都 能 调用 Add() 方 法 。 

当然 ， 除 规则 1 外 ，CLS 还 定义 了 很 多 其 他 的 规则 。 例 如 ，CLS 描 述 了 一 种 语言 如 何 表示 文本 字符 
串 ， 如 何在 内 部 表示 枚 举 ( 用 于 存储 的 基 类 型 )， 如 何 定义 静态 成 员 ， 等 等 。 好 在 你 不 需要 记忆 所 有 
的 规则 也 能 成 为 精通 .NET 的 程序 员 。 总 地 来 说 ， 只 有 那些 工具 /编译 器 的 开发 人 员 才 会 对 CTS 和 CLS 规 
范 的 具体 细节 感 兴趣 。 


确保 遵循 CLS 
正如 本 书 将 提 到 的 ，C# 定 义 了 一 些 不 遵循 CLS 规 则 的 程序 结构 ， 但 你 仍然 可 以 使 用 一 个 专门 
的 .NET 特 性 指示 C# 编 译 咒 检查 代码 是 否 遵循 CLS 规 则 。 


// 指示 C# 编 译 器 检查 是 否 遵循 CLS 规 则 
[assembly: CLSCompliant(true)] 


第 15 章 会 详细 探讨 基于 特性 的 编程 。 目 前 ， 只 需要 知道 [CLSCompliant] 特 性 就 是 用 来 指示 C# 编 译 
器 按 CLS 规 则 检查 每 行 代码 的 。 如 果 代 码 违反 了 CLS， 就 会 给 出 编译 器 错误 和 关于 错误 代码 的 描述 。 


1.7 CLR 


除 CTS 和 CLS 规 范 外 ， 我 们 现在 要 了 解 的 最 后 一 个 字母 缩写 术语 是 CLR。 从 编程 角度 来 说 ， 运 行 
库 (runtime ) 可 以 理解 为 执行 给 定编 译 代码 单元 所 需 的 外 部 服务 的 集合 。 比 如 ， 当 Java 程 序 员 向 一 台 
新 电脑 部 署 软件 时 ， 要 确保 软件 运行 ， 电 脑 上 就 要 安装 JVM ( Java Virtual Machine，Java 虚 拟 机 )。 

.NET 平 台 提供 了 另 一 种 运行 库 系 统 。 .NET 运 行 库 与 刚才 提 到 的 其 他 运行 库 的 关键 不 同 在 于 , .NET 
运行 库 提供 了 一 个 定义 明确 的 运行 库 层 ， 可 以 被 支持 .NET 的 所 有 语言 和 平台 所 共享 。 

CLR 中 最 重要 的 部 分 是 由 名 为 mscoree.dll 的 库 ( 又 称 公 共 对 象 运行 库 执 行 引 擎 ) 物理 表示 的 。 当 
用 户 程序 引用 一 个 程序 集 ， 要 使 用 它 时 ，mscoree.dll 将 首先 自动 加 载 ， 然 后 由 它 负 责 将 需要 的 程序 集 
导入 内 存 。 运 行 时 引擎 负责 许多 任务 ， 首 要 的 任务 是 负责 解析 程序 集 的 位 置 ， 并 通过 读 取 其 中 包含 的 
元 数据 ， 在 二 进 制 文件 中 发 现 所 请 求 的 类 型 。 接 着 ，CLR 在 内 存 中 为 类 型 布局 ， 将 关联 的 CIL 编 译 成 
特定 平台 的 指令 ， 执 行 所 有 需要 的 安全 检查 ， 然 后 运行 当前 的 代码 。 

除了 导入 自 定 义 的 程序 集 和 建立 自 定 义 的 类 型 , 必要 时 CLR 也 会 与 包含 在 ,NET 基础 类 库 的 类 型 交 
互 。 虽 然 完 整 的 基础 类 库 被 分 为 若干 分 离 的 程序 集 ， 但 最 重要 的 程序 集 是 mscorlib.dll。mscorlib.dll 包 
含 大 量 核心 类 型 , 它们 封装 了 各 种 常见 的 编程 任务 与 NET 语言 用 到 的 核心 数据 类 型 。 当 建立 一 个 NET 
解决 方案 时 ， 你 可 以 自动 访问 这 些 程序 集 。 
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图 1-4 说 明了 发 生 在 源 代码 ( 它 使 用 了 许多 基础 类 库 类 型 )、.NET 编 译 器 和 .NET 执 行 引擎 之 间 的 和 
工作 流 。 


某 种 支持 NET 
的 语言 编写 的 
NET 源 代码 


*.dll 或 *.exe 程 序 集 
(CIL、 元 数据 和 清单 ) 


-NET 执行 引擎 


(mscoree.dll) 


基础 类 库 
(mscorlib.dll 等 ) 





图 1-4 mscoree.dll 工 作 流 
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我 们 都 知道 代码 库 的 重要 性 ,框架 库 的 关键 就 是 要 给 程序 员 提 供 一 套 定义 明确 的 既 有 代码 ， 从 而 
显著 提高 开发 效率 。C# 没 有 提供 特定 语言 的 代码 库 ， 但 C# 程 序 员 可 以 利用 语言 无 关 的 .NET 代 码 库 。 
为 确保 基础 类 库 中 的 所 有 类 型 能 良好 地 组 织 在 一 起 ，.NET 平 台 提 出 了 命名 空间 ( namespace ) 的 概念 。 

简单 地 讲 , 命名 空间 就 是 一 个 程序 集 内 相关 类 型 的 一 个 分 组 。 举例 来 讲 ，System.I0 命 名 空间 包含 
了 有 关 文 件 1/O 的 类 型 ，System.Data 命 名 空间 定义 了 基本 的 数据 库 类 型 ， 等 等 。 需 要 特别 指出 的 是 ， 
一 个 程序 集 ( 比如 mscorlib.dll ) 可 以 包含 任意 个 命名 空间 ， 每 个 命名 空间 又 可 以 包含 多 种 类 型 。 

为 了 更 清楚 地 阐述 ， 图 1-5 展 现 了 一 个 Visual Studio Object Browser 的 截图 。 这 个 工具 可 以 用 来 检查 
当前 项 目 引 用 的 程序 集 、 位 于 一 个 特定 程序 集中 的 命名 空间 、 给 定 命名 空间 中 的 类 型 以 及 具体 类 型 的 
成 员 。 注 意 ，mscorlib.dll 包 含 了 许多 不 同 的 命名 空间 ( 如 System.I0 )， 每 个 命名 空间 都 拥有 语义 上 相 
关 的 类 型 ( 如 BinaryReader )。 


bs Microsoft.VisualC.STLCLR 





4 wu mscorib 





- 


| 痊 @ BinaryReader(System.IO.Stream) EE 
© BinaryReader(System .IO.Stream, System. 
















bt) Micrasoft Win32 1 @ BinaryReadertSystemjJO.Stream System 

b {} Microsoft.Win32.SafeHandles 四 @ Closel} | 

b 《) System 一 人 Disposel Ee 

b {} System.Collections @, Dispose(bood | 

bp {} System,Collections.Concurrent ®, FillBuffer(int) | 

b {} System,Collections.Generic ®@ PeekCharl) | 

b {} SystemCollections.ObjectMoedel @ ReadO i 

b {) Systern.Configuration Assembfies ®@ Readibytel ] int int} 

b {}) System.Deployment.Internal @ Readfchar[ ] int int} 

bp (} System.Diagnostics @, Read7BitEncodedintO 

b {} System.Disgnostics.CodeAnalysis @ ReadBoolesn0 

b {} System,Diagnostics.Contracts ®@ ReadBytel) 

b {}) System.Diagnostics.Contracts internal ® Readgytesfint) 

b (} System.Diagnostics.SymbolStore @ ReadChar0 

b {}) System,Diagnostics,Tracing 全 ReadCharstint 强 

b {) System.Globalization «nn nd 4 

4 {) SystemlO public class BinaryReader ^ 
» % ES Member of Syster.IQ | 
by Wy BinaryWriter | 
bp 如 BufferedStream Summary: 司 
》 He Directory Reads primitive data types as binary | 
by ts Directoryinfo Yalues in a specific encoding. . 


b He DirectoryNotFoundException 
4 ey msl, oom ey 


图 1-5 程序 集 可 以 包含 任意 多 个 命名 空间 

这 种 方法 和 一 个 特定 于 语言 的 库 的 关键 不 同 在 于 , 任何 基于 .NET 运 行 库 的 语言 都 可 以 使 用 相同 的 
命名 空间 和 相同 的 数据 类 型 。 举 例 来 讲 ， 下 面 3 个 程序 分 别 使 用 了 C#、VB 和 C++/CLI 编 写 ， 演示 了 常 
见 的 “Hello World” 应 用 程序 。 


// 用 C# 写 的 Hello World 
using System; 





,Attributes: 


public class MyApp 
{ 
static void Main() 


Console.WriteLine("Hi from C#"); 


} 
} 


”用 VB 写 的 Hello World 
Imports System 
Public Module MyApp 
Sub Main() 
Console.WriteLine("Hi from VB") 
End Sub 
End Module 


// 用 C+HCLI 写 的 Hello World 
#include "stdafx.h" 
using namespace System; 


int main(array<System::String ^> ^args) 


Console: :WriteLine(L"Hi from C++/CLI"); 
return 0; 
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注意 ， 每 种 语言 都 使 用 了 System 命名 空间 中 定义 的 Console 类 。 除 了 语法 上 略微 不 同 外 ，3 个 应 用 
程序 从 外 观 上 和 逻辑 上 看 起 来 非常 相似 。 

应 该 清楚 ，.NET 程 序 员 的 主要 目标 就 是 逐步 了 解 大 量 定义 在 .NET 命 名 空间 里 的 类 型 。 最 基本 的 
命名 空间 无 疑 是 System。 这 个 命名 空间 提供 了 大 量 核心 的 类 型 , 是 .NET 程 序 员 会 反复 使 用 的 。 实 际 上 ， 
因为 核心 数据 类 型 ( System.Int32、System.String 等 ) 是 在 System 命名 空间 中 定义 的 ， 所 以 如 果 完 全 
不 引用 System 命名 空间 ， 就 根本 无 法 开发 C# 应 用 程序 。 表 1-3 简 要 介绍 了 一 些 ( 当然 不 是 全 部 的 ) 按 相 
关 功 能 分 组 的 .NET 命 名 空间 。 





表 1-3 .NET 命 名 空间 举例 


.NET 命 名 空间 作 用 
System 在 System 内 ， 你 将 会 发 现 很 多 有 用 的 类 型 ， 可 以 用 来 处 理 内 建 数据 、 数 学 
计算 、 随 机 数 的 产生 、 环 境 变量 、 垃 圾 收集 器 以 及 一 些 常 见 的 异常 和 特性 
System.Collections 这 些 命 名 空间 定义 了 一 些 集 合 容器 类 型 ， 还 有 一 些 基 类 型 和 接口 ， 使 你 有 
System.Collections .GeneTic 可 能 构建 自 定义 的 收集 器 
System.Data 这 些 命 名 空间 用 来 使 用 ADO.NET 与 数据 库 交 互 


System.Data.Common 

System.Data.EntityClient 

System.Data.SqlClient 

System.I0 这 些 命名 空间 定义 了 许多 处 理 文件 WO、 数 据 压 缩 和 端口 操作 的 类 型 
System.I0.Compression 

System.I0.Ports 

System.Reflection 这 些 命 名 空间 定义 了 一 些 类 型 ， 支 持 运行 时 类 型 发 现 与 类 型 的 动态 创建 
System.Reflection.Emit 

System. Runtime. InteropServices 这 个 命名 空间 提供 了 一 些 设施 , 使 得 .NET 类 型 可 以 与 “ 非 托 管 代码 ”交互 
( 例如， 基于 C 的 DLL 和 COM 服 务 器 )， 或 反 过 来 
这 


些 命名 空间 定义 了 使 用 .NET 原 始 UI 工 具 包 ( Windows Forms ) 来 构建 桌 


System.Drawing 


System.Windows.Forms 面 应 用 程序 所 用 到 的 类 型 
System.Windows System.Windows 命 名 空间 是 一 些 表示 WPF UI 工具 包 的 几 个 命名 空间 的 根 





System.Windows.Controls 

System.Windows.Shapes 

System. Ling 这 些 命名 空间 定义 了 针对 LINQ API 编 程 时 用 到 的 类 型 
System.Xm1.Linq 

System.Data.DataSetExtensions 


System.Neb 这 个 命名 空间 用 来 构建 ASP.NET Web 应 用 程序 

System.ServiceModel 这 个 命名 空间 用 来 通过 WCF API 构 建 分 布 式 应 用 程序 
System.Workflow.Runtime 这 两 个 命名 空间 定义 了 使 用 WWF API 构 建 支持 工作 流 的 应 用 程序 的 类 型 
System.Workflow.Activities 

System. Threading 这 个 命名 空间 定义 了 可 以 用 来 构建 多 线程 应 用 程序 ( 将 工作 负载 分 配 到 多 
System.Treading.Tasks 个 CPU 上 ) 的 类 型 

System. Security 安全 是 .NET 中 的 一 个 不 可 分 割 的 方面 。 在 这 个 以 安全 为 中 心 的 命名 空间 


中 ， 有 很 多 用 来 处 理 权限 、 加 密 等 问题 的 类 型 
System.Xml 这 个 以 XML 为 中 心 的 命名 空间 包括 了 众多 用 于 与 XML 数据 交互 的 类 型 
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1.8.1 Microsoft 根 命名 空间 的 作用 


在 看 表 1-3 时 ， 你 应 该 注意 到 了 System 是 许多 榜 套 命名 空间 ( 如 System.I0、System.Data 等 ) 的 根 命 
名 空间 。 然 而 ， 其 实 .NET 基 础 类 库 定 义 了 许多 System 之 外 的 最 高 层 根 命名 空间 ， 其 中 最 有 用 的 叫做 
Microsoft。 

简 而 言 之 ， 任 何 Microsoft 的 租 套 命名 空间 ( 如 Microsoft.CSharp、Microsoft.ManagementConsole 
以 及 Microsoft.Win32 ) 包 含 的 类 型 都 用 于 和 那些 只 属于 Windows 操 作 系 统 的 服务 进行 交互 。 这 样 的 话 ， 
我 们 可 以 认为 这 些 类 型 不 能 在 其 他 诸如 Mac OS X 等 支持 .NET 的 操作 系统 上 运行 。 本 书 在 大 多 数 情 况 
下 不 会 深入 到 Microsoft 根 命名 空间 中 的 一 些 细 节 ， 因 此 如 果 你 感 兴 趣 的 话 ， 请 务必 查阅 .NET 
Framework 4.5 SDK 文 档 。 


说 明 第 2 章 举 例 说 明了 .NET Framework 4.5 SDK 文 档 的 作用 ， 它 提供 了 能 在 基础 类 库 中 找到 的 每 一 
个 命名 空间 、 类 型 和 成 员 的 细节 。 


1.8.2 ”以 编程 方式 访问 命名 空间 


命名 空间 只 是 一 种 方便 我 们 从 逻辑 上 理解 和 组 织 关 联 类 型 的 方式 ， 这 一 点 应 该 反复 强调 。 我 们 再 
来 考虑 System 命名 空间 。 从 你 的 角度 看 ， 可 以 假设 System.Console 表 示 一 个 在 System 命名 空间 中 名 为 
Console 的 类 ， 然 而 从 .NET 运 行 库 的 角度 看 ， 它 却 不 是 。 运 行 时 引擎 只 认识 名 为 System.Console 的 独立 
实体 。 

在 C# 中 ，using 关 键 字 简 化 了 引用 特定 命名 空间 中 定义 的 类 型 的 过 程 。 为 什么 呢 ? 假设 要 使 用 
WF API 建 立 一 个 图 形 化 桌面 应 用 程序 , 主 窗口 基于 后 台数 据 库 信息 呈现 一 个 柱状 图 表 并 显示 公司 图 
标 。 理 解 每 个 命名 空间 包含 的 类 型 需要 一 定 的 学 习 和 实践 ， 下 面 是 应 用 程序 中 经 常 引 用 的 一 些 命 名 


空间 。 
// 这 里 列 出 所 有 构建 这 个 应 用 程序 需要 使 用 的 命名 空间 
using System; // 通用 基础 类 库 类 型 


using System. Windows.Shapes; // 图 形 呈 现 类 型 

using System.Windows.Controls;  // GUI 窗口 部 件 类 型 

using System.Dataj // 通用 以 数据 为 中 心 的 类 型 
using System.Data.SqlClient; // MS SQL Server 数 据 访 问 类 型 


指定 了 若干 命名 空间 ( 并 设置 好 指向 定义 它们 的 程序 集 的 引用 ) 以 后 ， 就 可 以 随意 创建 这 些 命名 
空间 包含 的 类 型 的 实例 了 。 举 例 来 说 ， 如 果 想 建立 一 个 Button 类 (在 System.Windows.Controls 命 名 空 
间 中 定义 ) 的 实例 ， 可 以 这 样 写 : 

// 显 式 列 出 这 个 文件 所 使 用 的 命名 空间 


using System; 
using System.Windows.Controls; 


class MyGUIBuilder 


public void BuildUI() 
{ 
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// 创建 按钮 控件 
Button btnOK=new Button(); 


} 
} 
因为 代码 文件 引用 了 System.Windows.Controls， 所 以 编译 器 能 够 将 Button 类 解析 为 这 个 命名 空间 
的 成 员 。 如 果 没 有 特别 指定 System.Windows.Controls 命 名 空间 ， 将 出 现 一 个 编译 需 错 误 。 然 而 ， 还 是 
可 以 使 用 完全 限定 名 (full qualified name ) “来 声明 变量 : 
// 不 使 用 引入 System.Windows .Controls 的 命名 空间 


using System; 


class MyGUIBuilder 


{ 
public void BuildUI 


// 使 用 完全 限定 名 
System.Windows Coutrols Button btnOK= 
new System.Windows.Controls.Button(); 


Ee 
} 


虽然 使 用 完全 限定 名 定义 一 个 类 型 可 以 提高 程序 的 易 读 性 ， 但 C# 的 using 关 键 字 能 够 减少 按键 次 数 。 
本 书 将 选择 C# using 关 键 字 的 简化 方式 ， 而 不 使 用 完全 限定 名 ( 除非 它们 的 定义 含糊 不 清 ， 可 能 发 生 
歧义 )。 

然而 , 请 记 住 using 关 键 字 只 是 特定 类 型 的 完全 限定 名 的 简单 速记 符号 , 每 种 方法 最 后 都 会 得 出 相同 
的 底层 CIL (事实 上 ，CIL 代 码 总 是 使 用 完全 限定 名 )， 并 且 对 程序 集 的 大 小 和 性 能 没有 任何 影响 。 


1.8.3 引用 外 部 程序 集 


除了 通过 C# using 关 键 字 来 指定 命名 空间 ， 还 需要 告诉 C# 编 译 器 包含 引用 类 型 的 实际 CIL 定 义 的 程 
序 集 的 名 字 。 如 前 面 所 提 到 的 ， 许 多 核心 的 .NET 命 名 空间 包含 在 mscorlib.dll 文件 中 。 但 
System.Drawing.Bitmap 类 型 包含 在 另 一 个 名 为 System.Drawing.dll 的 程序 集中 。 大 多 数 .NET Framework 
程序 集 都 位 于 称 为 全 局 程序 集 缓存 ( Global Assembly Cache，GAC ) 的 特定 目录 下 。 在 安装 Windows 
的 计算 机 上 ， 全 局 程序 集 缓存 默认 状态 下 都 位 于 C:\Windows\Assembly 目 录 下 ， 如 图 1-6 所 示 。 

根据 构建 .NET 应 用 程序 所 用 的 开发 工具 的 不 同 ， 可 以 有 多 种 不 同 的 方法 来 告知 编译 器 在 编译 期 间 
要 包括 哪些 程序 集 。 下 一 章 将 会 看 到 如 何 实现 ， 在 此 就 不 再 赣 述 。 


说 明 从 .NET 4.0 开 始 ， 微 软 选 择 将 .NET 4.0 和 .NET 4.5 程 序 集 隔 离 到 一 个 特定 的 位 置 ， 使 之 与 
C:\Windows\ Assembly 宫 无 关系 。 第 14 章 将 详细 介绍 这 一 点 。 





Qz 指 带 有 完整 命名 空间 的 名 字 。 一 一 编者 注 
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出 b Computer » LocalDisk (C:) » Windows » aby » 
:© E 





a ” Include in se v Share with Burn i folder 


^ Assembly Name Version ... Public Key Token 

| 2 System.Runtime.Serialization.Formatters.... 2.0.0.0 b03f5f7flld50a3a 

: |: 坊 System.Security 2000 b03f5f7f11d50a3a 
| 坊 System.ServiceModel 30.00 b77a5c561934e089 


容 Favorites 
| 对 ; Desktop 
最 Downloads 


“4 坝 5ystem,ServiceModel, WasHosting 30.00 b77a5c561934e089 
本 Libraries | :System.ServiceModel.Web 3500 31bf3856ad364e35 
| 习 Documents ， 坊 System. Serviceprocess 2000 b03f5f7 人 1d50a3a 
| ”四 Music | : 坊 5ystem.Speech 3.0.00 31bf3856ad364e35 
| ” 坊 System.Transadtions 2.0.00 b77a5c561934e089 
3 六 System.Transactions 2.0.00 b77a5c561934e089 
:六 System.Web 2.0.00 b03f5f7fl1d50a3a 
| 刘邦 ma :5ystem.Web 2.0.00 b03f5f7fl1d50a3a 
| 玖 System.Web.Abstractions 3.5.00 31bf3856ad364e35 
a ~ : 坊 System.Web.DynamicData 3.5.00 31bf3856ad364e35 


assembly Date modified: 3/4/2012 2:01 PM 
y Filefolder Date created: 7/13/2009 10:20 PM 


| 二 RecentPlaces | 是 ssystemSeviceModal Install 30.00 b77a5c561934e089 
| 
1 





ws) Pictures 
医 Videos 











图 1-6 很 多 .NET 库 都 在 全 局 程序 集 缓存 中 


1.9 ”使 用 ildasm.exe 探索 程序 集 


如 果 感 到 掌握 .NET 平 台中 的 每 一 个 命名 空间 有 些 困 难 , 那么 只 需要 记 住 ,各 命名 空间 的 区 别 在 于 ， 
它们 包含 了 语义 上 具有 一 定 关联 的 类 型 。 所 以 ， 如 果 只 需要 一 个 控制 台 程 序 而 不 需要 用 户 界 面 ， 就 可 
以 不 需要 了 解 桌面 和 Web 命 名 空间 。 如 果 要 建立 一 个 绘画 应 用 程序 ， 那 么 很 可 能 不 会 涉及 数据 库 命 名 
空间 。 同 其 他 任何 新 的 预制 代码 集 类 似 ， 你 可 以 边 干 边 学 。 

与 .NET Framework 4.5 SDK 同 时 发 布 的 中 间 语 言 反 汇编 工具 ( ildasm.exe ) 可 以 加 载 任意 的 .NET 
程序 集 并 分 析 它 的 内 容 ， 包 括 关联 的 清单 、CIL 代 码 和 类 型 元 数据 。 这 个 工具 允许 程序 员 深入 研究 C# 
代码 和 CIL 的 对 应 关系 , 并 会 帮助 我 们 理解 .NET 平 台 的 内 部 工作 原理 。 要 成 为 一 名 优秀 的 .NET 程 序 员 ， 
你 不 一 定 非得 会 用 ildasm.exe ， 只 需 时 不 时 地 打开 这 个 工具 ， 琢 磨 一 下 C# 代 码 和 运行 库 概 念 的 关系 
即 可 。 


说 明 打开 Developer Command Prompt， 输 入 “ildasm”( 不 含 引 号 ) 并 回 车 ， 可 以 方便 地 运行 
ildasm.exe。 第 2 章 会 介绍 如 何 打 开 这 种 特殊 的 命令 窗口 ， 以 及 从 命令 行 窗口 加 载 的 其 他 工具 。 


运行 这 个 工具 后 ， 打 开 File 一 Open 菜 单 命令 ， 选 择 一 个 想 浏 览 的 程序 集 。 图 1-7 显 示 了 前 面 所 
述 的 根据 Calc.cs 文 件 生成 的 名 为 Calc.exe 的 程序 集 ，ildasm.exe 使 用 我 们 熟悉 的 树 状 图 展示 程序 集 
的 结构 。 
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Pb ,cass private auto ans! beforefieldinX 
图 .ctor : void0 
二 Add : nt32(int32,int32) 


Ss 办 CalculstorExample.Program 
Pb ,dass private auto ansi beforefieldinit 











图 1-7 通过 ildasm.exe 可 以 查看 .NET 程 序 集中 的 CIL 人 代码、 清单 和 元 数据 
1.9.1 查看 CIL 代码 


除了 显示 指定 程序 集中 包含 的 命名 空间 、 类 型 和 成 员外 ，ildasm.exe 还 可 以 查看 指定 成 员 的 CIL 指 
令 。 例 如 ， 双 击 Program 类 的 Main() 方 法 ， 将 弹出 一 个 窗口 显示 底层 CIL 代 码 ( 见 图 1-8 )。 


太 Caiculerortxemele Program-Mein vod0 .= 


Fnd ”Fnd Ne 
-method private hidebysig static void Main() cil nanaged 
《 





;nop 

: nevobj instance void CalculatorExanple.Calc::.ctor() 

: stloc,g 

: ldioc.n 

: lgc.in.s 18 

3 ldc.in.s ga 

: callvirt finstance int32 CalculatorExanple.Calc::Add(int32, 
int32) 

3 stloc.1 

» "0+ gh is £0)."” 


[nscorlib]Systen. Int32 
void [mscorlib]Systen.Console: :WiteLine(string, 
object) 





ominn Fmrenvithicnrsnm Pnarniar On tnnt 


图 1-8 查看 底层 CIL 


1.9.2 ”查看 类 型 元 数据 


如 果 想 查看 当前 加 载 的 程序 集 的 类 型 元 数据 ， 按 CtrI+M 组 合 键 。 图 1-9 显 示 了 Calc.Add() 方 法 的 元 
数据 。 





: Calc.exe 
: 《EpA65389-1878-ADs1-9998-9DEEDCDSCDF7》 


TypbefHane: CalculatorExanple.Progran (Q2 
Flags : 


000002) 
: [NotPublic] [putoLayout] [Class] [hnsiclass] [BeforeField 
Extends :04 TypeRe 


Method #1 【06999991) [EMTRYPOIMT] 


f]】 Systemn-gbject 
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1.9.3 ”查看 程序 集 元 数据 〈 即 清单 ) 
最 后 ， 如 果 想 查看 程序 集 清单 的 内 容 ， 只 需 双击 MANIFEST 图 标 ( 如 图 1-10 所 示 )。 


pF MANIFEST 
[Find FndNet 
// Metadata version: uvh.0.38319 
-assenmbly extern mscorlib 











| -publickeytoken = (B87 7A SC 56 19 34 EQ 89 ) 
| -ver 4:8:8:8 


|-assembly Calc 


-Custom instance void [mscorlib]Systen.Runtime.CompilerServices.Compilati | 
-Custom instance void [mscorlib]Systenm.Runtime .CompilerServices.RuntimeCo 





| -hash algorithm Gx8098808» | 
-ver 06:89:80:0 | 
| 





图 1-10 通过 ildasm.exe 查 看 清单 数据 
当然 ，ildasm.exe 还 有 更 多 的 选项 ， 我 将 在 适当 的 地 方 举例 说 明 这 个 工具 的 其 他 功能 。 


1.10 .NET 的 平台 无 关 性 


接 下 来 简单 说 一 下 .NET 平 台 的 平台 无 关 性 。 令 许多 程序 员 惊 讶 的 是 ，.NET 程 序 集 可 以 在 非 微 软 
操作 系统 [如 Mac OS 义 、 各 种 版 本 的 Linux、Solaris, 以 及 iOS 和 Android 移 动 设备 ( 通过 Mono Touch API ) 
上 开发 和 执行 。 要 理解 它 是 怎么 做 到 的 ， 需 要 掌握 .NET 领 域 中 的 另外 一 个 缩写 词 CLI ( Common 
Language Infrastructure， 公 共 语 言 基 础 设施 )。 

当 微 软 发 布 C# 语 言 和 .NET 平 台 时 ， 也 发 布 了 一 整套 正式 的 文档 来 说 明 C# 和 CIL 语 言 的 语法 及 语 
义 、.NET 程 序 集 格式 、 核 心 .NET 命 名 空间 以 及 假定 的 .NET 运 行 时 引擎 的 结构 ( 叫做 虚拟 执行 系统 ， 
即 VES )。 

让 我 们 高 兴 的 是 ， 这 些 文档 已 经 提交 到 ECMA ， 并 被 ECMA 批 准 成 为 官方 的 国际 标准 
( http://www.ecma-international.org )。 我 们 感 兴趣 的 规范 主要 是 : 

口 ECMA-334，C# 语 言 规 范 ; 

口 ECMA-335， 公 共 语 言 基础 设施 ( CLI )。 

它们 可 以 使 第 三 方 组 织 在 各 种 操作 系统 和 处 理 器 上 构造 不 同 的 .NET 平 台 发 行 版 ， 理 解 了 这 一 点 ， 
这 些 文档 的 重要 性 就 显而易见 了 。ECMA-335 也 许 是 这 两 个 规范 中 更 “有 内 容 ” 的 一 个 ， 它 分 为 六 部 
分 ， 如 表 1-4 所 示 。 

表 1-4 ”CLI 的 各 个 部 分 


ECMA-335 的 各 个 部 分 党 义 
部 分 I: 概念 架构 描述 了 整个 CLI 的 架构 ， 包 括 CTS 和 CLS 的 规则 以 及 .NET 运 行 时 引擎 的 机 制 
部 分 [[: 元 数据 的 定义 和 语义 描述 了 .NET 元 数据 和 程序 集 格式 的 细节 
部 分 II: CIL 指 令 集 描述 了 CIL 代 码 的 语法 和 语义 
部 分 IV: 配置 文件 和 库 在 较 高 层次 概述 了 必须 由 .NET 发 行 版 支持 的 最 少 的 和 最 完整 的 类 库 
部 分 V: 调试 交换 格式 描述 了 CLI 生 产 商 和 消费 者 之 间 交 换 调试 信息 的 标准 方式 


部 分 VI: 附录 其 他 内 容 ， 如 关于 类 库 设计 指南 和 CIL 编 译 器 实现 的 细节 
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需要 注意 , 部 分 IV ( 配置 文件 和 库 ) 仅仅 定义 了 最 基本 的 命名 空间 集 , 这 些 命 名 空间 表示 一 个 CIL 
发 行 版 应 有 的 核心 服务 ( 如 集合 、 控 制 台 1/O、 文 件 L/O、 线程 、 反 射 、 网 络 访问 、 核 心安 全 需求 、XML 
数据 处 理 等 )。CLI 没 有 定义 用 于 Web 开 发 (ASPNET )、 数 据 库 访问 ( ADO.NET ) 或 桌面 图 形 用 户 界 
面 (GUI) 应 用 开发 ( Windows Forms/WPF ) 的 命名 空间 。 

令 人 高 兴 的 是 ， 为 了 提供 具有 完整 功能 的 、 产 品级 的 开发 平台 ， 主 流 的 .NET 分 发 版 都 扩展 了 CLI 
库 ， 加 入 了 与 微软 ASPNET、ADO.NET 和 Windows Forms 兼 容 的 等 效 功能 。 目 前 ，CLI 实 现 有 两 个 主 
要 的 流派 (除了 微软 提供 的 针对 Windows 的 实现 之 外 )。 虽 然 本 书 专注 于 使 用 微软 .NET 编写 .NET 应 用 
程序 ， 但 表 1-5 也 提供 了 Mono 和 Portable.NET 项 目的 相关 信息 。 


表 1-5 ”开源 .NET 分 发 版 


发 行 版 作 用 
www.mono-project.com Mono 项 目 是 一 个 CLI 的 开源 分 发 版 ， 针 对 各 种 Linux 分 发 版 ( 如 SUSE、Fedora 等 ) 


以 及 Windows 和 Mac OS X /iOS 设 备 ( iPad、iPhone ) 设备 


www.dotgnu.org Portable.NET 是 男 外 一 个 CLI 的 开源 分 发 版 ， 运 行 在 很 多 操作 系统 上。Portable.NET 
的 目的 是 在 尽 可 能 多 的 操作 系统 上 运行 ( 如 Windows、AIX、Mac OS X、Solaris， 
以 及 所 有 主要 的 Linux 发 行 版 本 ) 


Mono 和 Portable.NET 都 提供 符合 ECMA 标 准 的 C# 编 译 器 、NET 运 行 时 引擎 、 代 码 示 例 、 说 明文 档 
和 许多 与 微软 的 .NET Framework 4.5 SDK 功 能 相当 的 开发 工具 。 


说 明 附录 A 介 绍 了 如 何 使 用 Mono 创 建 跨 平台 的 .NET 应 用 程序 。 


1.11 Windows 8 应 用 程序 简介 


本 章 最 后 将 简 述 微软 Windows 8 操作 系统 推出 的 全 新 技术 与 .NET 平 台 有 何 关联 。 如 果 你 还 没 时 间 
探索 Windows 8， 我 只 想 告 诉 你 ,全 新 的 用 户 界面 与 之 前 所 有 的 微软 Windows 版 本 都 不 相同 ( 事实 
上 , 我 想 说 的 是 , 对 于 还 有 印象 的 老 用 户 来 说 , 这 次 变革 就 像 Windows 3.11 到 Windows 95 那 次 一 样 大 )。 
图 1-11 展 示 了 Windows 8 操作 系统 全 新 的 开始 界面 。 

如 图 1-11 所 示 ，Windows 8 开始 界面 支持 平 铺 布局 ， 每 个 方块 都 表示 机 器 上 安装 的 一 个 应 用 程序 。 
与 典型 的 Windows 桌 面 应 用 不 同 ，Windows 8 应 用 程序 专 为 触摸 屏 交 互 而 构建 。 它 们 还 都 以 全 屏 运行 ， 
没有 平常 在 很 多 桌面 应 用 中 都 有 的 那些 “金属 块 ”( 如 菜单 系统 、 状 态 条 、 工 具 条 按钮 )。 图 1-12 展 示 
了 一 个 Windows 8 天 气 应 用 的 部 分 视图 。 


说 明 构建 Windows 8 应 用 程序 要 求 开发 者 遵循 一 套 全 新 的 UI 设计 原则 、 数 据 存储 方法 和 用 户 输 入 选 
项 。 没 错 ， 一 个 “Win8” 应 用 远 不 止 一 个 开始 界面 上 的 方块 那么 简单 。 








图 1-11 Windows 8 开始 界面 


HOURLY FORECAST 


富生 





图 1-12 ”Windows 8 应 用 是 全 屏 的 、 富 图 形 化 的 桌面 应 用 


1.11.1 构建 Windows 8 应 用 程序 


创建 和 运行 Windows 8 应 用 程序 只 能 在 Windows 8 上 ， 而 不 能 在 Windows 7 上 。 实 际 上 ， 如 果 在 
Windows 7 ( 或 更 早 的 版 本 ) 上 安装 Visual Studio， 在 New Project 对 话 框 中 根本 就 看 不 到 Windows 8 项 
目 模 板 。 

编写 Windows 8 应 用 程序 要 求 开发 者 深入 了 解 一 个 全 新 的 运行 库 层 一 一 Windows Runtime ( WinRT )。 
要 清楚 的 是 , WinRT 不 是 .NET CLR, 尽管 它 提供 了 一 些 相似 的 服务 , 如 垃圾 收集 、 多 编程 语言 支持 ( 包 
括 C# ) 等 。 
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此 外 , 这 些 应 用 程序 使 用 全 新 的 命名 空间 创建 , 所 有 这 些 命 名 空间 都 以 根 名 Windows 开 头 。 图 1-13 
在 Visual Studio 对 象 浏览 器 中 展示 了 不 同 的 WinRT 命 名 空间 。 


Boe MW soton ee 
oh : 二 2 
4 - 


b {} Windows.ApplicationModel 

{} Windows.ApplicationModel.Activation 

{} Windovws.ApplicationModel,Background 

{) Windows.ApplicationModel,.Contacts 

{} Windows.ApplicationModei.Contacts.Provider 
(} Windows.ApplicationModel.Core 

{} Windows.ApplicationModei.DataTransfer 

{} Windows,ApplicationModel.DataTransfer,Sharel 


~ 


上 

上 

上 

上 

上 

b () WindovwsApplicationModei.Resources 
b {) WindowsApplicationModel Resources,Core 
bp {} WindowsApplicationMoadel.Search 
b {} Windows.ApplicationModel.Store 
b.{} Windows.Data.Htmi 

b {) Windows.Datajson 

bp {} Windows.Data.Xmil.Dom 

b {} Windovws.Data.Xri.Xs! 

b {} Windows.Devices.Enumeration 

bp 0 Windows.Devices.Enumeration.Pnp 

b {} Windows.Devices.Geolocatior 

bp {) Windows.Devices,Input 

Db {} WindowsDevices,Portable 本 


Assembly Windows 
CAprogram Files (x85)\Windows Kits\8.0 
\Windows Metadata\Windows.winmd 


< 十 » 


图 1-13 ”Windows.* 命 名 空间 只 能 用 于 构建 Windows 8 应 用 程序 


幸运 的 是 ，Windows.* 命 名 空间 提供 的 功能 反应 了 很 多 .NET 基 类 库 的 API,。 实际 上 ， 从 编程 的 视角 
来 看 ， 为 WinRT 构 建 应 用 程序 与 为 CLR 构 建 .NET 应 用 程序 十 分 类 似 。 例 如 ，Windows 8 应 用 程序 可 用 
C# (以 及 Visual Basic 、JavaScript 或 C++ ) 构建 。 

并 且 , 很 多 Windows.* 命 名 空间 提供 的 功能 与 .NET 基 础 类 库 中 的 相似 。 例如， 本 书后 面 (参见 第 
27 章 至 第 31 章 ) 将 介绍 的 一 项 .NET 技 术 WPF。 届 时 你 将 学 习 一 种 基于 XML 的 语言 XAML。 当 你 开 
始 探索 Windows 8 应 用 程序 的 时 候 ， 你 会 很 高 兴 地 发 现 ， 它 们 也 是 用 XAML 构 建 的 (或 者 如 果 你 选 
择 的 语言 是 JavaScript， 将 使 用 HTML5 )， 并 且 和 在 .NET 平 台 构 建 的 WPF 程 序 具 有 十 分 相似 的 编程 
模型 。 


1.11.2” .NET 在 Windows 8 中 的 作用 


除了 Windows .* 命 名 空间 ，Windows 8 应 用 程序 还 能 使 用 大 量 .NET 平 台 的 子 集 。 总 的 来 说 , Windows 8 
应 用 能 使 用 的 .NET API 支 持 泛 型 集合 、LINQ、XMIL 文 档 处 理 、1/O 服 务 、 安 全 服务 以 及 本 书 将 要 介绍 
的 其 他 特性 。 这 当然 是 一 件 好 事 ， 因 为 本 书 介绍 的 很 多 话题 可 以 直接 映射 到 Windows 8 应 用 程序 的 构 
造 上 。 

还 要 注意 的 是 , 尽管 在 Windows 8 下 默认 显示 的 不 是 经 典 的 Windows 桌 面 , 但 你 仍然 可 以 通过 点 击 
Desktop 方 块 或 简单 地 按 下 键盘 上 的 Windows 键 来 访问 。 一 旦 打开 ， 操 作 系统 将 显示 与 Windows 7 桌面 
看 上 去 完全 相同 的 桌面 ( 如 图 1-14 所 示 )。 
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总 了 
Application3 - Microsoft Visual shudio 11 Express Betafor Windows8 0 
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图 1-14 ”Windows 8 桌面 允许 运行 非 Windows 8 应 用 


在 这 里 ， 你 可 以 运行 所 有 期 望 的 桌面 应 用 , 包括 Visual Studio、Word、Excel、Photoshop 等 。 同样， 
如 果 在 Windows 8 下 构建 .NET 应 用 程序 ， 将 运行 在 Windows 8 桌面 环境 中 。 

因此 简单 地 说 , 微软 ,NET 平台 在 Windows 8 下 照样 可 以 使 用 , 而 且 将 是 你 开发 工作 中 的 重要 部 分 。 
只 要 记 住 ，.NET 本 身 并 不 是 用 来 构建 Windows 8 应 用 程序 的 。 相 反 ， 你 需要 使 用 新 库 ( Windows.* )、 
新 运行 库 ( WinRT ) 和 .NET 子 集 ( .NETAPI ) 来 创建 这 样 的 程序 。 

本 书 不 会 探讨 使 用 WinRT 构 建 Windows 8 应 用 程序 的 过 程 ， 而 是 会 专注 于 .NET 平 台 。 尽 管 如 此 ， 
要 记 住 ， 本 书 介绍 的 大 多 数 话题 都 会 为 你 以 后 探索 Windows 8 应 用 开发 做 好 充分 的 准备 ， 你 应 该 会 有 
这 个 需求 。 


1.12 小结 


本 章 的 目的 在 于 为 本 书 其 余部 分 建立 起 一 个 概念 性 的 框架 , 由 .NET 之 前 各 种 技术 的 局 限 性 和 复杂 
性 谈 起 ， 然 后 综述 了 .NET 和 C# 是 如 何 给 出 简化 解决 方案 的 。 

.NET 本 质 上 就 是 一 个 运行 库 执行 引擎 ( mscoree.dll ) 和 基础 类 库 ( mscorlib.dll 等 )。CLR 可 以 承载 
任何 符合 托管 代码 规则 的 .NET 二 进 制 文件 ( 又 称 程序 集 )。 而 程序 集中 有 很 多 CIL 指 令 ( 以 及 类 型 元 数 
据 和 程序 集 清单 ), 这些 指令 通过 即时 编译 器 编译 为 特定 平台 的 指令 。 另 外 , 本 章 还 讲述 了 CLS 和 CTS 
的 作用 。 

接 下 来 我 们 介绍 了 ildasm.exe 和 reflectorexe 对 象 浏览 工具 的 功能 , 以 及 怎样 使 用 完整 的 客户 配置 文 
件 来 配置 计算 机 , 使 之 可 以 运行 .NET 应 用 程序 。 最 后 简要 说 明了 C# 和 .NET 的 平台 无 关 性 ( 附录 A 会 深 
入 探讨 这 个 主题 )， 以 及 .NET 平 台 在 Windows 8 操作 系统 中 是 如 何 定位 的 。 
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作 :” 一 名 C# 程 序 员 , 构建 NET 应 用 程序 有 许多 工具 可 以 选择 。 本 章 将 介绍 各 种 .NET 开 发 工具 ， 
其 中 当然 包括 Visual Studio。 本 章 先 探讨 如 何 使 用 C# 命 令 行 编译 器 csc.exe、 微 软 Windows 操 
作 系 统 上 最 简单 的 文本 编辑 器 一 一 记事 本 ( Notepad ) 应 用 程序 以 及 可 以 免费 下 载 的 Notepad++。 

虽然 在 阅读 本 书 的 过 程 中 可 以 只 使 用 csc.exe 和 基本 的 文本 编辑 器 ,我 相信 你 肯定 会 对 使 用 具有 让 
富 功能 的 IDE 感 兴趣 。 为 此 ， 本 书 也 会 介绍 名 为 SharpDevelop 的 免费 的 开源 IDE。 这 种 IDE 可 与 许多 商 
用 的 .NET 开 发 环境 相 媲美 。 接 下 来 简单 介绍 Visual C# Express IDE ( 这 也 是 免费 的 )， 然 后 我 们 将 把 注 
意 力 转向 Visual Studio Professional 的 主要 功能 。 


说 明 ”本章 有 大 量 的 C# 语 法 ， 之 前 我 们 还 未 正式 讨论 过 。 如 果 对 语法 不 熟悉 ， 不 用 烦恼 ， 因 为 第 3 章 
会 正式 探讨 C# 语 言 喜 o 





2.1 .NET Framework 4.5 SDK 的 作用 


有 关 .NET 开 发 常见 的 一 个 误解 就 是 ， 程 序 员 必须 购买 Visual Studio 才 能 构建 C# 应 用 程序 。 事 实 
上 , 使 用 可 免费 下 载 的 .NET Framework 4.5 Software Development Kit (SDK) 就 可 以 构建 任何 形式 的 .NET 
程序 。 

SDK 提 供 了 很 多 托管 的 编译 器 、 命 令 行 工 具 、 示 例 代 码 、.NET 类 库 以 及 完整 的 文档 系统 。 如 果 使 
用 Visual Studio 或 Visual C# Express， 就 没有 必要 手动 安装 .NET Framework 4.5 SDK。 当 我 们 安装 其 中 
任 一 产品 的 时 候 ， 都 会 自动 安装 SDK， 所 有 的 东西 都 是 现成 的 。 然 而 ， 如 果 你 不 准备 使 用 微软 IDE 来 
学 习 本 书 的 话 ， 请 务必 在 继续 之 前 安装 SDK。 


说 明 .NET Framework 4.5 SDK 安 装 程序 ( dotNetFx45 Full x86 x64.exe ) 可 以 从 .NET 网 站 下 载 
( http://msdn.microsoft.com/netframework )。 


开发 者 命令 提示 符 


如 果 安 装 .NET Framework 4.5 SDK 、Visual Studio 或 Visual C# Express， 最 后 会 在 本 地 硬盘 上 多 出 
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很 多 新 的 目录 , 每 一 个 目录 都 包含 各 种 .NET 开 发 工具 。 其 中 很 多 工具 都 需要 从 命令 提示 符 打 开 , 因此 ， 
如 果 和 希望 在 任何 Windows 命 令 窗口 中 使 用 这 些 工具 ， 就 需要 为 操作 系统 注册 路 径 。 

虽然 你 可 以 手动 更 新 PATH 变 量 ， 不 过 也 可 以 使 用 Start 一 All Programs 一 Microsoft Visual Studio 11 一 
Visual Studio Tools 文 件 夹 的 Developer Command Prompt 来 节省 你 的 时 间 ( 如 图 2-1 所 示 )。 








图 2-1 The Developer Command Prompt 


使 用 特定 的 命令 提示 符 的 好 处 在 于 它 已 经 预 配置 了 每 一 个 .NET 开 发 工具 。 如 果 已 经 安装 了 .NET 
开发 环境 ， 只 需 输入 如 下 命令 然后 按 Enter 键 : 

CSC -? 

如 果 一 切 正常 的 话 ， 应 该 可 以 看 到 C# 命 令 行 编译 器 ( csc 代 表 C-sharp compiler ) 的 命令 行 参数 列 
表 。 如 你 所 见 ， 该 命令 行 编译 器 有 不 少 选 项 ; 但 实际 上 在 命令 行 提示 符 中 编写 C# 程 序 只 需要 其 中 几 个 
设置 。 


2.2 用 csc.exe 构建 C# 应 用 程序 


尽管 你 可 能 从 来 不 用 C# 命 令 行 编译 器 来 生成 大 型 的 应 用 程序 , 但 理解 如 何 亲手 编译 自己 的 代码 文 
件 的 基本 知识 还 是 很 重要 的 。 为 什么 应 该 掌握 这 一 过 程 呢 ? 以 下 是 几 个 原因 。 

口 最 显而易见 的 原因 是 一 个 简单 的 事实 : 你 可 能 没有 Visual Studio 或 者 另 一 个 图 形 化 IDE。 

口 你 可 能 在 大 学 里 ， 那 里 会 禁止 在 教室 里 使 用 代码 生成 工具 或 IDE。 

口 你 想 要 使 用 自动 的 构建 工具 , 如 msbuild.exe, 这 就 需要 你 了 解 你 正 使 用 的 工具 的 命令 行 选项 。 

口 你 想 要 加 深 对 C# 的 理解 。 使 用 图 形 化 IDE 来 构建 应 用 程序 时 , 最 终 是 在 指导 csc.exe 如 何 操纵 C# 

导入 文件 。 这 样 你 就 可 以 明了 在 后 台 到 底 发 生 了 什么 。 

使 用 原始 csc.exe 的 另 一 个 好 处 是 ， 你 将 更 熟悉 对 .NET Framework 4.5 SDK 所 包含 的 其 他 命令 行 工 
具 的 操作 。 在 阅读 本 书 的 过 程 中 你 会 发 现 , 一 些 重要 的 工具 只 能 够 通过 命令 行 方式 访问 ( 如 gacutil.exe、 
ngen.exe、 ilasm.exe 和 aspnet regiis.exe )。 

为 了 说 明 在 不 使 用 IDE 的 情况 下 如 何 构建 .NET 应 用 程序 , 我 们 使 用 C# 命 令 行 编译 器 和 记事 本 生成 
名 为 TestApp.exe 的 一 个 简单 的 可 执行 程序 集 。 首 先 ， 需 要 一 些 源 代码 。 打 开 记事 本 (通过 Start 一 All 
Programs 一 Accessories 菜 单 选项 ) 并 键入 以 下 内 容 : 


// 一 个 简单 的 C# 应 用 程序 
using System; 
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class TestApp 
static void Main() 
Console.WriteLine("Testing! 1, 2, 3"); 
) } 
完成 后 把 文件 以 TestApp.cs 的 名 字 保 存在 一 个 方便 的 地 方 (例如 CNCscExample ),。 现在 , 我 们 来 了 
解 C# 编 译 器 的 核心 选项 。 





说 明 根据 惯例 ,所 有 C# 代 码 的 文件 扩展 名 ud cso 文件 的 名 aid 需要 有 任何 指向 类 型 名 定义 的 映射 。 





2.2.1 指定 输入 输出 目标 


首先 要 明白 如 何 指定 要 创建 的 程序 集 的 名 字 和 类 型 ( 例如 ， 控 制 台 应 用 程序 命名 为 MyShell.exe、 
代码 库 命 名 为 MathLib.dll、WPF 应 用 程序 命名 为 Halo8.exe， 等 等 )。 可 以 通过 将 对 应 的 具体 标志 作为 
命令 行 参 数 传 人 csc.exe 来 选择 各 种 选项 ( 如 表 2-1 所 示 )。 


表 2-1 C# 编 译 器 的 输出 选项 





选 项 作 用 

/out 本 选项 用 于 指定 将 被 构建 的 程序 集 的 名 字 。 默 认 条 件 下 ， 程 序 集 的 名 字 与 最 初 输入 的 #.cs 文 件 名 
字 相 同 

/target:exe 本 选项 构建 一 个 可 执行 的 控制 台 应 用 程序 。 这 是 默认 的 程序 集 输出 类 型 ， 并 且 在 创建 该 应 用 程序 
类 型 时 可 被 忽略 

/target:1ibrary 本 选项 构建 一 个 文件 *.dll 程 序 集 

/target:winexe 尽管 使 用 /target:exe 选 项 也 能 创建 基于 GUI 的 应 用 程序 ， 但 本 选项 创建 的 程序 运行 时 不 会 有 
控制 窗口 出 现在 桌面 背景 上 





说 明 发 送 到 命令 行 编译 器 ( 以 及 其 他 大 多 数 命 令 行 工 具 ) 的 选项 可 以 以 短 横 线 (- ) 或 斜 线 (/ ) 为 


前 缓 








为 了 把 TestApp.cs 编 译 成 名 为 TestApp.exe 的 控制 台 应 用 程序 ， 使 用 cd ( change directory ) 命令 转 到 
包含 源 代 码 文件 的 目录 

cd C:\CscExample 

并 键入 以 下 命令 ( 注意 命令 行 标志 必须 位 于 导入 的 文件 名 字 前 面 ， 不 能 在 后 面 ): 


csc /target:exe TestApp.cs 


这 里 没有 明确 指定 /out 标 志 ， 因 而 如 果 TestApp 是 传人 文件 的 名 字 ， 可 执行 文件 将 被 命名 为 
TestApp.exe。 还 要 清楚 的 是 ， 大 多 数 C# 编 译 需 标志 支持 缩写 版 本 ， 例 如 可 以 用 /tt 代替 /target (程序 
员 可 以 在 命令 提示 符 下 键 人 csc -? 来 查看 所 有 的 缩写 ): 
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CSC /t:exe TestApp.cs 

而 且 ， 因 为 /t:exe 标 志 是 C# 编 译 器 的 默认 输出 ， 也 可 以 只 键入 下 面 的 命令 来 编译 TestApp.cs: 
csc TestApp.cs 

现在 TestApp.exe 可 以 从 命令 行 运行 了 ， 如 图 2-2 所 示 。 


Oeyeloper Gomand Poo 








C:\Program Files (x86)\Microsoft Visual Studio 11.0\WC>cd C:\CscExample Ta 
| 


c: \CscExample>csc /target:exe TestApp.cs 

Microsoft {R) Visua]l C# Compiler version 4.0.30319.17379 
for Microsoft (R) .NET Framework 4. 

Copyright (C) Microsoft Corporation. All rights reserved. 
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图 2-2 TestApp.exe 在 运行 


2.2.2 引用 外 部 程序 集 


接 下 来 , 看 一 下 如 何 编 译 一 个 应 用 程序 ， 如 果 它 采用 了 在 男 一 个 .NET 程 序 集 里 定义 的 类 型 。 说 到 
这 里 ， 如 果 你 想 知道 C# 编 译 器 是 如 何 理 解 对 于 System.Console 类 型 的 引用 的 ， 请 回忆 一 下 第 1 章 里 
mscorlib.dll 在 编译 过 程 期 间 是 如 何 被 自动 引用 的 ( 如 果 由 于 特别 的 原因 希望 禁用 这 个 功能 ， 可 以 指定 
csc.exe 的 /nostdlib 选 项 )。 
让 我 们 修改 TestApp 应 用 程序 ， 显示 一 个 Windows 窗 体 消息 框 。 打 开 TestApp.cs 文 件 并 做 如 下 修改 : 
using System; 


// 一 定 要 加 上 这 一 行 ， 
using System.Windows .Forms; 


class TestApp 
static void Main() 
Console.WritelLine("Testing! 1, 2, 3"); 


// 一 定 要 加 上 这 一 行 
MessageBox.Show("Hello..."); 
} 
} 


注意 , 对 System.Windows .Forms 命 名 空间 的 引用 是 通过 C#using 关 键 字 实 现 的 ( 对 该 关键 字 的 介绍 
见 第 1 章 )。 回 忆 一 下 ， 如 果 显 式 地 列 出 在 一 个 给 定 的 *.cs 文 件 里 所 用 到 的 命名 空间 ， 就 可 以 避免 采用 
完全 限定 名 ( 否则 你 会 累 到 手 抽筋 )。 

在 命令 行 中 ， 必 须 通 知 csc.exe， 哪 个 程序 集 包 含 了 “正在 使 用 的 ”命名 空间 。 假 定 你 已 经 使 用 了 
System.Windows .Forms .MessageBox 类 ,就 必须 使 用 /reference( 可 以 缩写 为 /r ) 标 志 指 定 System.Windows. 
Forms.dll 程 序 集 : 


2.2 ”用 csc.exe 构建 C# 应 用 程序 33 


csc /r:System.Windows.Forms.dll TestApp.cs 


如 果 现 在 再 次 运行 应 用 程序 ， 除 了 控制 台 输 出 以 外 ， 还 可 以 看 见 图 2-3 中 出 现 的 消息 框 。 


Ty 
画 Developer Command Prompt- Teshppere 。 


i Si 


C:\CscExample>csc /r:System.Windows.Forms.d]ll TestApp.cs 
Microsoft (R) Visual C# Compiler version 4.0.30319.17379 
for Microsoft CR) .NET Framework 

Copyright (C) Microsoft Corporation. Al11 rights reserved. 


C:\CscExample>TestApp.exe 
Testing! 1, 2, 3 





图 2-3 ”第 一 个 图 形 化 用 户 界 面 应 用 


2.2.3 引用 多 个 外 部 程序 集 


顺便 说 明 ， 如 果 需 要 csc.exe 引 用 大 量 的 外 部 程序 集 ， 会 怎样 呢 ? 仅 需 使 用 一 个 用 分 号 分 隔 的 列表 
列 出 各 个 程序 集 。 对 上 面 这 个 例子 不 需要 指定 多 个 外 部 程序 集 ， 但 我 们 还 是 给 出 一 个 示例 用 法 : 


CSC /r:System.Windows.Forms.dll;System.Drawing.dll] *.cs 


说 明 正如 本 章 稍 后 将 要 介绍 的 那样 ， 即 使 没有 使 用 /fr 标志 进行 指定 ，C# 编 译 器 也 将 自动 引用 一 
些 .NET 核 心 程序 集 ( 如 System.Windows.Forms.dll )。 


2.2.4 编译 多 个 源 文件 


TestApp.exe 应 用 程序 的 当前 版 本 是 用 单个 *.cs 源 代码 文件 创建 的 ,在 单个 *.cs 文 件 里 定义 所 有 .NET 
类 型 是 完全 允许 的 ， 然 而 大 多 数 项 目 由 多 个 *.cs 文 件 组 成 ， 以 使 代码 库 更 灵活 。 假 设 你 又 编写 了 一 个 
类 ， 包 含 在 名 为 HelloMsg.cs 的 新 文件 里 : 
// HelloMessage 类 
using System; 
using System.Windows.Forms; 
class HelloMessage 
public void Speak() 
\ MessageBox.Show("Hello..."); 


} 
现在 ,修改 初始 的 TestApp 类 以 使 用 这 种 新 的 类 类 型 ， 并 且 注 释 掉 以 前 的 Windows 窗 体 代码 : 


using System; 


// 不 再 需要 这 一 行 了 
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// using System.Windows.Forms; 
class TestApp 
static void Main() 
Console.WriteLine("Testing! 1, 2, 3"); 


// 也 不 再 需要 这 一 行 了 
// MessageBox.Show("Hello..."); 


// 使 用 HelloMessage 类 
HelloMessage h = new HelloMessage(); 
h.Speak(); 
} 
} 


可 以 通过 显 式 地 列 出 各 个 导入 文件 来 编译 C# 文 件 : 

csc /r:System.Windows.Forms.dll TestApp.cs HelloMsg.cs 

另外 ，C# 编 译 器 还 允许 使 用 通配符 (* ) 通知 csc.exe， 将 所 有 位 于 项 目 目录 里 的 *.cs 文 件 作为 当前 
构建 的 一 部 分 。 

csc /r:System.Windows.Forms.dll *.cs 

当 再 次 运行 程序 时 ， 输 出 与 前 面 的 代码 完全 相同 。 两 个 应 用 程序 的 唯一 差别 在 于 ， 当 前 代码 分 到 
了 多 个 文件 中 。 


2.2.5 ”使 用 C# 响 应 文件 


可 以 想象 ,如果 要 在 命令 提示 符 下 构建 一 个 复杂 的 C# 应 用 程序 , 那么 将 不 得 不 指定 大 量 的 输入 选 
项 以 通知 编译 器 如 何 处 理 源 代 码 。 为 了 减轻 录入 负担 ，C# 编 译 器 采用 了 响应 文件 (response file ) 。 

C# 咱 应 文件 包含 了 在 当前 程序 的 编译 期 间 要 用 到 的 所 有 指令 。 通 常 约定 , 这 些 文件 的 扩展 名 为 *rsp。 
假定 已 经 创建 了 一 个 包含 有 以 下 选项 的 名 为 TestApp.rsp 的 响应 文件 ( 可 以 看 到 ， 注 释 用 # 字 符 标 识 ): 

# 这 是 第 2 章 里 的 TestApp.exe 示 例 的 响应 文件 


# 外 部 程序 集 引用 
/r:System.Windows.Forms.dll 


# 用 于 编译 的 输出 和 文件 (采用 通配符 语法 ) 

/target:exe /out:TestApp.exe *.cs 

现在 , 假定 该 文件 与 将 被 编译 的 C# 源 代码 文件 保存 在 相同 的 目录 里 , 这 样 就 能 按照 以 下 步骤 构建 
完整 的 应 用 程序 了 ( 注意 采用 了 @ 符 号 ): 

csc @TestApp.rsp 

如 果 需 要 ， 也 可 以 指定 多 个 *.rsp 文 件 作为 输入 (例如 csc @FirstFile.rsp @SecondFile.rsp 
@ThirdFile.rsp )。 如 果 采 用 这 种 方式 ， 要 记 住 编译 器 会 根据 所 遇 到 的 命令 选项 做 相应 的 处 理 ! 因而 ， 
后 面 *.rsp 文 件 中 的 命令 行 参数 可 以 覆盖 前 一 个 响应 文件 的 选项 。 

还 要 注意 ， 在 响应 文件 前 的 命令 行 中 被 显 式 列 出 来 的 标志 将 被 指定 的 *.rsp 文 件 覆 盖 ， 因 此 ， 如 果 
键 和 人 : 
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csc /out:MyCoolApp.exe @TestApp.rsp 
假定 有 在 TestApp.rsp 响 应 文件 里 列 出 的 /out:TestApp.exe 标 志 ， 程 序 集 的 名 字 将 仍然 是 TestApp.exe 
而 非 MyCoolApp.exe。 但 是 ， 如 果 在 响应 文件 后 列 出 了 标志 ， 标 志 将 覆盖 响应 文件 里 的 设置 。 


说 明 /reference 标 志 具 有 累加 性 。 不 管 在 何 处 指定 了 外 部 程序 集 (之 前 、 之 后 或 是 在 响应 文件 内 )， 
最 终 的 结果 都 是 各 个 引用 程序 集 的 累加 之 和 。 


默认 的 响应 文件 (csc.rsp) 

关于 响应 文件 ， 最 后 要 说 明 一 点 ，C# 编 译 器 有 一 个 与 之 关联 的 默认 响应 文件 ( csc.rsp )， 该 默认 
响应 文件 与 csc.exe 同 处 在 一 个 目录 里 ( 默认 为 C:\Windows\Microsoft.NET\Framework\<version>， 其 中 
<version> 是 给 定 平台 的 版 本 号 )。 如 果 用 记事 本 打开 这 个 文件 , 将 发 现 无 数 的 .NET 程 序 集 已 经 使 用 /r: 
标志 被 指定 ,包括 Web 开 发 用 到 的 各 种 库 、LINQ 、 数 据 访问 和 其 他 的 核心 库 ( 除了 mscorlib.dll 以 外 )。 

当 用 csc.exe 构 建 C# 程 序 时 ， 即 使 你 提供 了 一 个 自 定义 的 *.rsp 文 件 ， 该 响应 文件 也 将 自动 被 引用 。 
假定 有 默认 的 响应 文件 存在 ， 当 前 的 TestApp.exe 应 用 程序 可 以 用 以 下 命令 集成 功 地 进行 编译 
(System.Windows.Forms.dl1 在 csc.rsp 内 被 引用 ): 

csc /out:TestApp.exe *.cs 


如 果 和 希望 取消 自动 读 取 csc.rsp， 可 以 指定 /noconfig 选 项 .: 
csc @TestApp.rsp /noconfig 


说 明 如 果 引 用 了 从 未 用 过 的 程序 集 ( 通过 /rf 选项 )， 它 们 将 会 被 编译 器 忽略 ， 因 此 ， 不 用 担心 “ 代 
码 膨 胀 ”。 


很 明显 ，C# 命 令 行 编译 器 还 有 很 多 其 他 选项 , 用 于 控制 如 何 产生 结果 .NET 程 序 集 。 你 将 在 本 书 相 
应 的 地 方 看 到 其 他 重要 的 特性 ， 但 更 详细 的 内 容 可 以 参阅 .NET Framework 4.5 SDK 文 档 。 


源 代 码 ”CscExample 应 用 程序 可 在 Chapter 2 子 目 录 中 找到 。 


2.3 使 用 Notepad++ 构 建 .NET 应 用 程序 


我 想 提 到 的 另 一 个 文本 编辑 器 是 开源 的 Notepad++ 应 用 程序 。 这 个 工具 可 以 从 http://notepad-plus. 
sourceforge.net 获 得 。 与 简单 的 Windows Notepad 程 序 不 同 ，Notepad++ 人 允许 编写 各 种 语言 的 代码 以 及 安 
装 各 种 插件 。 此 外 ，Notepad++ 还 提供 了 很 多 其 他 好 东西 ， 如 : 

口 对 C# 关 键 字 (包括 关键 字 颜 色 编码 ) 的 原生 支持 ; 

口 支持 语法 折 登 ， 即 允许 折 乔 和 展开 编辑 器 中 的 一 组 代码 行 ( 和 Visual Studio/C# Express 相 似 ); 

口 能 通过 Ctrl 键 和 鼠标 滚轮 放大 /缩小 文本 ; 

口 对 各 种 C# 关 键 字 以 及 .NET 命 名 空间 进行 可 配置 自动 完成 。 

有 关 最 后 一 点 ， 按 Ctrl+ 空 格 组 合 键 ， 会 激活 C# 的 自动 完成 支持 ( 如 图 2-4 所 示 )。 





36 第 2 章 构建 C# 应 用 程序 





(ew Boecks\ce Book\C# and ti the NET platform Siath Fd On progressCode\Chepter O\Cscin sample\TestAppes - Notepad” ~ ”| 
[oe Ed Search View Encoding language Settings Macre Run Plugins Window 了 


PT 


| 














Cs source fle tength : 362 tines: 并 Ln:2 Col:9 Sel’ 0 Dos\Windows NSI INS 汝 





图 2-4 ”使 用 Notepad++ 执 行 自动 完成 


说 明 ”自动 完成 窗口 内 显示 的 选项 列表 可 以 被 修改 或 者 扩展 。 只 需要 打开 C:\Program Files (x86)\ 
Notepad++\plugins\APIs\cs.xml 文 件 ， 编 辑 并 且 增 加 其 他 项 即 可 。 


除了 现在 介绍 的 内 容 外 ， 我 不 会 深入 介绍 Notepad++ 的 其 他 细节 。 如 果 你 需要 更 多 协助 的 话 ， 可 
以 选择 ?Help 菜 单 选项 。 


2.4 使 用 SharpDevelop 构建 .NET 应 用 程序 


使 用 Notepad++ 编 写 C# 代 码 相 对 于 Notepad 来 说 是 一 个 进步 。 然 而 ,这些 工 具 没 有 为 C# 人 代码、 构建 
图 形 用 户 界面 的 设计 人 员 、 项 目 模 板 或 数据 库 操 作 工 具 提供 丰富 的 智能 感知 能 力 。 为 了 满足 这 个 需求 ， 
本 节 将 介绍 下 一 个 .NET 开 发 的 选项 : SharpDevelop (也 叫 #Develop )。 

SharpDevelop 是 一 种 功能 丰富 的 开源 IDE， 通 过 它 可 以 用 C#、VB 、IronRuby、 IronPython、C++、 
F# 和 类 似 Python 的 .NET 语 言 Boo 来 构建 .NET 程 序 集 。 这 种 IDE 是 完全 免费 的 , 并 且 是 完全 用 C# 编 写 的 。 
实际 上 ， 你 可 以 下 载 并 手动 编译 *.cs 文 件 ， 或 运行 setup.exe 程 序 ， 从 而 在 开发 计算 机 上 安装 
SharpDevelop。 以 上 两 种 方式 在 网 址 http://www.sharpdevelop.com 处 都 可 以 找到 相应 的 下 载 文 件 。 

SharpDevelop 提 供 了 许多 提高 工作 效率 的 手段 。 下 面 是 其 主要 的 优点 : 

口 支持 多 种 .NET 语 言 、.NET 版 本 和 项 目 类 型 ，; 

口 具有 智能 感知 、 代 码 自 动 完成 和 插入 代码 段 的 能 力 ; 

口 具有 Add Reference 对 话 框 ， 用 于 引用 外 部 程序 集 ， 包 括 部 署 到 全 局 程序 集 缓存 的 程序 集 ; 

口 针对 桌面 和 Web 应 用 集成 的 GUI 设计 器 ; 

口 具有 一 个 集成 的 对 象 浏 览 和 代码 定义 的 工具 ; 

口 具有 可 视 的 数据 库 设计 器 工具 ; 

口 具有 使 C# 与 VB 代码 相互 转换 的 工具 。 

作为 免费 的 IDE， 这 已 经 很 出 色 了 ， 是 不 是 ? 本 章 不 可 能 详细 地 介绍 这 些 特 性 ， 我 们 来 讨论 其 中 
有 趣 的 几 个 。 


说 明 在 撰写 本 书 的 时 候 ，SharpDevelop 的 最 新 版 本 (4.2 ) 还 不 支持 C#/.NET 4.5 的 特性 。 请 检查 
SharpDevelop 网 站 检查 最 新 版 本 。 
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构建 简单 的 测试 项 目 
安装 了 SharpDevelop 之 后 ， 通 过 File 一 New 一 Solution 菜 单 选项 就 可 以 选择 待 生 成 的 项 目 类 型 
和 .NET 语 言 的 类 型 。 例 如 ， 假定 新 建 一 个 C# Windows 应 用 程序 MySDWinApp ( 如 图 2-5 所 示 )。 
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图 2-5 SharpDevelop 的 New Project 对 话 框 
和 Visual Studio 一 样 , 这 里 有 一 个 Windows Forms GUI 设 计 器 工具 箱 ( 用 来 把 控件 拖 放 到 设计 器 上 ) 
和 一 个 Properties 窗 口 ， 用 来 设置 每 个 UI 项 的 外 观 。 图 2-6 描 述 了 如 何 使 用 IDE 配 置 一 个 按钮 控件 ( 注意 
我 单 击 了 打开 的 代码 文件 底部 的 Design 标 签 )。 
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使 用 SharpDevelop 以 图 形 方式 设计 Windows Forms 应 用 程序 
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单 击 表单 设计 器 底部 的 Source 按 钮 , 将 会 发 现 期 望 的 智能 感知 、 代码 完成 以 及 集成 的 帮助 功能 ( 如 
图 2-7 所 示 )。 


MainForm.cs” 





Xx 
[Ss yspWinApr Melo auction 中.acusiaaisuisaaia aaa 
时 hs 日 public partial clsss MainForm : Form 
121 = public MainForm() 
? { 
The InitializeComponent() call is required for Windows Forms designer suppo 
InitializeComponent(); 


六 BackgroundimageChanged 
} BackgroundimageLayout 
$F BackgroundimageLayoutChanged 





图 2-7 SharpDevelop 文 持 许多 代码 生成 工具 


SharpDevelop 的 设计 在 很 多 功能 上 酷似 微软 的 .NET IDE (我 们 后 面 会 讨论 )。 因此 , 我 不 会 深入 探 
讨 这 个 开源 .NET IDE 的 所 有 特性 。 如 果 你 需要 了 解 更 多 信息 的 话 ， 请 使 用 Help 菜 单 。 


说 明 MonoDevelop 是 基于 Sharp Develop 代码 的 开源 IDE。MonoDevelop 是 .NET 程 序 员 使 用 Mono 平 
台 创 建 Mac OS X 或 Linux 操作 系统 应 用 程序 的 首选 IDE。 要 了 解 该 IDE 的 更 多 情况 请 访问 http:/ 


monodevelop.com/。 


2.5 使 用 Visual C# Express 构建 .NET 应 用 程序 


在 2004 年 夏天 , 微软 引入 了 一 系列 全 新 的 IDE, 它们 被 分 类 在 “Express” 产 品系 列 下 ( http://msdn. 
microsoft.com/express )。 目 前 ， 在 “Express” 产 品系 列 里 有 大 量 成 员 ( 它们 是 完全 免费 的 ， 并 且 被 微 
软 公 司 支 持 和 维护 )， 具 体 如 下 所 示 。 

口 Visual Web Developer Express: 一 个 用 于 通过 ASP.NET 构 建 动态 网 站 和 WCF 服 务 的 轻 量 级 工具 。 

口 Visual Basic Express: 一 种 非常 适合 程序 员 新 手 的 高 效 编程 工具 ， 可 以 采用 Visual Basic 这 种 易 


于 使 用 的 语法 构建 应 用 程序 。 
口 Visual C# Express 和 Visual C++ Express: 针对 选用 不 同 的 语法 学 习 计 算 机 科学 基础 知识 的 学 生 
和 爱好 者 的 几 种 IDE。 


口 SQL Server Express: 一 个 适用 于 业余 爱好 者 、 技 术 狂 热 者 和 学 生 程序 员 的 初级 数据 库 管理 
系统 。 
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Visual C# Express 的 独特 功能 


概括 地 说 , “Express” 产 品 是 同类 型 的 Visual Studio 产 品 的 简化 版 本 , 并 且 主 要 针对 .NET 业 余 爱 好 
者 和 学 生 。 像 SharpDevelop 一 样 ，Visual C# Express 配 备 了 各 种 对 象 浏 览 工具 、 桌 面 应 用 程序 GUI 设计 
器 、Add References 对 话 框 、 智 能 感知 能 力 以 及 代码 扩展 模板 。 

此 外 ，Visual C# Express 提 供 了 一 些 重 要 的 特性 ， 这 些 特 性 目前 在 SharpDevelop 里 还 没有 ， 包 括 : 

口 对 WPF XAML 应 用 程序 的 丰富 支持 ; 

口 下 载 一 些 免费 模板 的 功能 , 如 支持 Xbox 360 开 发 或 与 Twitter 集成 的 WPF 应 用 程序 的 模板 ,等 等 。 

由 于 Visual C# Express 的 外 观 界面 与 Visual Studio 非 常 相似 ( 并 且 在 某 种 程度 上 也 与 SharpDevelop 
相似 )， 在 这 里 就 不 对 这 个 具体 的 IDE 进 行 前 述 了 。 在 阅读 本 书 的 过 程 中 ， 可 以 随意 地 使 用 该 IDE， 但 
要 知道 Visual C# Express 不 支持 构建 ASPNET 网 站 的 项 目 模板 。 如 果 你 希望 构建 Web 应 用 程序 ， 同 样 可 
以 在 http://msdn.microsoft.com/express 上 下 载 Visual Web Developer。 


2.6 使 用 Visual Studio 构建 .NET 应 用 程序 


假如 你 是 一 位 职业 .NET 软 件 工程 师 ， 很 有 可 能 公司 会 购买 微软 最 重要 的 IDE 一 一 Visual Studio 
( http://msdn.microsoft.com/vstudio )。 这 个 工具 就 是 本 章 中 功能 最 丰富 、 适 用 于 企业 的 IDE。 当 然 , 一 
分 钱 一 分 货 ， 价 格 随 着 所 购买 的 Visual Studio 的 版 本 不 同 而 不 同 。 你 可 能 会 不 信 ， 但 是 各 个 版 本 都 具 
有 不 同 的 功能 。 








说 明 Visual Studio 家 族 中 有 数量 惊人 的 成 员 。 在 本 书 余下 的 部 分 中 ,我 假设 你 选择 了 Visual Studio 
Professional 作 为 IDE。 





假定 你 选中 的 是 Visual Studio Professional， 但 要 知道 ， 这 对 学 习 本 书 并 不 是 必需 的 。 在 最 坏 的 情 
况 下 ， 本 书 会 提 及 你 使 用 的 IDE ( 比如 Microsoft C# Express 或 SharpDevelop ) 不 支持 的 某 个 选项 。 不 过 
请 放心 ， 本 书 的 全 部 示例 代码 在 被 你 所 选用 的 工具 进行 处 理 时 都 可 以 正常 编译 。 





说 明 ”从 Apress 网 址 (http:/www.apress.com ) 的 Source Code/Downloads 区 域 下 载 了 本 书 的 源 代码 后 ， 
你 可 以 通过 双击 示例 的 *.sln 文 件 将 当前 示例 加 载 到 Visual Studio 或 C# Express 里 。 如 果 没 有 使 用 
Visual Studio 或 者 C# Express， 你 需要 手动 将 所 提供 的 *.cs 文 件 插入 到 IDE 的 项 目 工作 区 中 。 








2.6.1 Visual Studio 的 独特 功能 


Visual Studio 配 备 了 我 们 所 期 望 的 GUI 设计 器 、 代 码 段 支持 、 数 据 库 操作 工具 、 对 象 和 项 目 浏 览 工 
具 以 及 集成 的 帮助 系统 。 与 我 们 提 过 的 那些 IDE 不 同 ，Visual Studio 提 供 了 众多 的 附加 功能 。 下 面 是 其 
中 的 一 部 分 : 

口 Visual XML 编辑 髓 /设计 器 ; 

口 支持 Windows 移 动 设备 开发 ; 

口 支持 微软 Office 开 发 ; 
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口 支持 WWF 项 目的 设计 器 ; 

口 对 代码 重 构 的 集成 支持 ; 

口 可 视 类 设计 工具 。 

坦白 地 讲 ，Visual Studio 提 供 了 如 此 多 的 功能 ， 以 至 于 需要 一 整 本 书 来 完整 描述 IDE 的 各 个 方面 ， 
但 这 不 是 本 书 的 目标 。 然 而 ,我 将 在 后 面 几 页 中 给 出 Visual Studio 的 一 些 主要 功能 , 你 可 以 了 解 到 Visual 
Studio IDE 的 更 多 内 容 。 


说 明 ”如 果 你 使 用 过 微软 Visual Studio 旧 版 本 ， 会 很 快 注意 到 整个 外 观 和 感觉 与 以 前 大 不 一 样 。 如 果 你 
觉得 默认 的 “Dark” 主 题 太 瞳 ， 可 以 选择 Tools 一 Options 菜 单 ， 在 Environment-~General 部 分 选择 
Color Theme 下 拉 列 表 ， 将 主题 改 为 “Light"。 本 书 所 有 的 截屏 都 使 用 的 是 “Light” 主 题 。 


2.6.2 ”使 用 New Project 对 话 框 指向 .NET Framework 


使 用 File 一 New 一 Project 菜 单项 来 新 建 一 个 C# 控 制 台 应 用 程序 YsExample。 如 图 2-8 所 示 ，Visual 
Studio 文 持 选择 你 希望 构建 的 .NET Framework 的 版 本 (2.0、3.0、3.5、4.0 和 4.5 )， 可 以 使 用 New Project 
对 话 框 顶部 中 心 位 置 的 下 拉 列 表 来 选择 。 对 于 本 书 中 的 任何 项 目 ， 你 都 可 以 使 用 默认 的 .NET 
Framework 4.5 选 项 。 
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图 2-8 ”Visual Studio 允 许 我 们 指定 某 个 版 本 的 .NET Framework 


2.6.3 解决 方案 资源 管理 器 


解决 方案 资源 管理 器 工具 可 以 从 View 菜 单 得 到 , 它 可 以 用 来 查看 构成 当前 项 目的 所 有 文件 和 被 引 
用 的 程序 集 的 集合 ( 如 图 2-9 所 示 )。 此 外 ， 可 以 打开 给 定 文件 ( 比如 Program.cs )， 查 看 当前 文件 定义 
的 代码 类 型 后面， 必要 时 我 还 会 指出 解决 方案 资源 管理 器 的 其 他 实用 特性 ,但 是 你 自己 可 以 随意 查 
看 各 个 选项 ， 看 看 它们 各 有 什么 作用 。 

注意 ， 解 决 方 案 资 源 管理 器 的 References 文 件 夹 显 示 了 每 一 个 你 已 经 引用 的 程序 集 ， 根 据 你 的 项 
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目 类 型 以 及 你 编译 针对 的 框架 版 本 ， 程 序 集会 有 所 不 同 。 因 为 已 经 创建 了 一 个 Console Application， 你 
会 发 现 此 处 自动 包含 了 一 组 必需 的 库 〈 比 如 System.dll、System.Core.dll、System.Data.dll1) 。 


4DLUTICR EXPLORE 


Al: 


t 
{ 
E 


Seurch Solution xpivrer (Cris)) 
加 Solution YsExample’ (1 project} 
4 VsExample 
4 tm Properties 
b €s Assemblyinfocs 
4 i References 
"Microsoft.CSharp 
System 
ws System,Core 
Systerm Data 
System.Data. DataSetfxtensions 
"System. Xmi 
ws sytem Xm Ling 
BD App,config 
2 Rogrme ~ 
4 由 program 
@ Maintstringl)]): void 
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图 2-9 解决 方案 资源 管理 器 





说 明 还 记得 第 1 章 我 们 创建 的 第 一 个 .NET 库 是 mxcprlib.dll 吗 ?这 个 库 没有 显示 在 解决 方案 资源 管 
理 器 中 ,但 是 你 可 以 使 用 其 中 包含 的 所 有 类 型 。 





1. 引用 外 部 程序 集 

当 需 要 引用 其 他 程序 集 时 ， 碳 击 References 文 件 夹 并 且 选 择 Add Reference。 然 后 ， 你 就 可 以 从 结 
果 对 话 框 中 选择 程序 集 了 ( 本 质 上 这 是 Visual Studio 指 定 了 命令 行 编译 器 的 /reference 选 项 ), Framework 
i tg eh bie t ip 
任何 .NET 程 序 集 。 同样 , Recent 标签 也 很 有 用 , 它 会 保留 几 个 你 在 其 他 项 目 中 经 常用 到 的 引用 程序 集 。 


EE 





Es Manager ~ VEample 








(2 Ascemblies Targeting! NET Framework #5 Seasch Aovermisiie 万 - 
Framework Name Versian 入 和 
Extensions System,Web,DynamicData.Design 4.000 System.Windows,Forms 
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| System Windows.Controls.Ribben 4000 
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| System.Windows, Forms.Datayisualizaticn 4000 
| System Windows.Forms DateVisuatization,Desi ,. 4000 
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System Windows,Presentation 40.008 | 
: System WortkflowActivities 4.080 
| System. Wotkflow,Componenthodel 4000 
System Wordiow Runtme #4000 
System.WorktlowSennices 4.080 
System.Xaml 4000 
pt System Xml 4000 
区 Systemrn.Xrmitinq #4095 

















图 2- 10 Add NI 





42 第 2 章 构建 C# 应 用 程序 


我 们 来 简单 测试 一 下 。 在 Fremework 项 中 找到 System.Windows.Forms.dl] 程 序 集 ， 选 中 相关 的 复 选 
框 , 关闭 对 话 框 后 会 在 Solution Explorer 的 References 文 件 夹 中 看 到 该 库 。 在 Solution Explorer 中 选中 该 程 
序 集 ， 按 下 键盘 上 的 Delete 键 ( 或 鼠标 右键 选择 Delete 菜 单项 )， 可 以 删除 该 引用 。 

2. 查看 Project Properties 

最 后 ， 注 意 在 解决 方案 资源 管理 器 内 有 一 个 名 为 Properties 的 图 标 。 当 你 双击 该 图 标 时 ， 会 呈现 一 
个 增强 的 项 目 配置 编辑 器 ( 如 图 2-11 所 示 )。 

















VsExample” 冯 关 Cs "| or 

Appficatio 
Build 
Build Events Assembly name _ Defauk namespace: 
Debug ample ViBemple 
Resources Target frameworic Output type: _ _ 
Services [NET Framework45 了 ] [Console Application -| 
Settings Startup object 

ad ea i 
Reference Paths [eet set) a i 到 E Assembiy Information... 和 
Signing 
Seaiily Resources 

Specify how application resources will be managed: 

Publish 
Code Analysis ® lcon and manifest 


A manifest determines Specific settings for an application. To embed a custom manifest, first add & to 
your project and then select tfrom the fist beiow- 

jccr 

{Default lcon} v 四 加 可 
Manifest 


图 2-11 Project Properties 窗 口 


后 面 在 其 他 内 容 的 讲述 中 你 将 看 见 Project Properties 窗 口 的 各 个 方面 。 但 是 , 只 需 花 点 时 间 研 究 一 
下 ， 就 会 明白 在 这 个 窗口 可 以 建立 各 种 安全 设置 、 强 命名 程序 集 ( 参见 第 14 章 )、 部 署 应 用 程序 、 插 
入 应 用 程序 资源 并 对 预先 和 事后 构建 的 事件 进行 配置 。 


2.6.4 Class View 工 具 


下 一 个 要 讨论 的 工具 是 Class View 工 具 ， 可 以 在 View 菜 单 下 使 用 该 功能 。 该 工具 的 目的 是 从 面向 
对 象 角度 ( 而 不 是 从 解决 方案 资源 管理 器 的 基于 文件 的 角度 ) 显示 当前 项 目 里 的 所 有 类 型 。 顶 部 的 窗 
格 显 示 了 一 组 命名 空间 及 其 类 型 的 集合 ,而 底部 的 窗 格 显示 了 当前 所 选择 的 类 型 的 各 个 成 员 ( 如 图 2-12 
所 示 )。 

当 你 在 Class View 工 具 中 双击 类 型 或 类 型 成 员 时 ，Visual Studio 将 自动 打开 正确 的 C# 代 码 文件 ,并 
将 鼠标 光标 定位 到 正确 的 地 方 。Visual Studio 的 Class View 工 具 还 有 一 个 非常 好 的 特性 ， 那 就 是 你 可 以 
打开 任何 被 引用 的 程序 集 ， 查 看 它 包 含 的 命名 空间 、 类 型 和 成 员 。 
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4 四 Project References 
b sy Microsc 人 CSharp 
> ss mscorib 
> Systerry 
Db wy System,Core 
Db sa System.Data 
b sa System.Data.DataSetExtensions 





b wa Systerm.Xmi 
Db ry System.Xml.Ling 
4 {} WExampie 
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图 2-12 ”Class View 工 具 


2.6.5 Object Browser 工 具 


Visual Studio 也 提供 了 一 个 工具 ， 用 于 检查 在 当前 项 〖 目 内 被 引用 的 程序 集 。 通 过 View 菜 单 启动 
Object Browser， 然 后 选择 希望 检查 的 程序 集 ( 如 图 2-13 所 示 )。 


Object Browser © xX 








Browse: My Solution 
<Search> 
4 * mscorb 四 好 AddfTKey TYalue 2 
bp {} Microsoft,Win32 3 © char0 / 
bp {} Microsoft Win32.SafeHandies El @ ContinsKey(TKey) { : 
pb €)} System 1 ® ComainsValue(TYaluey | 
by {} System.Colections 人 ,DictionarylSystem Runtme Serialization.Serializationinte, System.Runtime.Serial 
by {) SystenColiections.Concurrent @ Dictonary(System,Collections.Generic Dictionary« TKey, TVslue>, System.Collec 
4 {} System.Collections Generic @ Dictionary{System,Coliections.GeneriC IDKtionary< TKey, TValye>} 
b % Comparer<T> ® Dicyonaryfint, System.Collections.Generic EqualtyComparer< TKey>} 
bp % Bm @ CitionarylSystem.Coliections.Generic.lEqualityComparerc TKey>} 
bp me Dictionery< TKey, TValue> .Enumerator Wm Pirfipnnarvlintlj. i 
bp ts Dictionary< TKey, TValue> KeyCotiection 1 ae 2 td oem a 


b SS Dictionary< TKey, TVyaiue> .KeyCollection Enumerator pubic ciass Dictionary<TKey, TValue> 

b Ws Dictionary< TKey, TValue> ValueColection Member of System.Collections.Generic 
b SS Dictionary<TKey,TValue> .ValueColection, Enumerator 

b ts EqusityComparers T> 


bo Colection<T> Represents a Collection of keys and values. 
b 0 iComparervin T> 
F wo iDictionary TKey, TValye> Type Parameters: : 
Dh oH Frvmaabiec mt Ty 时 - TKey: The type of the keys in the ictionary. 
4 ai ee ne TYolue: The type of the valves in the dictionary, 


图 2-13 Object Browser 工 具 


2.6.6 ”集成 对 代码 重 构 的 支持 
Visual Studio 所 配备 的 一 个 主要 功能 是 , 对 既 有 代码 进行 重 构 的 支持 。 简 单 地 说 , 重 构 ( refactoring ) 
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是 一 个 正规 、 严 格 的 过 程 ， 目 的 是 改善 既 有 的 代码 库 。" 过 去 ， 代 码 的 重 构 通常 需要 大 量 的 手工 劳动 。 
幸好 Visual Studio 可 以 完成 大 量 自动 重 构 的 工作 。 
在 Refactor 菜 单 ( 只 有 当代 码 文件 在 IDE 中 打开 时 ， 它 才 可 用 ) 下 有 相关 的 键盘 快捷 键 、 智 能 标签 
以 及 与 上 下 文敏 感 的 鼠标 点 击 ， 你 可 以 以 最 少 的 代价 重组 代码 。 表 2-2 定 义 了 可 以 由 Visual Studio 识 别 
的 一 些 常 见 的 重 构 。 
表 2-2 Visual Studio 的 重 构 





重 构 技术 作 “用 
Extract Method ( 提取 方法 ) 允许 定义 一 个 基于 所 选择 的 代码 语句 的 新 方法 
Encapsulate Field ( 封装 字段 ) 把 一 个 公共 的 字段 转化 为 一 个 由 C# 属 性 封装 的 私有 字段 
Extract Interface ( 提取 接口 ) 定义 一 个 基于 现 有 类 型 成 员 集 的 新 接口 类 型 
Reorder Parameters ( 重 排 参 数 ) 提供 了 一 种 重新 排序 成 员 实 参 的 方式 
Remove Parameters ( 除去 参数 ) 从 参数 的 当前 列表 中 除去 给 定 的 实 参 ( 如 你 期 望 的 那样 ) 
Rename ( 重 命 名 ) 允许 在 整个 项 目 期 间 重 新 命名 代码 标记 ( 方法 名 字 、 字 段 、 本 地 变量 等 ) 


为 了 阐明 重 构 是 如 何 实现 的 ， 用 以 下 代码 修改 Main() 方 法 : 
static void Main(string[] args) 

// 建立 Console UI(CUD 

Console.Title = "My Rocking App"; 


Console.ForegroundColor = ConsoleColor.Yellow; 


Console.BackgroundColor = ConsoleColor.Blue; 
Console.WriteLine(" 六 * 闵 六 水 玉米 来 冰冰 来 闵 冰冰 永 来 闵 来 闵 闵 率 六 闵 来 冰 素 六 来 冰冰 六 冰冰 素 闵 中) > 


Console.WriteLine("***** Welcome to My Rocking App *****"); 
Console.WzriteLine (" 半 本 本 站 水 下 本 棘 本 本 站 术 机 于 本 环 本 本末 本 本 冰 事 可 可 本 炒 本 来 水 可 本 玫 玉 事 本 事 > 


Console.BackgroundColor = ConsoleColor.Black; 


// 等 待 按 Enter 键 以 关闭 


Console.ReadLine(); 


虽然 上 述 代码 本 身 正确 无 误 , 但 是 想象 一 下 ， 如 果 需 要 在 程序 中 各 个 位 置 上 都 显示 这 个 提示 ， 情 
形 将 会 怎样 ? 为 避免 不 断 重复 输入 相同 的 控制 台 用 户 界面 逻辑 ,理想 情况 是 有 一 个 可 以 调用 的 辅助 函 
数 来 完成 这 个 工作 。 因 此 ， 你 将 对 既 有 的 代码 应 用 Extract Method 重 构 。 

首先 ， 在 编辑 器 内 选择 Main() 中 的 各 个 代码 语句 (对 Console.ReadLine() 的 最 后 一 次 调用 除外 )。 
然后 ， 右 击 所 选择 的 文本 ， 并 从 Refactor 上 下 文 菜单 中 选择 Extract Method 选 项 ， 如 图 2-14 所 示 。 

在 结果 对 话 框 里 把 新 方法 命名 为 ConfigureCUI。 完 成 后 ， 你 将 发 现 Main() 方 法 调用 了 新 生成 的 
ConfigureCUI() 方 法 ， 后 者 现在 包含 了 前 面 所 选择 的 代码 。 


class Program 
static void Main(string[] args) 
ConfigureCUI(); 


GD 有 关 重 构 的 进一步 信息 ,请 阅读 Martin Fowler 的 《 重 构 : 改善 既 有 代码 的 设计 ( 英文 注释 版 )》( 人 民 邮 电 出 版 社 ， 
2010 ), 一 一 编者 注 
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// 等 待 按 键 以 关闭 
Console.ReadLine(); 





private static void ConfigureCUI() 


// 建立 Console UI(CUD 
Console.Title = "My Rocking App"; 
Console.ForegroundColor = ConsoleColor.Yellow; 


Console.BackgroundColor = ConsoleColor.Blue; 
Console WriteLine( 中 米 玉米 炒米 闵 闵 六 玉米 六 来 炒米 玉米 六 闵 闵 米 闵 六 冰冰 冰冰 六 冰 米 闵 冰冰 闵 冰冰 冰冰 9 


Console.WritelLine("***** Welcome to My Rocking App *****"); 
Console .WriteLine(" 六 六 冰冰 六 六 六 六 六 六 六 六 冰冰 六 六 六 六 六 六 六 浆 六 六 浆 交 六 闪闪 六 浆 浆 浆 浆 浆 冰冰) 


Console.BackgroundColor = ConsoleColor.Black; 
} 
} 


这 是 使 用 Visual Studio 内 置 的 重 构 的 一 个 简单 示例 ， 下 面 以 及 本 书 其 他 地 方 还 有 另外 的 示例 。 不 
过 ,你 现在 可 以 随意 激活 其 他 重 构 选 项 ， 看 看 它们 各 自 有 什么 作用 ( 不 过 本 书后 面 不 会 再 使 用 当前 的 
VsExample 项 目 了 ， 所 以 也 无 需 花费 太 多 时 间 )。 
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其 ca CeX 
国 copy Can*C 
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Find Metching Clones mn Solution 
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图 2-14 激活 代码 重 构 


2.6.7 ”代码 扩展 和 围绕 技术 


Visual Studio ( 以 及 Visual C# Express ) 也 具有 使 用 菜单 选项 、 上 下 文 关联 的 鼠标 单 击 以 及 键盘 快 
捷 键 插入 预制 的 C# 代 码 块 的 能 力 。 可 用 的 代码 扩展 数量 是 惊人 的 ， 并 可 分 为 两 个 大 类 。 

口 片段 : 这 类 模板 在 鼠标 光标 位 置 处 插入 公共 代码 块 。 

口 围绕 : 这 类 模板 在 一 个 相关 作用 域内 封装 被 选 定语 句 的 块 。 

亲身 体验 一 下 这 个 功能 ,假设 你 希望 使 用 foreach 语 句 来 迭代 Main() 方 法 的 传人 参数 。 可 以 激活 
foreach 代 码 块 ， 而 不 用 手动 键入 代码 。 激 活 之 后 ，IDE 会 在 鼠标 光标 的 当前 位 置 处 弹出 一 个 foreach 
代码 模板 。 
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举例 说 明 ， 将 鼠标 光标 放 在 Main() 的 第 一 个 左 花 括号 的 后 面 。 通 过 右 击 鼠 标 ， 选 中 Insert Snippet 
(或 Surround With ) 菜单 选项 来 激活 代码 块 。 将 会 在 这 里 看 到 所 有 此 类 代码 块 的 列表 ( 按 Esc 键 以 消除 
弹出 菜单 ), 也 可 以 只 键入 代码 块 的 名 字 作 为 快捷 方式 ， 在 本 例 中 这 个 名 字 为 foreach。 如 图 2-15 所 示 ， 
注意 代码 块 的 图 标 看 起 来 有 点 像 一 张 撕 碎 的 纸 。 


Le : 
arcrcrem -ae aarmetaac ee 
,YsExample.Program ~ ®, Main(stringl) arg3) = 
using System.Collections.Generic; 地 
Using System.Ling; 
using System, Text; 
using System, Threading.Tasks; 


=namespace VsExample 
{ 
= class 
{ 
static void Main(string{] args) 
f 
for 
ts BadimageformatException 


字 Base64FormattingOpticns { lsed 





BY for 加 
| 

Hs FormatException |Code snippet for foreach statement | 
priv 自 for 


{ wo ICustomFormatter 
*9 下 ormatprovider ; 
CM Fre ForigrounaLoior = Consclecolor.Yellow; 


nsole.BackgroundColor = ConsoleColor .Blue; 
ep 和 
100% -+ NE me 加 


图 2-15 ”激活 代码 块 
找到 了 你 希望 激活 的 代码 块 之 后 ， 就 按 两 次 Tab 键 。 它 会 自动 完成 整个 代码 块 并 且 留 下 一 组 占 位 
符 ， 然 后 你 就 可 以 填充 它 来 完成 代码 块 。 如 果 按 Tab 键 ， 就 可 以 切换 每 一 个 占 位 符 并 且 填 充 内 容 ( 按 
Esc 键 来 退出 代码 段 编 辑 模式 ), 对 于 我 们 的 实例 ,我 们 可 以 使 用 string 数 据 类 型 改变 第 一 个 占 位 符 ( var 
关键 字 ), 使 用 arg 改 变 第 二 个 占 位 符 ( item 变 量 名 ), 用 下 一 子 字 符 串 数组 参数 的 名 称 改变 最 后 一 个 占 
位 符 ， 得 到 的 结果 如 下 所 示 : 
static void Main(string[] args) 


foreach (String arg in args) 


} 


如 果 如 果 在 打开 的 C# 代 码 文件 中 右 击 并 选择 Surround With 菜 单 ， 同 样 地 ,你 面前 会 呈现 一 连 串 的 
选项 。 还 记得 吗 ? 在 使 用 围绕 代码 块 的 时 候 , 我 们 通常 先 选择 一 段 代码 语句 块 来 表示 要 被 包装 的 东西 
( 如 try/catch 块 等 )。 要 确保 花 一 点 儿 时 间 浏 览 这 些 预 定义 的 代码 扩展 模板 ,因为 它们 能 够 大 幅度 加 快 
开发 的 速度 。 


说 明 所 有 代码 扩展 模板 都 是 对 IDE 内 代码 基于 XML 的 描述 。 使 用 Visual Studio ( 以 及 Visual C# 
Express ) 可 以 创建 自 定义 的 代码 模板 。 具 体 实现 细节 可 以 到 http://msdn.microsoft.com/en-US/ 
library/ms379562 上 查看 我 的 文章 “Investigating Code Snippet Technology”。 
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2.6.8 ”可视化 Class Designer 


Visual Studio 具 备 可 视 化 设计 类 和 其 他 类 型 的 能 力 (但 Visual C# Express 不 具备 )。 这 种 Class 
Designer 工 具 人 允许 在 项 目 里 查看 和 修改 各 个 类 型 的 相互 关系 ( 类、 接口 、 结 构 、 枚 举 和 委托 )。 使 用 这 
种 工具 ， 能 够 可 视 地 对 一 个 类 型 增加 (或 者 去 除 ) 成 员 ， 并 且 所 做 的 修改 能 反映 在 对 应 的 C# 源 代码 文 
件 里 。 同 样 ， 当 修改 一 个 给 定 的 C## 淹 代码 文件 时 ， 所 做 的 修改 会 反映 在 对 应 的 类 图 里 。” 

为 了 能 够 使 用 Visual Studio 的 这 一 功能 ， 第 一 步 是 插入 一 个 新 的 类 图 文件 。 这 有 许多 方法 可 以 实 
现 ， 其 中 一 个 方法 就 是 单 击 位 于 Solution Explorer 右 侧 的 View Class Diagram 按 钮 ( 如 图 2-16 所 示 ， 确保 
所 选中 的 是 项 目 ， 而 不 是 解决 方案 )。 
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SOLUTION EXPLORER TEAM EXPLORER CLASS VIEW 
图 2-16 ”向 当前 项 目 插入 类 图 文件 


完成 之 后 ,在 当前 项 目 里 将 出 现代 表 各 个 类 型 的 类 图 标 。 单 击 箭头 图 标 可 以 显示 或 隐藏 类 型 成 员 
(如 图 2-17 所 示 )。 
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图 2-17 Class Diagram 查 看 器 


该 工具 与 Visual Studio 的 其 他 两 个 功能 结合 发 挥 作用 : Class Details 窗 口 (通过 View 一 Other 
Windows 菜 单 启动 ) 以 及 Class Designer Toolbox ( 通过 View 一 Toolbox 菜 单项 启动 )。Class Details 窗 口 


GD 这 就 是 所 谓 的 模型 驱动 开发 ( Model-Driven Development，MDD ) 的 基本 实现 。 一 一 编者 注 
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不 仅 显示 图 中 当前 所 选项 的 细节 ， 而 且 还 允许 在 执行 状态 下 修改 已 有 成 员 并 插入 新 成 员 ( 如 图 2-18 
所 示 )。 
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图 2-18 ”Class Details 窗 口 


Class Designer Toolbox 也 能 使 用 View 菜 单 激 活 ， 人 允许 可 视 地 在 项 目 里 插入 新 的 类 型 ( 并 且 在 这 些 
类 型 之 间 创 建 关 联 关 系 )， 如 图 2-19 所 示 。( 需要 注意 的 是 ， 必 须 有 一 个 类 图 作为 活动 窗口 来 查看 该 工 
具 箱 。 ) 完成 后 ，IDE 自 动 在 后 台 创建 新 的 C# 类 型 定义 。 
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图 2-19 Class Designer Toolbox 


举 个 例子 ， 从 Class Designer Toolbox 里 拖 一 个 新 的 Class 到 Class Designer 上 。 在 结果 对 话 框 里 将 
该 类 命名 为 C ar。 接着， 使 用 Class Details 窗 口 ， 增 加 一 个 名 为 petName 的 公共 string 字 段 ( 如 图 2-20 
所 示 )。 
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图 2-20 ”用 Class Details 窗 口 增加 字段 
如 果 现 在 查看 Car 类 的 C# 定 义 ， 你 会 看 到 它 已 经 相应 地 被 修改 了 ( 除 代 码 注释 以 外 ): 


public class Car 

{ 
// 一 般 不 应 使 用 公共 数据 ， 这 里 之 所 以 破例 ， 是 为 了 使 代码 简单 一 些 
public string petName; 


} 
再 次 激活 设计 器 文件 ， 在 设计 器 中 增加 另 一 个 新 的 类 sportsCar。 现 在 ， 从 Class Designer Toolbox 
里 选择 Inheritance 图 标 并 单 击 SportsCar 图 标的 顶部 。 按 住 鼠 标 左 键 不 放 , 把 鼠标 移 到 car 类 图 标的 顶部 


后 松 开 。 一 切 无 误 的 话 ， 就 已 经 从 Car 派 生出 了 SportsCar 类 (如 图 2-21 所 示 )。 
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图 2-21 从 现 有 的 类 中 可 视 地 派生 新 的 类 
为 了 完成 本 例 ， 用 一 个 名 为 GetPetName() 的 公共 方法 更 新 所 生成 的 SportsCar 类 ， 如 下 所 示 
public class SportsCar : Car 


public string GetPetName() 


petName = "Fred"; 
return petName; 


} 
在 阅读 本 书 的 过 程 中 ,你 可 以 使 用 Visual Studio 中 的 这 些 可 视 化 工具 。 现 在 ， 你 应 该 已 经 对 IDE 的 
基础 知识 有 了 充分 的 了 解 。 
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说 明 ”我 们 将 在 第 6 章 全 面 研 究 关 于 继承 的 概念 。 


2.6.9 集成 的 .NET Framework 4.5 SDK 文 档 系 统 


Visual Studio 的 最 后 一 个 功能 肯定 会 让 你 从 一 开始 就 感觉 很 舒服 ， 那 就 是 完全 集成 的 帮助 系 
统 。.NET Framework 4.5 SDK 的 文档 系统 非常 出 色 ， 可 读 性 很 强 ， 并 且 包 含 充足 的 有 用 信息 。 由 于 有 
大 量 预 定义 的 .NET 类 型 ( 数量 有 上 千 个 之 多 )， 你 必须 准备 深入 学 习 文档 系统 。 如 果 不 这 样 做 ， 作 
为 .NET 开发 人 员 ， 你 注定 会 承受 一 个 漫长 、 令 人 诅 丧 而 痛苦 的 过 程 。 

如 果 你 能 够 上 网 , 就 可 以 在 网 址 http://msdn.microsoft.com/library 在 线 查 看 .NET Framework 4.5 SDK 
文档 。 

在 主页 中 ,使 用 树 形 视图 导航 找到 .NET Development， 点 击 后 选择 .NET Framework 4.5， 之 后 你 就 
可 以 看 到 所 有 的 .NET Framework Class Library 的 重要 链接 了 ， 每 个 链接 都 用 单独 的 .NET 命 名 空间 记录 了 
该 类 型 ( 如 图 2-22 所 示 )。 
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图 2-22 在线 查 看 .NET Framework 4.5 文 档 


在 安装 Visual Studio 的 过 程 中 ， 你 可 以 在 计算 机 上 安装 同样 的 帮助 系统 ( 如 果 你 不 能 上 网 ， 这 一 
设置 就 非常 实用 ), 要 本 地 安装 帮助 系统 , 单 击 Windows 的 “开始 "按钮 ,选择 “AllPrograms” 一 “Microsoft 
Visual Studio 11” 一 “Microsoft Help Viewer” 工 具 ， 然后 选择 添加 你 感 兴 趣 的 帮助 文档 ， 如 图 2-23 所 示 
( 如 果 硬 盘 空 间 允 许 ， 我 建议 你 添加 所 有 的 文档 )。 

不 论 是 本 地 系统 还 是 在 线 ， 与 文档 交互 的 最 简单 方式 是 选择 一 个 C# 关 键 字 ， 在 Visual Studio 代 码 
窗口 中 输入 名 称 或 成 员 名 称 ， 按 下 F1 键 。 这 将 自动 打开 所 选项 的 文档 窗口 。 例 如 ， 在 car 类 的 定义 中 
选择 string 关 键 字 。 按 下 F1 键 时 ， 将 出 现 Help 页 面 。 
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图 2-23 ”Help Library Manager 人 允许 你 下 载 .NET Framework 4.5 SDK 文 档 


帮助 文档 另 一 个 有 用 的 地 方 是 位 于 左上 方 的 Search 编 辑 框 。 你 可 以 输入 任何 命名 空间 、 类 型 或 成 
员 的 名 称 ， 它 将 为 你 导航 到 正确 的 位 置 。 如 果 你 要 检索 System.Reflection 命 名 空间 ， 就 可 以 学 习 该 命 
名 空间 的 详细 内 容 ， 研 究 它 包含 的 类 型 ， 查 看 代码 示例 等 。 


说 明 听 上 去 可 能 有 点 像 复 读 机 ， 但 学 习 使 用 NET Framework 4.5 SDK 文 档 真 的 非常 重要 。 不 管 是 什 
么 书 ， 不 管 它 有 多 厚 ， 都 无 法 涵盖 .NET 平 台 的 全 部 内 容 。 所 以 ， 花 点 时 间 充 分 了 解 帮 助 系统 
吧 ， 以 后 你 会 庆幸 这 个 决定 的 。 


2.7 小 结 


可 以 看 到 ， 有 很 多 新 工具 ! 本 章 概述 了 C# 程 序 员 在 开发 期 间 可 能 用 到 的 各 种 主要 编程 工具 。 我 们 
首先 学 习 了 如 何 仅 使 用 免费 的 C# 编 译 器 ( cxc.exe ) 和 记事 本 ( Notepad/ Notepad++ ) 生成 .NET 程 序 集 。 
接着 展示 了 如 何 使 用 这 些 工具 编辑 和 编译 *.cs 代 码 文 件 的 过 程 。 

本 章 还 讨论 了 3 个 功能 丰富 的 IDE， 开 始 是 开源 的 SharpDevelop ， 接 着 是 微软 的 Visual C# Express 
和 Visual Studio Professional。 本 章 仅 初 步 讨论 了 各 个 工具 的 功能 ， 但 有 益 于 你 进一步 探讨 你 所 选 定 的 
IDE。 在 学 习 本 书 的 过 程 中 ， 你 还 会 发 现 Visual Studio 的 其 他 功能 。 
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章 通过 介绍 很 多 小 而 独立 的 主题 来 开始 对 C# 编 程 语言 的 正式 研究 ， 这 些 主题 是 我 们 在 探 
索 .NET 框 架 时 必须 了 解 的 。 第 一 件 事 情 就 是 理解 如 何 构 建 程序 的 应 用 程序 对 象 以 及 可 执行 
程序 入 口 点 Main() 方 法 的 构成 。 接 着 ,我 们 会 研究 C# 基 本 数据 类 型 ( 和 它们 在 System 命名 空间 中 的 等 
价 类 型 )， 包 括 System.String 和 System.Text.StringBuilder 类 类 型 。 
了 解 了 基本 .NET 数 据 类 型 的 细节 之 后 ,我 们 会 研究 一 些 数据 类 型 转换 的 技术 , 包括 罕 化 运算 、 帘 
化 运算 以 及 checked 和 unchecked 关 键 字 的 使 用 。 
本 章 还 将 介绍 C# 关 键 字 var 的 作用 ， 它 允许 你 隐 式 地 定义 本 地 变量 。 你 将 看 到 ， 在 使 用 LINQ 技 术 
时 ， 隐 式 类 型 是 非常 有 帮助 的 。 最 后 我 们 会 快速 过 一 遍 允 许 你 使 用 循环 和 选择 结构 控制 应 用 程序 流程 
的 C# 关 键 字 和 操作 符 。 


3.1 一 个 简单 的 C# 程 序 


C# 要 求 所 有 的 程序 逻辑 都 包含 在 一 个 类 型 定义 中 (第 1 章 中 我 们 讲 过 ， 类 型 是 指 集合 { 类 ， 接 口 ， 
结构 , 枚 举 , 委托 } 中 的 一 个 成 员 )。 与 其 他 语言 不 同 , 要 在 C# 中 创建 全 局 函数 或 全 局 数据 是 不 可 能 的 。 
但 所 有 的 成 员 和 方法 都 必须 包含 在 一 个 类 型 定义 中 。 首 先 ， 新 建 一 个 控制 台 应 用 程序 项 目 
SimpleCSharpApp。 初 始 的 Program.cs 文 件 中 的 代码 很 简单 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 


namespace SimpleCSharpApp 
class Program 
static void Main(string[] args) 
} 


} 
} 


用 以 下 的 语句 修改 Main() 方 法 : 


class Program 
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static void Main(string[] args) 


// 显示 一 条 简单 的 消息 

Console.WriteLine("***** My First C# App *****"); 
Console.WritelLine("Hello World!"); 
Console.NriteLine(); 


// 按 下 Enter 键 以 后 关闭 
Console.ReadLine(); 
} 
} 


说 明 ”C# 是 一 种 区 分 字母 大 小 写 的 程序 设计 语言 。 所 以 , Main 与 main 不 同 , Readline 与 ReadLine 不 同 。 
因此 ， 要 注意 所 有 C# 关 键 字 都 是 小 写 的 ( 如 public、lock、class 和 dynamic 等 )， 同 时 命名 空 
间 、 类 型 和 成 员 名 称 ( 按 约 定 ) 以 一 个 大 写字 母 开头 , 中 间 的 单词 都 是 首 字母 大 写 ( 如 Console. 
WirteLine、System.Windows.MessageBox、System.Data.SqlClient 等 )。 按 照 惯例 ， 如 果 出 现 一 
个 “undefined symbols” 编 译 错 误 提 示 ， 就 需要 检查 一 下 拼写 是 否 正确 。 


在 这 里 ， 我 们 定义 了 只 有 一 个 Main() 方 法 的 类 类 型 。 默 认 情 况 下 ，Visual Studio 会 把 定义 Main() 的 
类 命名 为 “Program”,， 然而 ， 如 果 需 要 的 话 我 们 完全 可 以 修改 名 字 。 每 一 个 可 执行 的 C# 应 用 程序 ( 控 
制 台 程序 、Windows 桌 面 程序 或 Windows 服 务 ) 必须 包含 一 个 定义 了 Main() 方 法 的 类 ， 这 个 方法 用 来 
表示 应 用 程序 的 入 口 点 。 

正式 地 说 ， 定 义 Main() 方 法 的 类 叫做 应 用 程序 对 象 。 虽然 一 个 可 执行 程序 可 以 有 多 个 应 用 程序 对 
象 ( 在 执行 单元 测试 的 时 候 可 能 有 用 ), 但 是 我 们 必须 通过 命令 行 编译 器 的 /main 选 项 或 通过 位 于 Visual 
Studio 项 目 属 性 编辑 器 中 Application 选 项 卡 内 的 Startup Object 下 拉 列 表 框 (参见 第 2 章 ) 来 通知 编译 器 
将 哪个 Main() 方 法 作为 人 口 点 。 

注意 Main() 的 签名 ?具有 static 关 键 字 ， 我 们 会 在 第 5 章 中 研究 其 细节 。 在 这 里 ， 只 需要 理解 静态 
成 员 是 类 级 别 的 ( 而 不 是 对 象 级 别 的 )， 因 此 在 调用 之 前 不 需要 先 创建 新 的 类 实例 。 

除了 static 关 键 字 之 外 ， 这 个 Main() 方 法 还 有 一 个 参数 ， 是 一 个 字符 串 数 组 ( string[] args )。 现 
在 我 们 还 不 必 为 处 理 这 个 数组 操心 ， 这 个 参数 可 以 包含 任意 数量 的 命令 行 输入 参数 ( 你 马上 就 会 看 到 
怎样 访问 它们 )。 最 后 , Main() 方 法 使 用 了 void 返回 值 , 也 就 是 说 我 们 不 需要 在 退出 方法 作用 域 之 前 使 
用 return 关 键 字 来 显 式 定义 一 个 返回 值 。 

Program 的 逻辑 在 Main() 里 面 。 在 这 里 使 用 了 在 System 命名 空间 中 定义 的 Console 类 。 你 可 能 会 猜 到 ， 
在 它 的 成 员 集合 中 有 一 个 静态 的 WriteLine()， 能 够 将 一 个 文本 字符 串 和 回 车 符 输 送 到 标准 输出 端 。 还 
可 以 调用 Console.ReadLine(), 保证 由 Visual Studio IDE 启 动 的 命令 提示 符 在 调试 的 会 话 期 间 保 持 可 见 2 , 
直到 按 下 Enter 键 。 我 们 稍 后 就 会 详细 介绍 System.Console 类 。 


3.1.1 Main() 方 法 的 其 他 形式 
默认 状态 下 ，Visual Studio 生 成 的 Main() 有 一 个 void 返回 值 ， 并 且 只 接受 一 个 参数 ( 一 个 字符 串 数 


Q@ 所谓 签名 ， 就 是 指 一 个 方法 的 名 称 、 返 回 类 型 和 参数 列表 。 一 一 编者 注 
@ 即 不 会 立即 关闭 控制 台 窗 口 ， 让 你 可 以 查看 输出 结果 。 一 一 译 者 注 
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组 )。 但 这 不 是 唯一 可 能 的 Main() 形 式 。 使 用 下 列 任何 一 个 签名 (假设 它 包 含 在 一 个 C# 类 或 结构 定义 
中 ) 构造 应 用 程序 的 入 口 点 都 是 允许 的 : 

// 整 型 返回 类 型 ， 以 字符 串 数 组 作为 参数 

static int Main(string[] args) 


{ 
// 在 退出 之 前 必须 返回 一 个 值 
return 0; 


// 没有 返回 类 型 没有 参数 
static void Main() 

{ 

} 

// 整 型 返回 类 型 ， 没 有 参数 
static int Main() 


// 在 退出 之 前 必须 返回 一 个 值 
return 0; 


} 


说 明 如果 我 们 不 提供 一 个 明确 的 访问 修饰 符 ,Main() 上 默认 就 是 私有 的 ,但 它 也 可 以 被 定义 为 公有 的 。 
Visual Studio 会 把 程序 的 Main() 方 法 自动 定义 为 隐 式 私有 的 , 以 确保 其 他 应 用 程序 不 能 直接 调用 
另 一 个 应 用 程序 的 入 口 点 。 


很 明显 ， 选 择 怎样 构造 Main() 要 基于 两 个 问题 。 第 一 ， 当 Main() 完 成 并 且 程 序 终 止 时 ， 是 否 要 向 
系统 返回 一 个 值 ? 如 果 是 , 需要 返回 一 个 int 数 据 类 型 而 不 是 void。 第 二 , 是 否 需 要 处 理 用 户 提供 的 命 
令 行 参数 ? 如果 是 ,它们 将 被 保存 在 string 数 组 中 。 下 面 我 们 来 深入 了 解 一 下 不 同 的 情况 。 


3.1.2 ”指定 应 用 程序 错误 代码 


虽然 绝 大 多 数 Main( ) 方 法 会 以 void 作为 返回 值 , 但 是 C# 和 其 他 C 系 列 的 语言 一 样 , 都 可 以 从 Main() 
返回 一 个 int。 根据 惯例 ,返回 值 0 表示 程序 正常 结束 ,而 其 他 值 ( 如 -1 ) 则 表示 有 错误 发 生 ( 要 知道 ， 
值 0 是 自动 返回 的 ， 即 使 Main() 方 法 的 原型 结构 返回 void )。 

在 Windows 操 作 系 统 上 ， 应 用 程序 的 返回 值 保存 在 一 个 叫做 %ERRORLEVEL% 的 系统 环境 变量 中 。 如 
果 我 们 要 创建 一 个 以 编程 方式 启动 另外 一 个 可 执行 程序 的 应 用 程序 ( 第 17 章 会 研究 这 个 主题 )， 就 可 
以 使 用 静态 的 System.Diagnostics.Process.ExitCode 属 性 来 获取 %ERRORLEVEL% 的 值 。 

由 于 应 用 程序 的 返回 值 是 在 程序 结束 时 传 给 系统 ， 显 然 应 用 程序 不 太 可 能 在 程序 运行 时 获取 并 显 
示 最 终 的 错误 代码 。 然 而 , 为 了 演示 如 何 查 看 程序 终止 时 的 错误 级 别 , 我 们 先 按 如 下 所 示 来 更 新 Main() 
方法 : 

// 注意 ， 现 在 返回 int， 而 不 是 void 

static int Main(string[] args) 


// 显示 一 个 消息 并 等 待 按 Enter 键 
Console.WriteLine("***** My First C# App *****"); 
Console.WriteLine("Hello World!"); 
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Console.WriteLine(); 
Console.ReadLine(); 


// 任意 返回 一 个 错误 代码 
return -1; 


} 

现在 借助 批 处 理 文件 来 捕获 Main() 的 返回 值 。 使 用 Windows 资 源 管理 器 ， 转 到 包含 已 编译 的 应 用 
程序 的 目录 ( 如 Ci\SimpleCSharpApp\bin\Debug )。 在 Debug 文 件 夹 中 新 建 一 个 文本 文件 ( 命名 为 
SimpleCSharpApp.bat ) 并 包含 如 下 的 代码 ( 如 果 之 前 没有 编写 过 *.bat 文 件 , 不 要 过 分 关心 其 中 的 细节 ， 
这 只 是 一 个 测试 ): 

@echo off 


rem A batch file for SimpleCSharpApp.exe 
rem which captures the app's return value. 


SimpleCSharpApp 
@if "%ERRORLEVEL%" == "0" goto success 


:fail 
echo This application has failed! 
echo return value = %ERRORLEVEL% 
goto end 

:success 
echo This application has succeeded! 
echo return value = %ERRORLEVEL% 
goto end 

:end 
echo All Done. 


至 此 ， 打 开 Visuat Studio 命 令 提 示 符 ， 转 到 包含 可 执行 文件 以 及 新 的 *.bat 文 件 的 目录 。 通 过 输入 
批 处 理 文件 名 字 并 按 Enter 键 来 执行 批 处 理 。 假 设 Main() 方 法 返回 -1， 应 该 能 看 到 如 下 所 示 的 输出 。 如 
果 Main() 方 法 返回 9， 可 能 会 见 到 “This application has succeeded!” 这 样 的 消息 被 输出 到 控制 台 。 





来 来 来 来 六 My First C# App 六 六 米 冰 六 
Hello World! 


This application has failed! 
return value = -1 
All Done. 


再 说 一 次 , 绝 大 多 数 (但 不 是 全 部 ) C# 应 用 程序 会 使 用 void 作 为 Main() 的 返回 值 , 你 应 该 记得 吧 ， 
这 其 实 是 在 隐 式 返回 0 作为 错误 代码 。 为 此 ， 本 书 中 使 用 的 Main() 方 法 都 会 返回 void。( 其 余 的 项 目 当 
然 不 需要 使 用 批 处 理 文件 来 捕获 返回 值 ! ) 


3.1.3 “处理 命令 行 参数 


既然 你 对 Main() 方 法 的 返回 值 有 了 更 好 的 了 解 ， 那 么 就 来 研究 字符 串 数据 的 传人 数组 。 假 设 希 望 
更 新 应 用 程序 来 处 理 可 能 的 命令 行 参 数 ， 其 中 一 个 方法 是 使 用 C# 的 for 循 环 (本 章 后 面 会 研究 C# 的 迁 
代 结 构 ): 
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static int Main(string[] args) 


// 处 理 传 入 的 参数 
for(int i = 0; i < args.Length; i++) 
Console.Writeline("Arg: {0}", args[i]); 


Console.ReadLine(); 
return -1; 
在 这 里 ,使 用 System.Array 的 Length 属 性 ， 检 查 string 数 组 是 否 包 含 一 些 项 。 在 第 4 章 中 你 将 会 看 
到 ， 所 有 C# 数 组 实际 上 都 是 System.Array 类 的 别名 ， 因 此 具有 一 组 公共 的 成 员 集合 。 当 循环 到 数组 的 
每 一 项 时 ， 它 的 值 被 输出 到 控制 台 窗 口中 。 在 命令 行 提供 参数 也 一 样 简单 ， 如 下 所 示 。 





C:\SimpleCSharpApp\bin\Debug>SimpleCSharpApp.exe /arg1 -arg2 


六 六 冰冰 六 My First C# App 冰冰 闵 水 六 
Hello World! 

Arg: /arg1 

Arg: -arg2 





作为 标准 的 for 循 环 的 替代 方案 ， 可 以 用 C# 的 foreach 关 键 字 迭代 传人 的 string 数 组 。 这 里 是 一 些 
示例 用 法 : 


// 注意 ， 当 使 用 foreach 时 不 需要 检查 数组 的 大 小 
static int Main(string[] args) 


1 使 用 foreach 处 理 所 有 传 入 的 参数 
foreach(string arg in args) 
Console.WritelLine("Arg: {0}", arg); 


Console.ReadLine(); 
return -1; 


最 后 ,还 可 以 使 用 System.Environment 类 型 的 静态 方法 GetCommandLineArgs() 访 问 命令 行 参数 。 这 
个 方法 的 返回 值 是 一 个 string 数 组 。 第 一 个 索引 表示 应 用 程序 本 身 的 名 称 ， 而 数组 中 其 余 的 元 素 包 含 
单独 的 命令 行 参数 。 当 使 用 这 个 方法 时 , 不 再 需要 将 Main() 定 义 成 输入 参数 为 一 个 string 数 组 的 方法 ， 
虽然 这 样 做 没有 害处 。 


static int Main(string[] args) 


// 用 System.Environment 获 取 参 数 

string[] theArgs = Environment.GetCommandLineArgs(); 

foreach(string arg in theArgs) 
Console.WritelLine("Arg: {0}", arg); 


Console.ReadLine(); 
return -1; 


当然 ， 程 序 会 对 哪些 命令 行 参数 ( 如 果 有 的 话 ) 做 出 响应 以 及 参数 是 如 何 格式 化 的 例如 加 “-” 
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或 “/” 前 级 )， 这 都 取决 于 你 。 在 这 里 ， 我 们 只 是 传人 一 系列 选项 并 直接 输出 到 命令 提示 符 。 然 而 ， 
假设 我 们 在 创建 一 个 视频 电子 游戏 并 且 编写 程序 来 处 理 一 个 叫做 -godmode 的 选项 。 如 果 用 户 使 用 这 个 
标志 启动 应 用 程序 ， 我 们 可 以 知道 这 个 用 户 其 实 是 一 个 作 疯 者 ， 并 可 以 采取 适当 措施 。 


3.1.4 ”使 用 Visual Studio 指 定 命令 行 参数 


在 现实 世界 中 ， 启 动 程序 时 ， 要 由 用 户 提供 该 程序 使 用 的 命令 行 参数 。 但 是 ， 在 开发 周期 中 ，, 程 
序 员 可 能 出 于 测试 目的 希望 指定 一 些 命令 行 标志 。 在 Visual Studio 要 想 这 样 做 , 就 应 在 Solution Explorer 
中 双击 Properties 图 标 ， 选 择 左 侧 的 Debug ( 调试 ) 标签 。 在 这 里 ,使 用 Command line arguments ( 命令 
行 参数 ) 文本 框 指定 值 ( 如 图 3-1 所 示 )。 


SimpleCSharpApp + X ; : a 
nt tee ee ttn eer 





Application i ey rp 
Configuration: © Active (Debug) vi Platform: Active (Any CPU > | 
Build Ee i 
Build Events Start Action 
© Start project | 
Resources | 
Start external program: | 
Services ) 
Settings Start browser with URL: | 
Reference Paths Start Options 
Signing 一 一 - -一 一 一 
Command line arguments: -godmede -argl /arg2 =， | 
Security | 
Publish 


Code Analysis 
Working directory: 


Use remote machine 
图 3-1 通过 Visual Studio 设 置 命 令 行 参数 


一 旦 建立 了 这 样 的 命令 行 参数 , 在 Visual Studio IDE 中 调试 或 运行 应 用 程序 的 时 候 , 它们 将 被 自动 
传递 给 Main() 方 法 。 


3.2 ”有 趣 的 题 外 话 : System.Environment 类 的 其 他 成 员 


除了 GetCommandLineArgs() 以 外 ，Environment 类 型 还 有 一 些 有 用 的 方法 。 这 个 类 允许 我 们 通过 不 
同 的 静态 成 员 获 得 大 量 有 关 运 行 ,NET 应 用 程序 的 操作 系统 的 细节 。 为 了 说 明 这 个 类 的 有 效 性 ， 修 改 
Main() 方 法 以 调用 名 为 ShowEnvironmentDetails() 的 辅助 方法 : 


static int Main(string[] args) 
// Program 类 的 辅助 方法 
ShowEnvironmentDetails(); 


Console.ReadLine(); 
return -1; 
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在 Program 类 中 实现 这 个 方法 来 调用 Environment 类 型 的 各 种 成 员 。 例 如 : 


static void ShowEnvironmentDetails() 


{ 
// 输出 本 机 的 驱动 器 以 及 其 他 一 些 有 用 的 细节 信息 
foreach (string drive in Environment.GetLogicalDrives()) 
Console.WritelLine("Drive: {0}", drive); 


Console.WriteLine("05: {0}", Environment.0SVersion); 
Console.WritelLine("Number of processors: {0}", 
Environment.ProcessorCount); 
Console.WritelLine(".NET Version: {0}", 
Environment .Version); 


下 面 的 输出 显示 了 调用 这 个 方法 的 一 个 可 能 的 测试 运行 。 如果 你 没有 通过 Visual Studio 的 Debug 标 
签 来 指定 命令 行 参数 ， 控 制 台 上 就 不 会 有 这 些 。 





米 玉米 玉 米 My First C# App 米 米 六 炒米 
Hello World! 


Arg: -godmode 


Arg: -arg1 
Arg: /arg2 
Drive: C:\ 
Drive: D:\ 
Drive: E:\ 
Drive: F:\ 
Drive: G:\ 
Drive: H:\ 
Drive: I:\ 


0S: Microsoft Windows NT 6.1.7601 Service Pack 1 
Number of processors: 4 
.NET Version: 4.0.30319.17020 





除了 前 一 个 示例 中 出 现 过 的 成 员 ，Environment 类 型 还 定义 了 其 他 成 员 。 表 3-1 给 出 了 另外 一 些 有 
趣 的 属性 。 但 是 ， 查 阅 .NET Framework 4.5 SDK 文 档 才能 了 解 全 部 的 细节 。 


表 3-1 System.Environment 的 部 分 属性 


属 性 作 用 
ExitCode 获取 或 设置 应 用 程序 中 任何 地 方 的 退出 代码 
Is64BitOperatingSystem 返回 布尔 值 ， 代 表 主 机 是 否 运 行 64 位 操作 系统 
MachineName 获得 当前 机 器 的 名 字 
NewLine 获得 当前 环境 的 换行 符 
SystemDirectory 返回 通 向 系统 目录 的 完整 路 径 
UserName 返回 启动 这 个 应 用 程序 的 用 户 的 名 称 


Version 返回 版 本 对 象 ， 代 表 .NET 平 台 的 版 本 
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源 代码 ”SimpleCSharpApp 项 目的 源 代码 位 于 Chapter 3 子 目 录 下 。 


3.3 System.Console 类 


前 面 几 章 中 所 创建 的 示例 应 用 程序 都 广泛 地 使 用 了 System.Console 类 。 虽 然 CUI 命令 行 用 户 界 面 ) 
不 如 GUI 或 基于 Web 的 前 端 那 样 吸引 人 , 但 是 将 早期 的 示例 限制 为 只 使 用 CUTI, 我 们 就 可 以 将 重点 集中 
在 C# 语 法 和 .NET 平 台 的 核心 方面 ， 而 不 用 处 理 建立 GUI 或 网 站 的 复杂 性 。 

顾名思义 ，Console 类 封装 了 基于 控制 台 应 用 程序 的 输入 、 输 出 和 错误 流 操 作 。 表 3-2 列 出 了 一 些 
(但 不 是 全 部 ) 比较 受 关注 的 成 员 。 从 表 中 可 以 看 出 , Console 类 的 许多 成 员 能 为 简单 的 命令 行程 序 “ 增 
添 情趣 "， 例 如 ， 可 以 改变 背景 颜色 和 前 景 颜色 ， 以 各 种 频率 发 出 蜂 鸣 声 。 


表 3-2 System.Console 的 部 分 成 员 


成 员 作 用 
Beep() 这 个 方法 强制 控制 台 发 出 指定 频率 和 持续 时 间 的 蜂 鸣 声 
BackgroundColor 这 些 属 性 设置 当前 输出 的 背景 /前 景色 。 它 们 可 以 被 赋予 ConsoleColor 枚 举 的 任何 成 员 
ForegroundColor 
BufferHeight 这 些 属性 控制 控制 台 缓冲 区 域 的 高 度 /宽度 
BufferWidth 
Title 这 个 属性 设置 当前 控制 台 的 标题 
人 no 这 些 属性 控制 与 已 建立 的 缓冲 区 相关 的 控制 台大 小 
indowWidth 
WindowTop 
WindowLeft 
Clear() 这 个 方法 清除 已 建立 的 缓冲 区 和 控制 台 的 显示 区 域 


3.3.1 使 用 Console 类 进行 基本 的 输入 和 输出 


除了 表 3-2 的 成 员 以 外 ，Console 类 还 定义 了 捕获 输入 和 输出 的 一 套 方法 , 它们 都 被 定义 成 静态 的 ， 
因此 能 够 通过 将 类 的 名 字 作 为 方法 名 的 前 缀 来 调用 。 可 以 看 到 ,WriteLine() 将 文本 字符 串 ( 包括 一 个 
回 车 符 ) 输送 到 输出 流 。Write() 方 法 将 文本 输送 到 输出 流 而 不 附加 回 车 符 。ReadLine() 从 输入 流 接收 
信息 直到 遇 到 回 车 符 ， 而 Read() 被 用 来 从 输入 流 获 得 一 个 字符 。 

为 了 演示 使 用 Console 类 进行 基本 的 IO, 我 们 来 新 建 一 个 控制 台 应 用 程序 BasicConsoleIO, 并 且 更 
新 Main() 方 法 来 调用 GetUserData() 辅 助 方法 : 


class Program 
static void Main(string[] args) 


Console.WritelLine("***** Basic Console I/O *****"); 
GetUserData(); 
Console.ReadLine(); 
} 
} 
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说 明 ”在 第 2 章 中 ， 我们 简要 介绍 了 Visual Studio 代 码 片段 。 在 本 书 前 面 几 章 中 ，cw 代 码 片段 十 分 有 
用 ， 因 为 它 能 自动 扩展 为 Console.WriteLine()! 想 自己 测试 一 下 , 你 可 以 在 Main() 方 法 中 输入 
cw， 再 按 两 次 Tab 键 。 可 惜 的 是 ， 没 有 Console.ReadLine() 的 代码 片段 。 


在 Program 类 中 实现 这 个 方法 , 采用 的 逻辑 是 , 提示 用 户 一 些 信息 并 且 通 过 标准 的 输出 流 来 回 显 每 
一 项 。 例如， 我 们 可 以 询问 用 户 的 姓名 和 年 龄 (为 了 简单 起 见 ， 我 们 把 它 当 做 文本 值 ， 而 不 是 我 们 期 
望 的 数值 )， 代 码 如 下 : 


static void GetUserData() 


// 获取 姓名 和 年 龄 

Console.Write("Please enter your name: "); 
string userName = Console.ReadLine(); 
Console.Write("Please enter your age: "); 
string userAge = Console.ReadLine(); 


// 改变 回复 的 颜色 ， 只 是 为 了 好 玩 
ConsoleColor prevColor = Console.ForegroundColor; 
Console.ForegroundColor = ConsoleColor.Yellow; 


// 回复 到 控制 台 
Console.WriteLine("Hello {0}! You are {1} years old.", 
userName, userAge); 


// 恢复 之 前 的 颜色 


Console.ForegroundColor = prevColor; 
不 出 所 料 ， 运 行程 序 后 ,输入 数据 就 被 输出 到 了 控制 台 (使 用 自 定义 的 颜色 )。 


3.3.2 格式 化 控制 台 输 出 


在 前 面 的 这 几 章 中 ,多 次 见 到 诸如 {o} 、{1} 之 类 的 标记 能 人 在 字符 串 字 面 量 中 。.NET 引 入 了 一 种 
字符 串 格 式 化 的 新 风格 ， 与 C 语 言 的 printf() 语 句 相 似 。 简 而 言 之 ， 如 果 需 要 定义 一 个 字符 串 字 面 量 ， 
其 中 包含 一 些 要 到 运行 时 才能 知道 其 值 的 数据 片段 ， 可 以 使 用 这 种 花 括号 语法 在 文本 内 部 指定 占 位 
符 。 在 运行 时 ， 值 会 传人 到 Console.writeLine() 来 替代 每 一 个 占 位 符 。 

传 给 WriteLine() 的 第 一 个 参数 代表 一 个 包含 由 {oy 、{1} 、{2} 等 (大 括号 占 位 符 数字 编码 方式 总 是 以 
0 开始 ) 指定 的 可 选 占 位 符 的 字符 串 字面 量 。 其 余 传 给 WriteLine() 的 参数 就 是 要 插入 各 自 占 位 符 的 值 。 


说 明 ”如果 唯一 编号 的 大 括号 占 位 符 的 数量 比 填充 的 参数 数量 多 ， 则 会 在 运行 时 收 到 一 个 格式 异常 ; 
若是 比 填充 的 参数 数量 少 ， 没 有 使 用 的 填充 参数 就 会 被 忽略 。 


在 一 个 给 定 的 字符 串 中 可 以 重复 特定 的 占 位 符 。 举 例 来 说 ， 如 果 你 是 一 个 甲壳 虫 乐队 的 爱好 者 ， 
想 建立 一 个 字符 串 "9，Number 9，Number 9"" ， 你 会 写 : 


Q@ 这 是 甲壳 虫 乐 队 Revolutionr No. 9 这 首 歌曲 的 歌词 ， 下 面 注 释 中 的 John 是 该 乐队 的 已 故 主唱 约翰 列 依 。 
一 一 编者 注 
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// John 说 ……: 
Console.WriteLine("{0}, Number {0}, Number {0}", 9); 


还 要 知道 ， 可 以 在 字符 串 字面 量 的 任意 位 置 放置 占 位 符 ， 而 不 需要 按照 递增 的 次 序 。 例 如 ， 看 看 
如 下 的 代码 片段 : 
// 输出 : 20，10，30 


Console.WriteLine("{1}, {0}, {2}", 10, 20, 30); 
3.3.3 格式 化 数值 数据 


如 果 数 值 数 据 需 要 更 精细 的 格式 化 , 每 一 个 占 位 符 都 可 以 ( 可 选 地 ) 包含 不 同 的 格式 字符 ， 表 3-3 
显示 了 最 常用 的 格式 化 选项 。 


表 3-3 ” .NET 数值 格式 字符 


字符 串 格式 字符 作 用 
(或 c 用 于 格式 化 货币 。 默 认 情 况 下 ， 这 个 标志 会 以 当地 的 货币 符号 为 前 级 ( 美国 英语 中 是 一 个 美元 
符号 [$] ) 
0 或 d 用 于 格式 化 十 进 制 数 。 这 个 标志 还 可 以 用 于 指定 填充 值 的 最 小 个 数 
E 或 e 用 于 指数 记 数 法 。 无 论 指数 常数 是 大 写 (E ) 还 是 小 写 (e )， 都 进行 转换 控制 
F 或 f 用 于 定点 小 数 的 格式 化 。 这 个 标志 也 用 于 指定 填充 值 的 最 小 个 数 
6 或 g 代表 general。 这 个 字符 能 用 来 将 一 个 数 格式 化 为 定点 或 指数 格式 
N 或 n 用 于 基本 的 数值 格式 化 ( 带 逗 号 ) 
x 或 x 用 于 十 六 进 制 格式 化 。 如 果 使 用 大 写 的 x， 十 六 进 制 格 式 也 会 包含 大 写 的 字符 


给 定 的 占 位 符 值 以 冒号 为 标记 ,将 这 些 字符 作为 后 级 (例如 ，{0:C}、{1:d}、{2:X} )。 修改 Main() 
方法 以 调用 一 个 名 为 FormatNumericalData() 的 新 辅助 也 数 , 从 而 格式 化 一 个 固定 值 。 实现 方法 有 很 多 ， 
例如 : 


// 使 用 一 些 格 式 化 标记 

static void FormatNumericalData() 

{ 
Console.WritelLine("The value 99999 in various formats:"); 
Console.WritelLine("c format: {0:c}", 99999); 
Console.WritelLine("d9 format: {0:d9}", 99999); 
Console.WritelLine("f3 format: {0:f3}", 99999); 
Console.WriteLine("n format: {0:n}", 99999); 


// 注意 ,十 六 进 制 数 的 大 小 写 形式 决定 了 字母 是 大 写 还 是 小 写 
Console.Writeline("E format: {0:E}", 99999); 
Console.WritelLine("e format: {0:e}", 99999); 
Console.WritelLine("X format: {0:X}", 99999); 
Console.WriteLine("x format: {0:x}", 99999); 

} 


下 面 的 输出 显示 了 调用 FormatNumericalData() 方 法 的 结果 。 
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Pe ES 


The value 99999 in various formats: 


He 





c format: $99,999.00 

d9 format: 000099999 

f3 format: 99999.000 

n format: 99,999.00 

E format: 9.999900E+004 
e format: 9.999900e+004 
X format: 1869F 

x format: 1869f 


TSR 


在 本 书 中 其 他 地 方 还 会 有 其 他 格式 化 的 示例 。 但 如 果 你 想 进 一 步 深 入 学 习 .NET 字 符 串 格式 化 ,可 
以 查阅 .NET Framework 4.5 SDK 文 档 中 的 Formatting Types ( 格式 化 类 型 ) 主题 。 





源 代 码 “BasicConsoleIO 项 目 i he 3 子 目 录 下 。 








3.3.4 在 控制 台 应 用 程序 外 格式 化 数值 数据 


最 后 说 明 一 下 , .NET 字 符 串 格式 化 字符 不 局 限于 在 控制 台 程 序 中 使 用 ! 同样 的 格式 化 语法 可 以 在 
调用 静态 的 string.Format() 方 法 时 使 用 。 如 果 我 们 需要 对 任何 应 用 程序 类 型 ( 如 桌面 GUI 程序 、 
ASPNET Web 程 序 ) 在 运行 时 组 合 文本 数据 ， 这 个 方法 就 很 有 用 。 

string.Format() 返 回 一 个 新 的 字符 串 对 象 ， 改 对 象 根据 提供 的 标志 进行 格式 化 。 此 后 ， 我 们 就 可 以 随 
意 使 用 需要 的 文本 数据 了 。 人 例如， 假设 我 们 在 构建 一 个 图 形 化 的 WPF 桌 面 应 用 程序 ， 需 要 格式 化 一 个 
字符 串 ， 用 于 在 消息 对 话 框 中 显示 , 下面 的 代码 显示 了 如 何 做 到 ， 但 需要 注意 ， 在 引用 
PresentationFramework.dll 程 序 集 之 后 才能 编译 代码 , 这 样 才能 在 随后 的 项 目 中 使 用 (参见 第 2 章 有 关 使 
用 Visual Studio 引 用 库 的 信息 ): 

static void DisplayMessage() 

// 使 用 string.Format() 来 格式 化 字符 串 字面 量 


string userMessage = string.Format("100000 in hex is {0:x}", 
100000); 


// 可 能 需要 引用 PresentationFramework.d11 才 能 编译 这 行 代码 
System.Windows.MessageBox.Show(userMessage); 


3.4 系统 数据 类 型 和 相应 的 C# 关 键 字 


和 任何 编程 语言 一 样 ，C# 和 定义 了 一 组 用 于 表示 局 部 变量 、 成 员 变量 、 返 回 值 以 及 输入 参数 的 基本 
数据 类 型 。 然 而 ， 和 其 他 编程 语言 不 同 的 是 ， 这 些 关 键 字 不 只 是 简单 的 编译 器 可 以 识别 的 标记 。C# 
数据 类 型 关键 字 其 实 是 System 命名 空间 中 完整 类 型 的 简化 符号 。 表 3-4 列 出 了 每 一 个 系统 数据 类 型 、 它 
们 的 范围 、 对 应 的 C# 关 键 字 以 及 类 型 是 否 遵循 CLS ( 公共 语言 规范 )。 
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说 明 第 1 章 介绍 过 ， 符 合 CLS 的 .NET 代 码 可 以 被 任何 托管 编程 语言 使 用 。 如 果 在 你 的 程序 中 出 现 了 
不 符合 CLS 的 数据 ， 那 么 其 他 语言 可 能 就 不 能 使 用 它们 。 


表 3-4 ”C# 内 建 系统 类 型 


C# 简 化 符号 。” 判断 符合 CLS 。 ”系统 类 型 范 作 用 
bool 是 System.Boolean true 或 false 表示 真实 的 或 者 虚假 的 
sbyte 否 System.SByte —128~127 带 符号 的 8 位 数 
byte 是 System.Byte C0~255 无 符号 的 8 位 数 
short 是 System.Int16 -32 768~32 767 带 符 号 的 16 位 数 
ushort 否 System.UInt16 0~65 535 无 符号 的 16 位 数 
int 是 System. Int32 -2 147 483 648~2 147 483 647 带 符号 的 32 位 数 
uint 否 System.UInt32 0~4 294 967 295 无 符号 的 32 位 数 
long 是 System.Int64 -9223 372 036 854 775 808~ 带 符号 的 64 位 数 


9 223 372 036 854 775 807 


ulong 否 System.UInt64 ”0~18 446 744 073 709 551 615 无 符号 的 64 位 数 

char 是 System.Char U+0000~U+ffff 一 个 16 位 的 Unicode 字 符 

float 是 System.Single 。 -3.4x 1088~ +3.4x 10388 32 位 浮 点 数 

double 是 System.Double ~5.0x103+1.7x10% 64 位 浮 点 数 

decimal 是 System.Decimal 。 (-7.9 x 10*~7.9x 1028)/(1009-28) 128 位 带 符号 数 

string 是 System.String 。” 受 系统 内 存 的 限制 表示 一 个 Unicode 字 符 集合 

object 是 System.0bject 。 任何 类 型 都 可 以 保存 在 一 个 object NET 世界 中 所 有 类 型 的 基 类 
变量 中 








说 明 默认 情况 下 ， 浮 点 数 被 当做 double 类 型 。 为 了 声明 一 个 float 变 量 ， 使 用 后 缓 f 或 F 可 以 在 原始 的 
数值 后 面 加 上 ff 或 F( 如 5.3F ); 使 用 后 缀 m 或 者 M 可 以 将 一 个 浮 点 数 声明 为 十 进 制 ( 如 330.5M )。 同 
样 ， 原始 整数 在 默认 情况 下 为 nt 数据 类 型 。 要 将 其 设置 为 long 类 型 ， 可 使 用 后 组 1 或 L ( 如 4L )。 





3.4.1 变量 声明 和 初始 化 


如 果 需 要 声明 一 个 数据 类 型 作为 局 部 变量 ( 如 成 员 体内 的 变量 )， 可 以 通过 在 变量 名 之 前 指定 数 
据 类 型 来 实现 。 首 先 创 建 一 个 名 为 BasicDataTypes 的 控制 台 应 用 程序 项 目 。 更 新 program 类 ， 使 其 具有 
如 下 的 辅助 方法 ， 此 方法 在 Main() 中 调用 : 


static void LocalVarDeclarations() 


Console.WritelLine("=> Data Declarations:"); 
// 局 部 变量 这 样 进行 声明 : 数据 类 型 变量 名 
int myInt; 

string myString; 


66 第 3 章 “C# 核 心 编程 结构 


Console.WriteLine(); 


要 知道 ， 如 果 在 分 配 初始 值 之 前 使 用 局 部 变量 ， 会 收 到 一 个 编译 器 错误 。 因 此 ， 声 明 时 为 局 部 数据 
赋 一 个 初始 值 是 一 个 好 的 做 法 。 我 们 可 以 在 单行 中 这 么 做 , 也 可 以 将 声明 和 赋值 分 开 到 两 行 代码 语句 中 : 


static void LocalVarDeclarations() 


Console.WritelLine("=> Data Declarations:"); 
// 局 部 变量 在 如 下 代码 中 声明 和 初始 化 

// 数据 类 型 变量 名 = 初始 值 

int myInt = 0; 


// 我 们 还 可 以 在 两 行 中 声明 和 赋值 


string myString; 
myString = "This is my character data"; 


Console.WritelLine(); 


还 人 允许 在 一 行 代码 中 声明 多 个 具有 相同 实际 类 型 的 变量 ， 如 下 所 示 的 3 个 布尔 型 变量 : 
static void LocalVarDeclarations() 


Console.WritelLine("=> Data Declarations:"); 
int myInt = 0; 

string myString; 

myString = "This is my character data"; 


// 在 一 行 中 声明 3 个 布尔 型 数据 
bool b1 = true, b2 = false, b3 = b1; 
Console.WritelLine(); 


同样 ， 由 于 C# bool 关 键 字 只 是 System.Boolean 结 构 的 简化 符号 ， 因 此 可 以 使 用 它们 的 全 名 来 分 配 
任何 数据 类 型 ( 当然 ， 对 于 任何 C# 数 据 类 型 关键 字 来 说 ， 这 点 都 是 正确 的 )。 以 下 是 Localvar- 
Declarations() 的 最 终 实现 : 

static void LocalVarDeclarations() 

Console.WriteLine("=> Data Declarations:"); 
// 局 部 变量 声明 和 初始 化 方式 : 数据 类 型 变量 名 = 初始 值 
int myInt = 0; 


string myString; 
myString = "This is my character data"; 


// 在 一 行 声 明 3 个 布尔 型 数据 
bool b1 = true, b2 = false, b3 = bi1; 


// 使 用 系统 数据 类 型 声明 布尔 型 变量 
System.Boolean b4 = false; 


Console.WriteLine("Your data: {0}, {1}, {2}, {3}, {4}, {5}", 
myInt, myString, b1, b2, b3, b4); 


Console.WriteLine(); 
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3.4.2 ”内 建 数据 类 型 与 new 操 作 符 


所 有 的 内 建 数据 类 型 都 支持 默认 构造 函数 ( 见 第 5 章 )。 简 而 言 之 ， 这 个 特性 允许 我 们 使 用 new 关 
键 字 来 创建 变量 ， 它 将 变量 自动 设置 为 其 默认 值 。 

口 bool 类 型 设置 为 false; 

口 数值 类 型 设置 为 0 ( 如 果 是 浮 点 数 ， 则 设置 为 0.0 ); 

口 char 类 型 设置 为 单个 空 字 符 ; 

口 BigInteger 变 量 设置 为 0; 

口 DateTime 类 型 设置 为 1/1/0001 12:00:00 AM; 

口 对 象 引 用 (包括 string ) 设置 为 nul1。 


说 明 稍 后 将 冰 述 上 面 列 出 的 BigInteger 数 据 类 型 。 


尽管 使 用 new 关 键 字 创 建 基本 数据 类 型 的 变量 显得 很 笨重， 如 下 代码 却 是 可 行 的 C# 代 码 : 
static void NewingDataTypes() 


Console.WritelLine("=> Using new to create variables:"); 


bool b = new bool(); // 设置 为 false 

int i = new int(); // 设置 为 0 

double d = new double(); // 设置 为 0 

DateTime dt = new DateTime(); // 设置 为 1/1/0001 12:00:00 AM 


Console.WritelLine("{0}, {1}, {2}, {3}", b, i, d, dt); 
Console.Writeline(); 


} 


3.4.3 ”数据 类 型 类 的 层次 结构 


要 注意 很 有 趣 的 一 点 是 ，.NET 的 基本 数据 类 型 都 有 一 个 类 层次 结构 。 如 果 你 刚 接触 继承 的 话 ， 可 
以 在 第 6 章 中 找到 详细 的 内 容 。 在 这 里 ， 只 需要 理解 处 于 类 层次 结构 顶端 的 类 型 会 为 派生 类 型 提供 一 
些 默认 行为 。 这 些 核 心 系统 类 型 之 间 的 关系 如 图 3-2 所 示 。 

注意 , 所 有 这 些 类 型 都 派生 自 System.0bject, 它 定 义 了 一 组 .NET 基 础 类 库 中 所 有 类 型 都 具有 的 方 
法 (如 ToString()、Equals()、GetHashCode() 等 ， 在 第 6 章 中 会 详细 介绍 这 些 方法 )。 

还 要 注意 ， 很 多 数值 数据 类 型 都 派生 自 system.ValueType 类 。 派 生 自 ValueType 的 类 型 都 会 自动 在 
栈 上 进行 分 配 ， 因 此 有 一 个 可 预测 的 生命 周期 ， 而 且 非 常 高 效 。 男 一 方面 ， 在 继承 链 上 没有 
System.ValueType 的 类 型 ( 如 System.Type 、System.String 、System.Array 、System.Exception 以 及 
System.Delegate ) 不 会 在 栈 上 分 配 ， 而 是 在 垃圾 回收 堆 上 进行 分 配 。 

在 此 , 我 们 不 会 过 多 涉及 System.0bject 和 System.ValueType 的 细节 ， 只 需要 理解 由 于 C# 关 键 字 
(如 int ) 只 是 相应 系统 类 型 ( 这 里 是 System.Int32 ) 的 简化 符号 ， 并 且 System.Int32 (C# 中 的 int ) 
最 终 派 生 自 System.0bject, 也 就 可 以 调用 它 的 任何 公有 成 员 , 如 下 所 示 的 额外 辅助 函数 可 以 说 明 这 
一 点 儿 : 
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static void ObjectFunctionality() 
{ 


Console.Writeline("=> System.0bject Functionality:"); 


// C# int 是 System.Int32 的 简化 ， 它 继承 了 System.0bject 的 如 下 成 员 
Console.WriteLine("12.GetHashCode() = {0}", 12.GetHashCode()); 
Console.WritelLine("12.Equals(23) = {0}", 12.Equals(23)); 
Console.Writeline("12.ToString() = {0}", 12.ToString()); 
Console.WritelLine("12.GetType() = {0}", 12.GetType()); 


Console.WritelLine(); 


Oe 


Type 
String 
Array ValueType 
任何 继承 自 
ValueType 的 
Exception 类 型 都 是 结 
构 或 枚 举 ， 
Delegate 不 是 类 
MaulticastDelegate 


个 


枚 举 和 结构 


| 


图 3-2 ”系统 类 型 的 类 层次 结构 


如 果 在 Main() 方 法 中 调用 这 个 方法 ， 就 会 得 到 如 下 所 示 的 输出 结果 。 





=> System.Object Functionality: 


12.GetHashCode() = 12 
12.Equals(23) = False 
12.ToString() = 12 
12.GetType() = System.Int32 


er me re er 


DateTime 
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3.4.4 数值 数据 类 型 的 成 员 


为 了 继续 研究 内 建 的 C# 数 据 类 型 ， 必 须知 道 .NET 的 数值 类 型 支持 MaxValue 和 MinValue 属 性 ， 这 两 
个 属性 说 明了 给 定 的 类 型 可 以 存储 的 范围 。 除 了 MinValue/MaxValue 属 性 之 外 ,一 个 给 定 的 系统 数据 类 
型 还 可 能 定义 其 他 更 有 用 的 成 员 。 例 如, 使 用 System.Double 类 型 可 以 获取 最 小 正 数 和 无 穷 大 数 ( 这 些 
可 能 是 喜爱 数学 的 你 所 感 兴趣 的 )。 看 看 下 面 的 辅助 方法 : 


static void DataTypeFunctionality() 
Console.WriteLine("=> Data type Functionality:"); 


Console.WritelLine("Max of int: {0}", int.MaxValue); 
Console.WritelLine("Min of int: {0}", int.MinValue); 
Console.WriteLine("Max of double: {0}", double.MaxValue); 
Console.WritelLine("Min of double: {0}", double.MinValue); 
Console.WritelLine("double.Epsilon: {0}", double.Epsilon); 
Console.WriteLine("double.PositiveInfinity: {0}", 
double.PositiveInfinity); 
Console.WritelLine("double.NegativeInfinity: {0}", 
double.NegativeInfinity); 
Console.WritelLine(); 


} 


3.4.5 ”System.Boolean 的 成 员 


下 面 考 虑 System.Boolean 数 据 类 型 。C# 的 boo1 类 型 的 值 只 能 来 自 集合 {true|false}。 基 于 这 一 点 , 应 
该 明确 System.Boolean 不 支持 性 nValue/MaxValue 属 性 集合 ， 但 是 支持 TrueString/ FalseString 属 性 集合 
(相应 地 返回 True 或 False )。 将 以 下 语句 添加 到 DataTypeFunctionality() 辅 助 方法 中 : 


Console.WritelLine("bool.FalseString: {0}", bool.FalseString); 
Console.WriteLine("bool.TrueString: {0}", bool.TrueString); 


3.4.6 ”System.Char 的 成 员 


C# 的 文本 数据 是 由 string 和 char 关 键 字 表示 的 ， 它 们 是 System.String 和 System.Char 的 简化 符号 ， 
二 者 都 是 基于 Unicode 的 。string 表 示 一 组 连续 的 字符 ( 如 "Hello" )， 而 char 则 表示 string 类 型 中 的 单 
个 字符 ( 如 'H' )。 

System.Char 类 型 除了 保存 一 个 字符 数据 之 外 ,还 提供 了 大 量 的 功能 ,使 用 System.Char 的 静态 方法 ， 
可 以 判定 一 个 给 定 的 字符 是 否 是 数字 、 字 母 、 标 点 符号 或 其 他 。 看 一 下 下 面 的 代码 : 

static void CharFunctionality() 


Console.WriteLine("=> char type Functionality:"); 


char myChar = 'a'; 

Console.WriteLine("char.IsDigit('a'): {0}", char.IsDigit(myChar)); 

Console.WritelLine("char.IsLetter('a'): {0}", char.IsLetter(myChar)); 

Console.WriteLine("char.IsWhiteSpace('Hello There', 5): {0}", 
char.IsWhiteSpace("Hello There", 5)); 

Console.WriteLine("char.IsWhiteSpace('Hello There', 6): {0}", 
char.IsWhiteSpace("Hello There", 6)); 
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Console.WritelLine("char.IsPunctuation('?'): {0}", 
char.IsPunctuation('?')); 
Console.WritelLine(); 


可 见 , 这 些 System.Char 的 静态 成 员 中 的 每 一 个 都 有 两 个 调用 约定 : 一 个 字符 或 是 一 个 字符 串 ， 该 
字符 串 带 一 个 指定 要 测试 的 字符 所 在 位 置 的 数值 索引 。 


3.4.7 ”从 字符 串 数据 中 解析 数值 


我 们 也 知道 .NET 数 据 类 型 提供 了 一 种 能 力 ， 即 通过 给 定 文本 生成 (例如 解析 ) 相应 的 底层 类 型 的 
变量 。 这 个 技术 在 想 把 用 户 输入 的 数据 ( 例如 基于 GUI 的 下 拉 列 表 中 的 选择 ) 转换 成 一 个 数值 时 非常 
有 用 。 考 虑 下 面 ParseFromStrings() 方 法 中 的 解析 逻辑 ; 


static void ParseFromStrings() 
Console.WriteLine("=> Data type parsing:"); 


bool b = bool.Parse("True"); 
Console.WriteLine("Value of b: {0}", b); 
double d = double.Parse("99.884"); 
Console.WritelLine("Value of d: {0}", d); 
int i = int.Parse("8"); 
Console.WritelLine("Value of i: {0}", i); 
char c = Char.Parse("w"); 
Console.WriteLine("Value of c: {0}", c); 
Console.WriteLine(); 


} 


3.4.8 System.DateTime 和 System.TimeSpan 


System 命名 空间 定义 了 很 多 有 用 的 数据 类 型 ， 对 于 这 些 类 型 ， 没 有 C# 关 键 字 ， 比 如 DateTime 和 
TimeSpan 结 构 ( 对 于 图 3-2 所 示 的 System.Guid 和 System.Void 的 研究 就 留 给 感 兴趣 的 读者 , 但 要 注意 System 
命名 空间 中 的 这 两 种 数据 类 型 在 多 数 应 用 程序 中 基本 不 用 )。 

DateTime 类 型 包含 了 表示 某 个 日 期 (月 、 日 、 年 ) 的 数据 以 及 时 间 值 ， 可 以 使 用 指定 的 成 员 以 各 
种 形式 将 它们 格式 化 。TimeSpan 结 构 允许 你 方便 地 使 用 各 个 成 员 定 义 和 转 换 时 间 单 位 : 


static void UseDatesAndTimes() 
Console.WritelLine("=> Dates and Times:"); 


// 这 个 构造 函数 接受 年 、 月 、 日 
DateTime dt = new DateTime(2011, 10, 17); 


// 它 是 一 个 月 中 的 哪 一 天 
Console.WriteLine("The day of {0} is {1}", dt.Date, dt.DayOfWeek); 


// 月 份 现在 是 12 月 
dt = dt.AddMonths(2); 
Console.Writeline("Daylight savings: {0}", dt.IsDaylightSavingTime()); 


// 构造 函数 接受 小 时 、 分 钟 和 秒 
TimeSpan ts = new TimeSpan(4, 30, 0); 
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Console.WriteLine(ts); 


// 从 当前 TimeSpan 减 去 15 分 钟 并 且 输 出 结果 
Console.WriteLine(ts.Subtract(new TimeSpan(0, 15, 0))); 


3.4.9 System.Numerics.dll 程 序 集 


System.Numerics 命 名 空间 定义 了 BigInteger 结 构 。 顾 名 思 义 ，BigInteger 数 据 类 型 可 用 来 表示 极 
大 的 数值 ， 它 没有 固定 的 上 下 限 。 


说 明 System.Numerics 命 名 空间 还 定义 了 一 个 Complex 结 构 ， 用 来 对 数学 中 的 复数 数据 进行 建 模 ( 如 虚 
部 数据 、 实 部 数据 、 双 曲 正 切 数 )。 如 果 感 兴趣 的 话 ， 可 以 查阅 .NET Framework 4.5 SDK 文 档 。 


尽管 大 多 数 .NET 应 用 程序 都 不 需要 使 用 BigInteger 结 构 ， 但 一 旦 需要 定义 较 大 的 数值 时 ， 你 要 做 
的 第 一 件 事 就 是 为 项 目 添加 System.Numerics.dl 程 序 集 的 引用 。 对 于 当前 示例 来 说 ， 需 要 执行 以 下 几 
个 步骤 。 

(1) 在 Visual Studio 中 选择 Project 一 Add Reference... 菜 单 选项 。 

(2) 在 当前 库 的 列表 中 找到 并 选择 System.Numerics.dll 程 序 集 。 

(3) 单 击 Add 和 Close 按 钮 。 

然后 ， 在 文件 中 添加 如 下 的 using 指 令 ， 此 时 将 使 用 BigInteger 数 据 类 型 : 


// BigInteger 在 这 里 面 
using System.Numerics; 


此 时 就 可 以 使 用 new 操 作 符 来 创建 BigInteger 变 量 了 。 在 构造 函数 中 , 可 以 指定 包含 浮 点 数据 在 内 
的 数值 。 但 是 , 当 你 定义 一 个 整数 时 ( 如 500 ), 运行 时 将 其 默认 设 为 int 数 据 类 型 。 同 样 , 浮 点 数据 ( 如 
55.333 ) 将 默认 设 为 double 类 型 。 那 么 ， 如 何 将 BigInteger 设 置 为 大 数 ， 才 能 使 那些 用 于 表示 原始 数 
值 的 默认 数据 类 型 不 会 溢出 呢 ? 

最 简单 的 方式 是 将 大 数值 作为 文本 字面 量 ， 使 用 静态 的 Parse() 方 法 将 其 转换 为 BigInteger 变 量 。 
如 果 和 需要， 还 可 以 向 BigInteger 类 的 构造 函数 直接 传递 字 节 数组 。 


说 明 ”由 于 BigInteger 是 不 可 交 的 ( immutable )， 因 此 一 旦 设置 了 BigInteger 变 量 的 值 ， 就 不 能 改变 
它 了 。 但 是 ，BigInteger 类 定义 了 大 量 方法 ， 根 据 对 数据 的 修改 返回 新 的 BigInteger 对 象 ( 例 
如 下 面 代码 中 的 静态 方法 Multiply() )。 


定义 了 BigInteger 变 量 之 后 ， 你 会 发 现 该 类 的 成 员 与 其 他 固有 的 C# 数 据 类 型 ( 如 float 、int ) 的 
成 员 十 分 类 似 。 此 外 ，BigInteger 还 定义 了 一 些 静 态 成 员 ， 用 来 对 BigInteger 变 量 应 用 基本 的 数学 表 
达 式 ( 如 加 法 和 乘法 )。 下 面 是 使 用 BigInteger 类 的 示例 : 


static void UseBigInteger() 


Console.WritelLine("=> Use BigInteger:"); 
BigInteger biggy = 
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BigInteger.Parse("9999999999999999999999999999999999999999999999"); 
Console.WriteLine("Value of biggy is {0}", biggy); 
Console.WritelLine("Is biggy an even value?: {0}", biggy.IsEven); 
Console.WriteLine("Is biggy a power of two?: {0}", biggy.IsPowerOfTwo); 


BigInteger reallyBig = BigInteger.Multiply(biggy, 
BigInteger.Parse("888888888888888888883388833333383383833333833" ) ) ; 


Console.WriteLine("Value of reallyBig is {0}", reallyBig); 


同样 重要 的 是 ，BigInteger 数 据 类 型 能 够 响应 C# 基 本 的 数学 操作 符 ， 如 +、- 和 *#。 因 此 ， 在 对 两 
个 大 数 执行 乘法 运算 时 ， 不 必 调 用 BigInteger.Multiply()， 而 只 需 使 用 下 面 的 代码 : 

BigInteger reallyBig2 = biggy * reallyBig; 

现在 , 我 希望 你 能 了 解 的 是 , 对 于 每 一 个 表示 基本 数据 类 型 的 C# 关 键 字 , .NET 基 础 类 库 中 都 有 一 
个 类 型 与 之 对 应 ， 每 个 类 型 都 有 其 固定 的 功能 。 虽然 我 没有 详细 介绍 这 些 数据 类 型 的 各 个 成 员 , 但 如 
果 感 兴趣 的 话 , 你 可 以 详细 了 解 它们 。 关 于 不 同 .NET 数 据 类 型 的 详细 内 容 , 可 以 参考 .NET Framework 4.5 
SDK 文 档 你 肯定 会 惊叹 如 此 数量 的 内 置 功能 。 





源 代 码 ”BasicDataTypes 项 目的 源 代码 位 于 Chapter 3 子 目 录 下 。 





3.5 ”使 用 字符 串 数据 


System.String 提 供 了 很 多 你 原来 期 望 工具 类 提供 的 方法 ,包括 返回 字符 数据 长 度 、 查 找 当 前 字符 
串 中 子 字符 串 、 转 换 大 小 写 等 方法 。 表 3-5 列 出 了 一 些 (但 不 是 全 部 ) 常见 成 员 。 


表 3-5 System.String 的 部 分 成 员 





字符 串 成 员 作 用 

Length 这 个 属性 返回 当前 字符 串 的 长 度 

Compare() 这 个 方法 比较 两 个 字符 串 

Contains() 这 个 方法 用 于 判定 当前 字符 串 是 否 包含 一 个 指定 的 子 字符 串 

Equals() 这 个 方法 测试 两 个 字符 串 对 象 是 否 含有 同样 的 字符 数据 

Format() 这 个 静态 方法 使 用 本 章 前 面 分 析 过 的 其 他 基本 类 型 ( 如 数值 数据 和 其 他 字符 串 ) 和 {0} 符 号 以 格 
式 化 一 个 字符 串 

Insert() 这 个 方法 用 来 将 一 个 字符 串 插 入 到 给 定 字 符 串 中 

PadLeft() 这 两 个 方法 用 来 在 字符 串 内 填充 字符 

PadRight() 

Remove() 使 用 这 些 方 法 来 接收 一 个 带 有 修改 ( 被 删除 或 替换 的 字符 ) 的 字符 串 的 副本 

Replace() 

Split() 这 个 方法 返回 的 String 数 组 包含 这 个 实例 中 由 指定 的 Char 或 string 数 组 的 元 素 分 隔 的 子 字符 串 

Trim() 这 个 方法 从 当前 字符 串 的 头 部 和 尾部 移 除 所 有 出 现 的 一 组 指定 字符 

ToUpper() 这 两 个 方法 创建 一 个 给 定 字符 串 的 大 写 或 小 写 副 本 


ToLower() 
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3.5.1 基本 的 字符 串 操作 


就 像 我 们 期 望 的 那样 , 使 用 System.string 的 成 员 只 需要 创建 字符 串 数据 类 型 ， 然 后 通过 点 操作 符 
使 用 所 提供 的 功能 。 要 知道 ， 有 些 System.String 的 成 员 都 是 静态 成 员 ， 也 因此 在 类 级 别 〈 而 不 是 对 象 
级 别 ) 进行 调用 。 假 设 我 们 新 建 了 一 个 名 为 FunWithStrings 的 控制 台 应 用 程序 ， 编 写 如 下 方法 ， 并 在 
Main() 中 进行 调用 : 

static void BasicStringFunctionality() 


Console.WritelLine("=> Basic String functionality:"); 

string firstName = "Freddy"; 

Console.Writeline("Value of firstName: {0}", firstName); 

Console.Writeline("firstName has {0} characters.", firstName.Length); 

Console.WritelLine("firstName in uppercase: {0}", firstName.ToUpper()); 

Console.WriteLine("firstName in lowercase: {0}", firstName.ToLower()); 

Console.WriteLine("firstName contains the letter y?: {0}", 
firstName.Contains("y")); 

Console.Writeline("firstName after replace: {0}", firstName.Replace("dy", "")); 

Console.WritelLine(); 


这 里 不 多 说 什么 了 ， 因 为 这 个 方法 只 是 调用 了 字符 串 本 地 变量 上 的 各 种 成 员 ( 如 ToUpper()、 
Contains() 等 ) 来 产生 各 种 格式 和 转换 。 下 面 是 初始 输出 。 





六 六 冰冰 六 Fun with Strings ***** 


=> Basic String functionality: 

Value of firstName: Freddy 

firstName has 6 characters. 

firstName in uppercase: FREDDY 
firstName in lowercase: freddy 
firstName contains the letter y?: True 
firstName after replace: Fred 





虽然 这 些 输出 结果 并 不 意外 ， 但 Replace() 方 法 的 调用 结果 可 能 会 让 人 误解 。 实 际 上 ，firstName 
变量 根本 没有 改变 。 我 们 得 到 的 是 修改 后 的 新 的 string。 稍 后 ， 我 们 将 重 温 字 符 串 的 这 种 不 可 变性 。 


3.5.2 ”字符 串 拼接 


字符 串 变 量 可 以 通过 C# 的 + 操作 符 连 接 在 一 起 来 构建 一 个 更 大 的 字符 串 变 量 。 你 可 能 知道 ， 这 项 
技术 正式 的 名 称 是 字符 串 拼接 ( string concatenation )。 下 面 来 看 一 下 新 的 辅助 函数 : 


static void StringConcatenation() 


Console.WriteLine("=> String concatenation:"); 
string s1 = "Programming the "; 

string s2 = "PsychoDrill (PTP)"; 

string s3 = S1 + s2; 

Console.WritelLine(s3); 

Console.WriteLine(); 
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C# 的 + 符号 会 被 编译 器 处 理 为 对 String.Concat() 方 法 的 调用 。 因 此 ， 也 可 以 直接 调用 
String.Concat() 来 进行 字符 串 拼 接 操 作 ( 尽管 这 么 做 确实 没有 什么 好 处 一 一 要 多 敲 几 次 键盘 ): 


static void StringConcatenation() 





Console.WritelLine("=> String concatenation:"); 
string s1 = "Programming the "; 

string s2 = "PsychoDrill (PTP)"; 

string s3 = String.Concat(s1, s2); 
Console.WritelLine(s3); 

Console.Writeline(); 


} 


3.5.3” 转 义 字 符 


与 其 他 基于 C 的 语言 一 样 ， 在 C# 字 符 串 字面 量 中 可 以 包含 各 种 转 义 字符 ， 用 来 限制 字符 数据 应 该 
怎样 被 输 到 输出 流 中。 每 个 转 义 字符 都 以 一 个 反 斜 线 开始 ， 后 跟 一 个 特殊 的 标记 。 也 许 你 对 这 些 转 义 
字符 的 意义 不 太 了 解 ， 表 3-6 列 出 了 最 常用 的 选项 。 


表 3-6 ”字符 串 字面 量 的 转 义 字符 


字 符 作 用 
\ 将 一 个 单 引 号 插入 字符 串 字 面 量 
YW 将 一 个 双 引 号 插入 字符 串 字 面 量 
\\ 将 一 个 反 斜 线 插入 字符 串 字 面 量 。 这 在 定义 文件 或 网 络 路 径 时 很 有 用 
\a 触发 一 个 系统 警报 ( 蜂 鸣 ) 。 对 控制 台 应 用 程序 来 说 ， 这 能 给 用 户 提供 一 个 声音 提示 
Nn 换行 (在 Windows 平 台 上 ) 
\r 回 车 
\t 将 一 个 水 平 制 表 符 插入 字符 串 字 面 量 


例如 ， 为 了 输出 在 每 一 个 单词 间 都 包含 一 个 制 表 符 的 字符 串 ， 可 以 使 用 \t 转 义 字 符 。 假 设想 创建 
一 个 包含 引号 的 字符 串 字 面 量 ， 一 个 定义 目录 路 径 的 字符 串 字 面 量 以 及 一 个 在 输出 字符 数据 后 插 人 3 
个 空 行 的 字符 串 字 面 量 。 为 了 这 样 做 且 不 引起 编译 器 错误 ,需要 使 用 \"、\\ 和 \n 转 义 字符 。 同 样 ， 为 
了 干扰 半径 为 10 英 尺 的 范围 内 的 所 有 人 ,我 在 每 一 个 字符 串 字面 量 中 都 诅 入 了 一 个 警报 ( 触发 一 声 蜂 
鸣 )。 参考 如 下 代码 : 


static void EscapeChars() 


Console.WritelLine("=> Escape characters:\a"); 
string strwithTabs = "Model\tColor\tSpeed\tPet Name\a "; 
Console.Writeline(strwithTabs); 


Console.WriteLine("Everyone loves \"Hello World\"\a "); 
Console.WritelLine("C:\\MyApp\\bin\\Debug\a "); 


// 添加 4 个 空 行 ， 然 后 发 出 一 声 蜂 鸣 
Console.WriteLine("All finished.\n\n\n\a "); 
Console.WritelLine(); 
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3.5.4 ”定义 逐 字 字符 串 

C# 引 入 了 以 @ 为 前 级 的 字符 串 字面 量 记 法 ,术语 称 为 逐 字 字符 囊 ( verbatim string )。 使 用 逐 字 字符 
串 ， 可 以 使 对 一 个 字面 量 的 转 义 字符 的 处 理 失效 并 输出 字符 串 。 这 在 使 用 表示 目录 和 网 络 路 径 的 字符 
串 时 最 有 用 。 因 此 ， 不 需要 使 用 \\ 转 义 字 符 ， 可 以 简单 地 按 如 下 写 代码 : 


// 下 面 的 字符 串 被 逐 字 输出 ， 所 有 的 转 义 字符 都 被 显示 出 来 了 
Console.Writeline(@"C:\MyApp\bin\Debug"); 
还 要 注意 逐 字 字符 串 可 以 用 来 为 持续 很 多 行 的 字符 串 保 留 空格 : 
// 使 用 逐 字 字 符 事 ， 空 格 被 保留 了 
string myLongString = @"This is a very 

very 


very 
long string"; 
Console.WritelLine(myLongString); 


还 可 以 通过 重复 "标记 向 一 个 字面 量 字 符 串 插入 一 个 双 引 号 : 


Console.WritelLine(@"Cerebus said ""Darrr! Pret-ty sun-sets"""); 


3.5.5 ”字符 串 和 相等 性 


在 第 4 章 中 我 们 会 详细 介绍 ， 引 用 类 型 是 在 垃圾 回收 托管 堆 上 分 配 的 对 象 。 默 认 情 况 下 ， 当 我 们 
对 引用 类 型 进行 相等 性 测试 (通过 C# == 和 != 操 作 符 ) 时 ， 如 果 引 用 类 型 指向 内 存 中 的 相同 对 象 , 则 返 
回 true。 然 而 ， 尽 管 string 数 据 类 型 确实 是 引用 类 型 ， 但 是 相等 性 操作 符 已 经 被 重 定义 为 比较 字符 串 
对 象 的 值 ， 而 不 是 内 存 中 它们 引用 的 对 象 : 


static void StringEquality() 


Console.WritelLine("=> String equality:"); 
string s1 = "Hello!"; 

string s2 = "Yo!"; 

Console.WritelLine("s1 = {0}", s1); 
Console.WritelLine("s2 = {0}", s2); 
Console.WriteLine(); 


// 测试 这 些 字符 囊 的 相等 性 

Console.WritelLine("s1 == s2: {0}", s1 == s2); 
Console.Writeline("s1 == Hello!: {0}", si == "Hello!"); 
Console.Writeline("s1 == HELLO!: {0}", s1 == "HELLO!"); 
Console.WriteLine("s1 == hello!: {0}", s1 == "hello!"); 
Console.Writeline("s1.Equals(s2): {0}", s1.Equals(s2)); 
Console.WritelLine("Yo.Equals(s2): {0}", "Yo!".Equals(s2)); 
Console.Writeline(); 


注意 ,C# 相 等 性 操作 符 进 行 的 是 区 分 大 小 写 、 逐 字符 的 相等 性 测试 。 因此 , "Hello!"、"HELLO!" 
和 "hello1" 都 不 相等 。 同 样 ， 始 终 记 住 string 和 System.String 之 间 的 联系 ,要 指出 的 是 我 们 可 以 使 
用 String 的 Equals() 方 法 或 内 和 藤 的 相等 性 操作 符 进 行 相等 性 测试 。 最 后 ， 因 为 每 一 个 字符 串 字 面 量 
( 如 "Yo" ) 都 是 有 效 的 System.String 实 例 ， 所 以 我 们 可 以 从 一 个 固定 的 字符 序列 来 访问 字符 串 相关 
的 功能 。 
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3.5.6 ”字符 串 是 不 可 变 的 


System.String 一 个 有 趣 的 方面 是 ， 一 旦 将 初始 值 赋 给 字符 串 对 象 ， 字 符 数据 就 不 能 改变 了 。 乍 一 
看 , 这 可 能 像 是 一 个 明显 的 谎言 。 因 为 我 们 总 是 给 字符 串 赋 新 值 , 而 且 System.String 类 型 也 定义 了 许 
多 用 于 以 各 种 方式 ( 大 写 、 小 写 等 ) 修改 字符 数据 的 方法 。 然 而 ， 如 果 细 究 背 后 发 生 的 事情 ， 就 会 注 
意 到 string 类 型 的 方法 其 实 返回 了 一 个 修改 格式 的 新 字符 串 对 象 。 


static void StringsAreImmutable() 


// 设置 初始 字符 串 值 

string s1 = "This is my string. ; 
Console.WritelLine("s1 = {0}", s1); 

// 大 写 s1? 

string upperString = s1.ToUpper(); 
Console.WritelLine("upperString = {0}", upperString); 


// 不 | Sl 还 是 同样 的 格式 
Console.Writeline("s1 = {0}", s1); 


查看 上 述 代 码 相关 的 输出 ， 就 可 以 验证 原来 的 string 对 象 (s1 ) 在 调用 ToUpper() 之 后 没有 变 成 大 
写 ， 而 是 返回 修改 格式 的 字符 串 副 本 ， 如 下 所 示 。 





s1 = This is my string. 
upperString = THIS IS MY STRING. 
s1 = This is my string. 





如 果 我 们 使 用 C# 赋 值 操作 符 ， 同 样 的 不 变性 命题 还 是 成 立 的 。StringsAreImmutable2() 方 法 的 实 
现 过 程 可 以 说 明 这 个 问题 : 

static void StringAreImmutable2() 

string s2 = "My other string"; 


5s2 = "New string value"; 


现在 ,编译 应 用 程序 ， 然 后 把 程序 集 加 载 到 ildasm.exe 中 (参见 第 1 章 )。 下 面 的 输出 显示 了 为 
StringsAreImmutable2() 方 法 生成 CIL 代 码 后 的 结果 。 





.method private hidebysig static void StringsAreImmutable2() cil managed 


// 代码 大 小 14 (Oxe) 

.maxstack 1 

.locals init ([0] string s2) 

IL 0000: nop 

IL 0001: ldstr "My other string" 
IL 0006: stloc.0 

IL 0007: ldstr "New string value" 
IL O00c: stloc.0 

IL_000d: ret 


} // 结束 Program: :StringAreImmutable2 方 法 
pe 
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尽管 我 们 还 没有 研究 CIL 尾 层 的 一 些 细节 ， 但 是 要 注意 到 Main() 方 法 多 次 调用 了 1dstr ( 加 载 字符 
串 ) 操作 码 。 简 而 言 之 ，CIL 的 1dstr 操 作 码 在 托管 堆 上 加 载 了 一 个 新 的 字符 串 对 象 。 之 前 包含 值 "My 
other string" 的 字符 串 对 象 最 终 会 被 垃圾 回收 。 

那么 ， 我 们 能 从 中 得 出 什么 结论 呢 ? 简单 来 说 ，string 类 如 果 被 滥用 ， 它 就 会 变 得 低 效 ， 并 导致 
代码 膨胀 ， 特 别 是 进行 字符 串 拼接 的 时 候 。 如 果 我 们 需要 表示 在 应 用 程序 中 用 到 的 基本 字符 数据 ， 如 
美国 社会 安全 号 码 (SSN )、 姓 名 或 简单 字符 串 文本 等 ，string 类 就 是 很 好 的 选择 。 

然而 ,如 果 我 们 正在 构建 使 用 大 量 文本 数据 的 应 用 程序 ( 如 字 处 理 程序 ), 那么 使 用 String 对 象 来 
表示 字 处 理 数据 就 是 一 个 糟糕 的 主意 ， 因 为 我 们 最 后 很 可 能 (通常 是 间接 地 ) 产生 字符 串 数 据 不 必要 
的 副本 。 那 么 程序 员 该 怎么 做 呢 ?” 问 得 好 。 


3.5.7 System.Text.StringBuilder 类 型 


如 果 随便 弃 用 的 话 ，String 类 型 可 能 会 很 低 效 ， 因 此 .NET 基 础 类 库 提供 了 System.Text 命 名 空间 。 
在 这 个 ( 相对 较 小 的 ) 命名 空间 中 有 一 个 叫做 StringBuilder 的 类 。 和 System.String 类 相似 ， 
StringBuilder 定 义 了 很 多 用 来 替换 或 格式 化 片段 的 方法 。 如 果 我 们 和 希望 在 C# 代 码 文 件 中 使 用 这 个 类 
型 ， 第 一 步 就 是 导 和 人 正确 的 命名 空间 ( 对 于 一 个 新 的 Visual Studio 项 目 ， 这 一 步 应 该 已 经 完成 了 ): 
// StringBuilder 在 这 里 
using System.Text; 
StringBuilder 的 独特 之 处 在 于 ， 当 我 们 调用 这 个 类 型 的 成 员 时 ， 都 是 直接 修改 对 象 内 部 的 字符 数 
据 ( 因此 更 高 效 )， 而 不 是 获取 修改 后 格式 的 数据 副本 。 当 创建 stringBuilder 实 例 时 ， 可 以 通过 其 中 
一 个 构造 邵 数 来 提供 对 象 的 初始 值 。 如 果 你 对 构造 函数 不 是 很 熟悉 ， 可 以 理解 为 构造 函数 允许 我 们 在 
使 用 new 关 键 字 时 使 用 初始 状态 来 创建 对 象 。 下 面 看 一 下 StringBuilder 的 用 法 : 
static void FunwithStringBuilder() 
Console.WritelLine("=> Using the StringBuilder:"); 
StringBuilder sb = new StringBuilder("**** Fantastic Games ****"); 
sb.Append("\n"); 
sb.AppendLine("Half Life"); 
sb.AppendLine("Morrowind"); 
sb.AppendLine("Deus Ex "+" 2"); 


sb.AppendLine("System Shock"); 
Console.WriteLine(sb.ToString()); 


sb.Replace("2", "Invisible War"); 
Console.WritelLine(sb.ToString()); 
Console.WritelLine("sb has {0} chars.", sb.Length); 
Console.WriteLine(); 


} 

在 这 里 ， 我 们 构建 了 一 个 stringBuilder， 并且 将 初始 值 设 置 为 "**** Fantastic Games ****"。 可 
以 看 到 , 我 们 向 内 部 缓冲 区 追加 数据 , 并 且 可 以 随意 替换 (或 移 除 ) 字 符 。 默认 情况 下 , StringBuilder 
只 能 保存 16 个 字符 以 下 的 字符 串 〈 如 果 需 要 ， 可 以 自动 扩展 )， 然而， 我 们 可 以 通过 其 他 构造 函数 参 
数 来 改变 这 个 初始 值 。 


// 创建 一 个 初始 大 小 为 256 的 StringBuilder 
StringBuilder sb = new StringBuilder("**** Fantastic Games ****", 256); 
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如 果 追 加 的 字符 数 超过 规定 的 限制 ，5tringBuilder 对 象 会 将 它 的 数据 复制 到 新 的 实例 中 , 并 根据 
规定 的 限制 来 扩大 缓冲 区 。 


源 代码 ”FunWithStrings 项 目的 源 代码 位 于 Chapter 3 子 目 录 下 。 


3.6” 窄 化 和 宽 化 数据 类 型 转换 


既然 我 们 理解 了 如 何 和 内 建 的 C# 数 据 类 型 进行 交互 ， 下 面 就 研究 一 下 数据 类 型 转换 的 相关 主题 。 
假设 我 们 有 一 个 新 的 控制 台 应 用 程序 TypeConversions， 并 定义 了 如 下 的 类 : 
class Program 
static void Main(string[] args) 
Console.WriteLine("***** Fun with type conversions *****"); 


// 把 两 个 short 数 据 相 加 并 输出 结果 
short numb1 = 9, numb2 = 10; 
Console.WriteLine("{0} + {1} = {2}", 
numb1i, numb2, Add(numb1i, numb2)); 
Console.ReadLine(); 


Static int Add(int x, int y) 
Return x + yj 


} 

注意 ，Add() 方 法 期 望 传 人 两 个 int 参 数 。 然 而 ，Main() 方 法 实际 上 传人 了 两 个 short 变 量 。 虽 然 这 
可 能 看 上 去 绝对 是 不 匹配 的 数据 类 型 , 但 是 程序 编译 和 执行 都 没有 出 错 , 并 返回 了 我 们 期 望 的 结果 19。 

因为 不 可 能 丢失 数据 ， 所 以 编译 器 认为 这 段 代 码 从 语法 上 说 是 正确 的 。 由 于 short 的 最 大 值 
(32 767 ) 在 int 范 围 (2 147 483 647 ) 内 ， 编 译 器 就 把 每 一 个 short 隐 式 宽 化 为 int。 正 式 地 说 ， 宽 化 
用 于 定义 隐 式 向 上 转换 ， 并 且 不 会 导致 数据 丢失 。 


说 明 如 果 和 希望 查看 每 一 个 C# 数 据 类 型 允许 的 宽 化 (和 窒 化 ) 转换 ， 请 在 .NET Framework 4.5 SDK 
文档 中 查找 Type Conversion Tables ( 类 型 转换 表 ) 的 主题 。 


尽管 这 个 隐 式 宽 化 在 之 前 的 示例 中 工作 得 很 好 ,但 在 其 他 时 候 这 个 “特性 ”可 能 会 引起 编译 时 错 
误 。 例 如 ， 假 设 我 们 已 经 为 numb1 和 numb2 设 置 了 (加 在 一 起 时 ) 会 溢出 short 最 大 值 的 值 。 同 样 ， 假 设 
我 们 把 Add() 方 法 的 返回 值 保存 在 新 的 short 本 地 变量 中 ， 而 不 是 直接 把 结果 输出 到 控制 台 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun With type conversions *****"); 


// 下 面 会 有 编译 器 错误 
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short numb1 = 30000, numb2 = 30000; 
short answer = Add(numb1i, numb2); 
Console.WriteLine("{0} + {1} = {2}", 


numb1, numb2, answer); 
Console.ReadLine(); 


在 这 里 ， 编 译 右 报告 了 如 下 的 错误 : 


Cannot implicitly convert type 'int' to 'short'. An explicit conversion exists (are you missing a cast?) 





问题 是 ， 尽 管 Add() 方 法 可 以 返回 int 的 值 60 000 ( 因为 它 在 System.Int32 的 范围 内 )， 但 是 值 不 能 
保存 在 short 中 ( 因为 它 溢出 了 这 个 数据 类 型 的 边界 )。 正 式 地 说 ，CLR 不 能 应 用 窄 化 运算 。 窄 化 和 宽 
化 是 相对 的 ， 因 为 大 值 保存 在 小 变量 中 。 

要 指出 很 重要 的 一 点 : 即使 我 们 可 以 推断 出 窗 化 转换 会 成 功 ， 所 有 的 窗 化 转换 也 会 导致 编译 器 错 
误 。 例 如 ， 如 下 代码 会 导致 编译 器 错误 : 

// 另外 一 个 编译 器 错误 

static void NarrowingAttempt() 


byte myByte = 0; 
int myInt = 200; 
myByte = myInt; 


Console.WriteLine("Value of myByte: {0}", myByte); 


在 这 里 ， 保 存在 int 变 量 (myInt ) 中 的 值 肯 定位 于 byte 范 围 内 ， 因 此 我 们 期 望 这 样 的 窗 化 转换 不 
会 导致 运行 时 错误 。 然 而 ， 由 于 C# 是 类 型 安全 的 ， 我 们 也 确实 会 收 到 编译 器 错误 。 

如 果 和 希望 通知 编译 器 我 们 想 要 处 理 窗 化 运算 引起 的 可 能 的 数据 丢失 , 就 必须 使 用 C# 强 制 转换 操作 
符 () 来 进行 显 式 强制 转换 。 下 面 的 代码 修改 了 Program 类 型 。 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** Fun with type conversions *****"); 
short numb1 = 30000, numb2 = 30000; 


// 显 式 强制 转换 int 为 short (并 且 允 许 数 据 丢 失 ) 
short answer = (short)Add(numb1, numb2); 


Console.WriteLine("{0} + {1} = {2}", 
numb1, numb2, answer); 

NarrowingAttempt(); 

Console.ReadLine(); 


} 
static int Add(int x, int y) 
{ 


return x + y; } 
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static void NarrowingAttempt() 


byte myByte = 0; 
int myInt = 200; 


// 显 式 强制 转换 int 为 byte (没有 数据 丢失 ) 
myByte = (byte)myInt; 
Console.WriteLine("Value of myByte: {0}", myByte); 
} 
} 


这 种 情况 下 代码 会 编译 ,但 添加 的 结果 是 完全 错误 的 : 


***** Fun with type conversions 冰冰 冰冰 
30000 + 30000 = -5536 
Value of myByte: 200 





我 们 看 到 ， 显 式 强制 转换 允许 我 们 强制 编译 器 应 用 罕 化 转换 ( 即使 这 样 做 可 能 会 导致 数据 丢失 )。 
就 NarrowingAttempt() 方 法 而 言 ， 这 样 做 没有 问题 ， 因 为 值 200 处 在 byte 范 围 内 。 然 而 ， 对 于 Main() 中 
两 个 short 相 加 的 情况 来 说 ， 最 后 的 结果 完全 不 能 接受 ( 30 000 + 30 000 = -5536? )。 

如 果 我 们 在 构建 一 个 不 能 接受 数据 丢失 的 应 用 程序 ，C# 提 供 的 checked 和 unchecked 关 键 字 将 确保 
数据 丢失 肯定 会 被 检测 到 。 


3.6.1 checked 关 键 字 


先 来 看 一 下 checked 关 键 字 的 用 法 。 假设 Program 里 有 一 个 新 的 方法 要 将 两 个 byte 相 加 ,和 且 每 一 个 都 
被 赋 了 一 个 小 于 最 大 值 ( 255 ) 的 值 ,如 果 我 们 要 将 这 两 个 类 型 的 值 相 加 ( 将 返回 的 int 强 制 转换 为 byte )， 
就 可 以 假设 结果 恰好 是 所 有 成 员 的 和 : 

static void ProcessBytes() 

byte b1 = 100; 


byte b2 = 250; 
byte sum = (byte)Add(b1, b2); 


// Sum 应 该 保存 值 330。 然 而 ， 我 们 得 到 了 值 94 
Console.WriteLine("sum = {0}", sum); 


如 果 我 们 查看 这 个 应 用 程序 的 输出 结果 ， 可 能 会 惊讶 地 发 现 sum 保 存 了 值 94 ( 而 不 是 期 望 的 350 )。 
原因 很 简单 , 由 于 System.Byte 只 能 保存 0~255 之 间 的 值 (一共 只 有 256 个 位 置 )，sum 现 在 保存 的 是 溢出 值 
(350 一 256=94 )。 默 认 情 况 下 ， 如 果 我 们 不 采取 纠正 措施 ， 发 生 上 溢 / 下 溢 的 时 候 就 不 会 给 出 出 错 信息 。 

要 在 应 用 程序 中 人 处理 上 溢 或 下 游 的 情况 ,我 们 有 两 个 选择 。 第 一 个 选择 是 利用 聪明 才智 和 编程 技 
巧 来 手动 处 理 所 有 上 洲 和 下 溢 的 情况 。 当 然 ， 这 项 技术 的 问题 在 于 ,我 们 是 人 不 是 神 ， 即 使 最 好 的 尝 
试 都 可 能 导致 错误 从 眼皮 底下 溜 走 。 

幸好 ，C# 提 供 了 checked 关 键 字 。 当 我 们 把 一 个 语句 ( 或 者 语句 块 ) 包装 在 checked 关 键 字 域内 时 ， 
C# 编 译 右 会 使 用 额外 的 CIL 指 令 来 测试 在 将 两 个 数值 数据 类 型 相 加 、 相 乘 、 相 减 和 相 除 时 可 能 产生 的 
溢出 情况 。 
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如 果 发 生 了 溢出 ， 就 会 得 到 一 个 运行 时 异常 : System.0verflowException。 第 7 章 会 探讨 所 有 结构 
化 异常 处 理 的 细节 以 及 try 和 catch 关 键 字 的 用 法 。 这 里 不 涉及 更 多 细节 ， 观 察 如 下 更 新 : 


static void ProcessBytes() 


byte b1 = 100; 
byte b2 = 250; 


// 这 次 告诉 编译 器 增加 CIL 人 代码， 如果 发 生 上 溢 或 下 溢 就 抛 出 异常 
try 


byte sum = checked((byte)Add(b1, b2)); 
Console.WriteLine("sum = {0}", sum); 


catch (OverflowException ex) 
Console.WritelLine(ex.Message); 
} 
} 
注意 ，Add() 的 返回 值 被 包装 在 checked 关 键 字 的 作用 域 中 。 由 于 和 大 于 一 个 byte， 就 触发 了 一 个 
运行 时 异常 。 注 意 下 面 通过 Message 属 性 输出 的 错误 消息 。 





Arithmetic operation resulted in an overflow. 





如 果 希 望 对 一 段 代码 语句 块 进行 强制 溢出 检测 ， 可 以 按 如 下 所 示 定 义 checked 作 用 域 : 
try 
{ 
checked 
byte sum = (byte)Add(b1, b2); 
Console.WriteLine("sum = {0}", sum); 
catch (OverflowException ex) 


Console.WriteLine(ex.Message); 
在 这 两 个 例子 中 , 代码 都 会 自动 运算 可 能 的 溢出 情况 , 并 且 在 遇 到 这 种 情况 时 发 出 一 个 溢出 异常 。 
3.6.2 ” 设 定 项 目 级 别 的 溢出 检测 


如 果 要 创建 的 应 用 程序 不 允许 发 生 任何 未 知 的 溢出 ,我 们 可 能 会 很 烦恼 ， 因 为 要 把 无 数 代码 行 放 到 
checked 关 键 字 作 用 域 中 。 另 外 一 种 可 选 的 方案 是 ，C# 编 译 器 提供 了 /checked 标 志 。 如 果 启 用 的 话 ， 所 有 
的 运算 都 会 被 检查 是 否 溢出 ,无 需 使 用 C# checked 关 键 字 。 如 果 发 现 溢出 ,我 们 会 收 到 一 个 运行 时 异常 。 

要 使 用 Visual Studio 启 用 这 个 标志 ， 可 以 打开 项 目 属性 页 ， 然 后 单 击 Build 标 签 中 的 Advanced 按 钮 。 
在 结果 对 话 框 中 选择 Check for arithmetic overflow/underflow( 检测 运算 上 溢 / 下 溢 ) 复 选 框 ( 如 图 3-3 所 示 )。 

当 我 们 创建 调试 编译 时 ， 启 用 这 个 设置 会 很 有 用 。 一 旦 代码 中 所 有 溢出 异常 都 解决 了 ， 你 完全 可 
以 对 之 后 的 编译 禁用 /checked 标 志 ( 这样 会 提升 应 用 程序 的 运行 时 性 能 )。 
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图 3-3 ”开启 项 目 级 别 的 上 洪 下 溢 数据 检测 





3.6.3 unchecked 关键 字 


现在 ,假设 我 们 已 经 启用 了 项 目 级 别 的 设置 ， 如 果 有 一 段 代 码 中 的 数据 丢失 是 可 以 接受 的 ,我们 
该 怎么 做 呢 ?” 由 于 /checked 标 志 会 检查 所 有 运算 逻辑 , C# 提 供 的 unchecked 关 键 字 会 禁止 个 别 情况 下 抛 
出 溢出 异常 。 这 个 关键 字 的 用 法 和 checked 关 键 字 的 很 相似 , 我 们 可 以 指定 一 个 语句 或 者 一 个 语句 块 。 

// 假设 启用 了 /checked， 这 段 代 码 不 会 触发 运行 时 异常 

unchecked 


byte sum = (byte)(b1 + b2); 
Console.WriteLine("sum = {0} ", sum); 


现在 总 结 一 下 C# 的 checked 和 unchecked 关 键 字 ， 记 住 .NET 运 行 时 的 默认 行为 是 忽略 运算 溢出 。 当 
我 们 需要 有 选择 性 地 处 理 分 散 的 语句 时 , 可 以 使 用 checked 关 键 字 。 如 果 和 希望 在 整个 应 用 程序 中 捕捉 溢 
出 错误 ， 可 以 启用 /checked 标 志 。 最 后 ， 如 果 有 一 段 代码 中 的 溢出 是 可 接受 的 ( 因此 不 应 该 触发 运行 
时 异常 )， 可 以 使 用 unchecked 关 键 字 。 





源 代码 ”TypeConversions 项 目的 源 代 码 位 于 Chapter 3 子 目 录 下 。 





3.7” 隐 式 类 型 本 地 变量 
本 章 到 目前 为 止 ， 我 们 在 定义 本 地 变量 时 都 是 显 式 地 指定 变量 的 实际 数据 类 型 。 


static void DeclareExplicitVars() 


// 显 式 类 型 本 地 变量 的 声明 如 下 

// dataType variableName = initialValue; 
int myInt = 0; 

bool myBool = true; 

string myString = "Time, marches on..."; 
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尽管 为 每 个 变量 显 式 地 指定 数据 类 型 一 直 是 很 好 的 做 法 ,但 C# 语 言 还 可 以 使 用 var 关 键 字 创建 隐 
式 类 型 的 本 地 变量 。 使 用 var 关 键 字 不 必 指 定 具 体 的 数据 类 型 ( 如 int、bool、string )。 这 人 么 做 时 ， 编 
译 器 将 根据 本 地 数据 点 的 初始 值 来 自动 推断 实际 的 数据 类 型 。 
为 了 演示 隐 式 类 型 的 作用 , 我 们 创建 一 个 名 为 ImplicitlyTypedLocalVars 的 Console Application 项 目 。 
注意 ， 前 面 方法 中 的 本 地 变量 ， 现 在 可 以 按 如 下 方式 进行 声明 : 


static void DeclareImplicitVars() 

{ 

// 隐 式 类 型 本 地 变量 的 声明 如 下 

// var variableName = initialValue; 
var myInt = 0; 
var myBool = true; 
var myString = "Time, marches on..."; 


说 明 ”严格 地 说 ，var 并 不 是 C# 关 键 字 。 你 可 以 使 用 “var” 作 为 变量 、 参 数 和 字段 的 名 字 而 不 会 导 
致 编译 时 错误 。 尽 管 如 此 ， 当 var 标 记 用 于 数据 类 型 时 ， 编 译 器 根据 语 境 将 其 视 为 关键 字 。 


在 这 种 情况 下 ， 根 据 设置 的 初始 值 ， 编 译 器 可 以 推断 myInt 实 际 上 是 System.Int32 类 型 ，myBoo1 是 
System.Boolean 类 型 ，myString 是 System.String 类 型 。 要 验证 这 一 点 ， 你 可 以 通过 反射 来 输出 类 型 名 
称 。 正 如 我 们 将 在 第 15 章 中 详细 介绍 的 那样 ， 反 射 就 是 在 运行 时 判定 类 型 的 组 成 。 例 如 ， 使 用 反射 ， 
你 可 以 判定 一 个 隐 式 类 型 本 地 变量 的 数据 类 型 。 使 用 如 下 的 代码 更 新 方法 : 


static void DeclareImplicitVars() 


{ 
// 隐 式 类 型 本 地 变量 
Var myInt = 0; 
Var myBool = true; 
Var myString = "Time, marches on..."; 


// 输出 实际 类 型 
Console.WritelLine("myInt is a: {0}", myInt.GetType().Name); 
Console.WritelLine("myBool is a: {0}", myBool.GetType().Name); 
Console.WritelLine("myString is a: {0}", myString.GetType().Name); 


说 明 要 知道 的 是 ， 你 可 以 用 隐 式 类 型 表示 任何 类 型 ， 包 括 数 组 、 泛 型 类 型 ( 见 第 9 章 )， 以 及 自 定 
义 的 类 型 。 你 还 将 在 本 书 中 看 到 隐 式 类 型 的 其 他 示例 。 


如 果 在 Main() 中 调用 DeclareImplicitVars() 方 法 ,输出 结果 将 如 下 所 示 。 





***** Fun with Implicit Typing ***** 


myInt is a: Int32 
myBool is a: Boolean 
myString is a: String 
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3.7.1 隐 式 类 型 变量 的 限制 


对 于 var 关 键 字 的 使 用 ， 自 然 有 很 多 限制 。 首 先 ， 隐 式 类 型 只 能 用 于 方法 或 属性 范围 内 的 本 地 变 
量 。 用 var 关 键 字 定义 返回 值 、 参 数 或 自 定义 类 型 的 字段 数据 ， 都 是 不 合法 的 。 例 如 ， 下 面 的 类 定义 
将 导致 多 个 编译 时 错误 : 

class ThisWillNeverCompile 


{ 
// 错误 | var 不 能 用 于 字段 数据 
private var myInt = 10; 


// 错误 | var 不 能 用 于 返回 值 或 参数 类 型 
public var MyMethod(var x, var y){} 


同样 , 用 var 关 键 字 声明 的 本 地 变量 必须 在 声明 时 分 配 初始 值 , 并 且 这 个 初始 值 不 能 为 null。 后 一 
个 限制 是 有 意义 的 ， 因 为 编译 器 仅仅 根据 null 无 法 推断 该 变量 在 内 存 中 实际 指向 的 数据 类 型 。 

// 错误 ! 必须 分 配 值 

Var myData; 


// 错误 ! 必须 在 声明 时 分 配 值 
var myInt; 
myInt = 0; 


// 错误 ! 不 能 分 配 null 作 为 初始 值 

var my0bj = null; 

然而 ， 为 隐 式 类 型 本 地 变量 分 配 初始 值 并 进行 推断 之 后 ( 必须 是 省 用 类 型 )， 就 可 以 对 其 分 配 
null 7。 


// 没 问 题 ，SportsCar 是 一 个 引用 类 型 
var myCar = new SportsCar(); 
myCar = null; 


此 外 ， 可 以 将 隐 式 类 型 本 地 变量 的 值 分 配给 其 他 变量 ( 不 管 它 是 否 为 隐 式 类 型 )。 
// 同样 没 问题 

var myInt = 0; 

var anotherInt = myInt; 


string myString = "Wake up!"; 
var myData = myString; 


同样 ， 你 还 可 以 向 调用 方 返 回 一 个 隐 式 类 型 本 地 变量 ， 只 要 方法 的 返回 类 型 与 var 定 义 的 数据 点 
的 实际 类 型 是 相同 的 。 
static int GetAnInt() 


var retVal = 9; 
return retVal; 


3.7.2 ” 隐 式 类 型 数据 是 强 类 型 数据 
要 非常 清楚 的 是 , 隐 式 类 型 的 本 地 变量 是 强 类 型 数据 。 因此 , var 关键 字 与 脚本 语言 ( 如 JavaScript、 
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Perl ) 所 用 的 技术 和 COM 的 Variant 数 据 类 型 并 不 相同 ， 对 于 后 两 者 来 说 ,一 个 变量 在 应 用 程序 的 生命 
周期 中 可 以 保存 不 同 的 类 型 ( 通常 称 为 动态 类 型 )。 








说 明 ”C# 允 许 C# 中 的 动态 类 型 使 用 dynamic 关 键 字 一 一 你 一 定 非 常 吃惊 ! 你 将 在 第 18 章 中 学 习 它 。 











实际 上 ， 类 型 推断 延续 了 C# 语 言 的 强 类 型 特性 ， 并 且 只 会 在 编译 时 影响 变量 的 声明 。 之 后 ,该 数 S 
据点 将 被 视 为 它 声明 的 类 型 。 为 该 变量 分 配 不 同 的 类 型 将 导致 编译 时 错误 。 
static void ImplicitTypingIsStrongTyping() 
// 编译 器 知道 “s” 是 一 个 System.String 


var s = "This variable can only hold string data!"; 
Ss= "This is finesss"; 


// 可 以 调用 实际 类 型 的 所 有 成 员 
string upper = s.ToUpper(); 


// 错误 ! 不 能 将 数值 数据 分 配给 字符 串 
} Ss = 44; 


3.7.3” 隐 式 类 型 本 地 变量 的 用 途 


了 解 了 声明 隐 式 类 型 本 地 变量 的 语法 后 ， 你 肯定 会 奇怪 这 个 结构 有 什么 用 呢 ? 首先 ， 使 用 var 声 
明 本 地 变量 并 不 能 带 来 什么 好 处 。 这 样 做 会 给 其 他 阅读 代码 的 人 带 来 困扰 ， 由 于 你 无 法 快速 判断 实际 
的 数据 类 型 ， 因 此 难以 理解 变量 的 整体 功能 。 所 以 ， 如 果 需 要 int， 就 应 该 声明 为 int。 

但 是 ， 在 第 12 章 开头 我 们 将 看 到 ，LINQ 技 术 使 用 了 查询 表达 式 ， 它 可 以 根据 表达 式 本 身 的 格式 
产生 动态 创建 的 结果 集 。 由 于 在 某 些 情况 下 根本 无 法 显 式 定义 查询 的 返回 类 型 ,这 时 隐 式 类 型 就 非常 
有 用 了 。 不 要 担心 读 不 懂 下 面 的 LINQ 示 例 代码 ， 你 只 需要 看 看 是 否 能 指出 subset 的 实际 数据 类 型 : 

static void Ling QueryOverInts() 


int[] numbers = { 10, 20, 30, 40, 1, 2, 3, 8 }; 


// LINQ 查 询 
var subset = from i in numbers where i «< 10 select i; 


Console.Write("Values in subset: "); 
foreach (var i in subset) 


Console.Write("{0} ", i); 
Console.WritelLine(); 


// 别 …… subset 是 什么 类 型 呢 
Console.Writeline("subset is a: {0}", subset.GetType().Name); 
Console.WritelLine("subset is defined in: {0}", subset.GetType().Namespace); 


} 
你 可 能 认为 subset 的 数据 类 型 是 整数 数组 ， 表 面 看 来 好 像 真是 这 样 ， 实 际 上 它 是 一 种 底层 LINQ 
数据 类 型 。 除 非 长 时 间接 触 LINQ， 或 者 直接 打开 ildasm.exe 中 的 编译 图 形 ， 否 则 你 肯定 不 会 知道 这 种 
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情况 。 好 在 你 使 用 LINQ 时 几乎 不 需要 关注 查询 返回 值 的 基础 类 型 ， 只 需要 将 值 赋 给 一 个 隐 式 类 型 的 
局 部 变量 即 可 。 

事实 上 ， 可 以 说 只 有 在 定义 LINQ 查 询 的 返回 数据 时 才 应 该 使 用 var 关 键 字 。 记 住 ， 如 果 需 要 int， 
就 声明 int! 在 产品 代码 中 滥用 隐 式 类 型 ( 通过 var 关 键 字 ) 被 认为 是 一 种 糟糕 的 设计 。 


源 代 码 ”ImplicitlyTypedLocalVars 项 目的 源 代码 位 于 Chapter 3 子 目 录 下 。 


3.8 ”C# 迁 代 结 构 


所 有 的 编程 语言 都 提供 了 重复 代码 块 直到 满足 终止 条 件 的 方式 。 不 管 过 去 你 用 过 什么 语言 ，C# 
迭代 语句 都 不 会 让 你 感到 很 惊 订 ， 只 需 一 点 点 介绍 你 就 能 了 解 它 。C# 提 供 了 如 下 4 个 迭代 结构 : 

口 for 循 环 

口 foreach/in 循 环 

口 while 循 环 

口 do/while 循 环 

让 我 们 依次 快速 探讨 一 下 每 一 个 循环 结构 ， 使 用 一 个 新 的 名 为 IterationsAndDecisions 的 控制 台 应 
用 程序 项 目 。 





说 明 ”我 想 让 最 后 一 节 简明 扼要 ,因此 这 里 假定 你 在 C# 编 程 语言 中 用 过 类 似 的 关键 字 ( if、for、switch 
等 )。 要 了 解 更 多 信息 ， 请 查阅 .NET Framework 4.5 SDK 文 档 的 主题 “Iteration Statements (C# 
Reference)”、“ Jump Statements (C# Reference)” 和 “Selection Statements (C# Reference)”。 


3.8.1 ”for 循环 
如 果 需 要 迭代 一 段 代 码 固定 次 数 ，for 语 句 会 提供 很 大 的 灵活 性 。 从 本 质 上 说 ， 我 们 可 以 指定 一 
段 代码 重复 的 次 数 和 终止 条 件 。 不 喝 味 了 ， 直 接 给 出 一 段 语法 示例 : 


// 基 本 循环 
static void ForLoopExample() 


// 注 意 ! “i” 只 在 for 御 环 域内 可 见 
for(int i = 0; i < 4; i++) 


Console.WritelLine("Number is: {0} ", i); 
;} 
//“i” 在 这 里 不 可 见 


所 有 以 前 学 过 的 C、C++ 以 及 Java 的 技巧 都 可 用 于 构建 C# for 语 句 。 我 们 可 以 创建 复杂 的 终止 条 件 ， 
构建 无 限 循 环 ， 通 过 -- 操 作 符 进行 反 向 循环 ， 使 用 goto 、continue 和 break 关 键 字 。 
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3.8.2” ”foreach 循环 


C# foreach 关 键 字 允许 遍历 某 种 容器 中 的 所 有 项 ,无需 测试 数组 的 上 限 。 不 过 与 for 循 环 不 同 , foreach 
循环 只 会 以 线性 (n+1) 的 方式 遍历 容器 ( 不 能 执行 向 后 遍历 、 每 隔 三 个 元 素 访问 一 次 之 类 的 操作 ) 。 

然而 ， 当 你 只 需 逐 项 遍历 某 个 集合 时 ，foreach 循 环 是 最 佳 选 择 。 下 面 是 两 个 使 用 foreach 的 示例 , 一 
个 遍历 字符 串 数组 ， 另 外 一 个 遍历 整数 数组 。 注 意 : in 关键 字 前 面 的 数据 类 型 代表 容器 中 的 数据 类 型 : 


// 使 用 foreach 选 代数 组 项 
static void ForEachLoopExample() 


string[] carTypes = {"Ford", "BMW", "Yugo", "Honda"” }; 
foreach (string c in carTypes) 
Console.WritelLine(c); 


int[] myInts = { 10, 20, 30, 40 }; 
foreach (int i in myInts) 
Console.WriteLine(i); 


in 关键 字 后 面 的 项 可 以 是 个 简单 的 数组 〈 比如 这 里 )， 更 确切 地 说 是 任何 实现 IEnumerable 接 口 的 
类 。 学 习 第 9 章 后 你 会 了 解 ，.NET 基 础 类 库 配 备 了 大 量 包 含 普通 抽象 数据 类 型 ( ADT ) 实现 的 集合 。 
这 些 项 中 的 任意 一 个 ( 如 泛 型 List<T> ) 都 可 用 在 foreach 循 环 中 。 

在 foreach 结 构 中 使 用 隐 式 类 型 

在 foreach 循 环 结构 中 也 可 以 使 用 隐 式 类 型 。 如 你 所 愿 ， 编 译 器 可 以 准确 地 推断 “类 型 的 类 型 ”。 
回想 一 下 本 章 前 面 讲 过 的 LINQ 示 例 方法 。 由 于 我 们 不 知道 subset 变 量具 体 的 基础 数据 类 型 , 可 以 使 用 
隐 式 类 型 迭代 结果 集 : 


static void LinqQueryOverInts() 
int[] numbers = { 10, 20, 30, 40, 1, 2, 3, 8 }; 


// LINQ 查询 ! 


var subset = from i in numbers where i «< 10 select i; 


Console.Write("Values in subset: "); 
foreach (var i in subset) 


Console.Write("{0} ", i); 


} 


3.8.3 while 和 do/while 循 环 结构 


当 希 望 执 行 一 段 语句 直到 满足 某 个 终止 条 件 时 , while 循 环 结构 很 用。 在 while 循 环 的 作用 域内 ， 
我 们 当然 要 确保 终止 事件 会 产生 ， 和 否则 就 会 产生 无 限 循环 。 在 如 下 代码 中 ,“In while loop” 消 息 会 不 
断 输 出 ， 直 到 用 户 在 命令 提示 符 中 输入 yes 才 结束 循环 。 

static void WhileLoopExample() 


string userIsDone = ""; 


// 对 字符 囊 的 小 写 副本 进行 测试 
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while(userIsDone.ToLower() != "yes") 


Console.WriteLine("In while loop"); 
Console.Write("Are you done? [yes] [no]: "); 
userIsDone = Console.ReadLine(); 


} 

和 while 循 环 密切 相关 的 是 do/while 语 句 。 和 简单 的 while 循 环 相似 ， 当 我 们 需要 进行 一 些 次 数 不 
定 的 动作 时 ， 可 以 使 用 do/while。 区 别 是 do/while 循 环 肯定 会 执行 至 少 一 次 对 应 的 代码 块 。 相 比 之 下 ， 
如 果 一 开始 终止 条 件 就 是 false， 很 可 能 while 循 环 就 不 会 执行 。 

static void DowhileLoopExample() 

string userIsDone = ""; 


do 


Console.WritelLine("In do/while loop"); 

Console.Write("Are you done? [yes] [no]: "); 

userIsDone = Console.ReadLine(); 
}while(userIsDone.ToLower() != "yes"); // 注意 分 号 


3.9 条 件 结构 和 关系 /相等 操作 符 


既然 我 们 可 以 对 一 段 语句 进行 迭代 , 下 一 个 相关 概念 就 是 如 何 控制 程序 执行 的 流程 。C# 和 定义 了 两 
个 结构 来 根据 各 种 情况 改变 程序 的 流程 : 

口 if/else 语 句 

口 switch 语 句 


3.9.1 if/else 语 句 


首先 是 if/else 语 句 。 然而， 和 C、C++ 中 的 不 同 ，C# 中 的 if/else 语 句 只 能 作用 于 布尔 表达 式 , 不 
能 用 于 诸如 -1 和 0 这 样 的 值 。 


3.9.2 ”关系 /相等 操作 符 


if/else 语 句 通常 会 包含 表 3-7 列 出 的 一 些 C# 操 作 符 ， 用 来 获取 文本 的 布尔 值 。 


表 3-7 C# 关 系 和 相等 操作 符 
C# 关 系 /相等 操作 符 使 用 示例 作 用 


SS if(age == 30) 如 果 每 一 个 表达 式 都 相同 ， 就 返回 true 

1= if("Foo" != myStr) 如 果 每 一 个 表达 式 都 不 同 ， 就 返回 true 

iid 如 果 表 达 式 A(bonus) 小 于 、 大 于 、 小 于 等 于 或 大 于 等 于 表达 
if(bonus <= 2000) 式 B(2000) ， 就 返回 true 


if(bonus >= 2000) 
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再 次 提醒 ，C 和 C++ 程序 员 需 要 知道 ,用 不 等 于 0 的 俏 来 测试 条 件 的 老 技巧 不 适用 于 C#。 假 设 你 希 
望 看 看 一 个 正在 操作 的 字符 串 是 不 是 超过 0 个 字符 ， 你 可 能 会 这 些 写 : 
static void IfElseExample() 
// 这 是 不 合法 的 ， 因 为 Length 返 回 的 是 int 而 不 是 bool 
string stringData = "My textual data"; 
if(stringData.Length) 
Console.Writeline("string is greater than 0 characters"); 
} 
. 
如 果 我 们 希望 使 用 String.Length 属 性 来 检测 真 或 假 , 就 必须 修改 条 件 表达 式 , 将 它 解析 为 一 个 布 
尔 值 。 


// 合 法 的 ， 它 解析 为 true 或 false 
if(stringData.Length > 0) 


Console.WriteLine("string is greater than 0 characters"); 


3.9.3 ”逻辑 操作 符 


一 个 if 语 句 也 可 能 会 由 复杂 的 表达 式 组 成 ， 并 且 还 可 以 包含 else 语 句 来 执行 更 复杂 的 测试 ， 其 语 
法 和 C (++ ) 以 及 Java 很 相似 。 如 表 3-8 所 示 ，C# 有 一 组 逻辑 操作 符 用 于 构建 复杂 的 表达 式 。 


表 3-8 “C 术 罗 辑 操作 符 











逻辑 操作 符 示 例 作 用 
8 if(age == 30 && name == "Fred") 逻辑 与 操作 符 。 如 果 所 有 表达 式 均 为 true, 则 返回 true 
| if(age == 30 || name == "Fred") 逻辑 或 操作 符 。 只 要 一 个 表达 式 为 true， 则 返回 true 
! if( ImyBool) 逻辑 非 操 作 符 。 如 果 表 达 式 为 false， 则 返回 true; 如 


果 表 达 式 为 true， 则 返回 false 





说 明 忠和 | | 操作 符 在 必要 时 都 会 “短路 ”"。 也 就 是 说 ， 如 果 一 个 表达 式 被 确定 为 false， 其 他 的 表达 
式 就 不 会 被 检查 了 ; 要 想 检 查 所 有 的 表达 式 ， 可 以 使 用 相关 的 & 和 | 操作 符 。 





3.9.4 switch 语句 


C# 提 供 的 男 外 一 个 简单 的 选择 结构 就 是 switch 语 句 。 和 其 他 C 系 列 语言 中 的 一 样 ，switch 语 句 允 
许 我 们 根据 预定 义 的 选择 来 处 理 程序 流程 。 例 如 ，Main() 逻 辑 根据 两 个 可 能 选项 中 的 一 个 来 输出 某 个 
字符 串 消息 ( default 用 来 处 理 无 效 的 选择 )， 如 下 所 示 : 


// 根 据 数值 进行 转换 
static void SwitchExample() 
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Console.WriteLine("1 [C#], 2 [VB]"); 
Console.Write("Please pick your language preference: "); 


string langChoice = Console.ReadLine(); 
int n = int.Parse(langChoice); 


switch (n) 
{ 


case 1: 

Console.WritelLine("Good choice, C# is a fine language."); 
break; 
case 2: 

Console.WritelLine("VB: O00P, multithreading, and more!"); 
break; 
default: 

Console.WritelLine("Well...good luck with that!"); 
break; 





说 明 C# 要 求 所 有 情况 ( 包括 default ) 包含 以 break 或 goto 终 止 的 可 执行 语句 来 避免 失败 。 





C# switch 语 句 一 个 不 错 的 特性 是 , 除了 数值 数据 之 外 ,我 们 还 可 以 计算 字符 串 数据 。 下 面 这 个 更 
新 后 的 switch 语 句 完成 了 这 个 特别 的 任务 ( 注意， 如 果 使 用 这 种 方法 的 话 ， 就 不 需要 把 用 户 数据 转换 
为 数值 ): 


static void SwitchOnStringExample() 
{ 
Console.WritelLine("C# or VB"); 
Console.Write("Please pick your language preference: "); 


string langChoice = Console.ReadLine(); 
switch (langChoice) 
{ 


case "C#": 
Console.WriteLine("Good choice, C# is a fine language."); 
break; 
case "VB": 
Console.WritelLine("VB: O00P, multithreading and more!"); 
break; 
default: 
Console.WritelLine("Well...good luck with that!"); 
break; 
} 
} 


还 可 以 对 枚 举 数据 类 型 使 用 switch。 你 会 在 第 4 章 看 到 C# enum 关 键 字 可 以 定义 一 组 名 / 值 对 。 作 为 
尝鲜 ,我们 来 看 最 后 一 个 辅助 方法 ， 它 对 System.Day0fWeek 枚 举 执 行 switch 检 测 。 你 会 看 到 一 些 还 没 
有 介绍 过 的 语法 ， 请 先 把 注意 力 放 在 检查 枚 举 本 身上 。 其 他 部 分 将 在 后 面 的 章节 一 一 介绍 。 


static void SwitchOnEnumExample() 


Console.Write("Enter your favorite day of the week: "); 
DayOfWeek favDay; 


try 


{ 
favDay = (DayOfWeek)Enum.Parse(typeof(DayOfWeek), Console.ReadLine()); 
catch (Exception) 


Console.WriteLine("Bad input!"); 
return; 





switch (favDay) 
Et 


case DayOfWeek.Friday: 
Console.Writeline("Yes, Friday rules!"); 

break; 

case DayOfWeek.Monday: 
Console.WriteLine("Another day, another dollar"); 

break; 

case DayOfWeek.Saturday: 
Console.WritelLine("Great day indeed."); 

break; 

case DayOfWeek.Sunday: 
Console.WritelLine("Football!!"); 

break; 

case DayOfWeek.Thursday: 
Console.WritelLine("Almost Friday..."); 

break; 

case DayOfWeek.Tuesday: 
Console.WritelLine("At least it is not Monday"); 

break; 

case DayOfWeek.Wednesday: 
Console.WritelLine("A fine day."); 

break; 


源 代码 ”IterationsAndDecisions 项 目的 源 代码 位 于 Chapter 3 子 目录 下 。 


3.10 小结 


本 章 解 析 了 C# 编 程 语言 的 各 个 核心 方面 。 在 这 里 , 我 们 研究 了 在 构建 任何 应 用 程序 时 我 们 都 会 感 
兴趣 的 一 些 常 见 的 结构 。 在 研究 了 应 用 程序 对 象 的 作用 之 后 , 我 们 又 了 解 到 每 一 个 C# 可 执行 程序 都 必 
须 有 一 个 类 型 ， 用 来 定义 作为 程序 入 口 点 的 Main() 方 法 。 在 Main() 方 法 内 ， 我 们 创建 了 很 多 赋予 应 用 
程序 生命 的 对 象 。 

接着 ,我们 深入 探讨 了 C# 内 建 数据 类 型 的 一 些 细节 ,并 且 了 解 到 每 一 个 数据 类 型 关键 字 ( 如 int ) 
实际 上 是 System 命名 空间 中 完整 类 型 ( 这 里 就 是 System.Int32 ) 的 简化 符号 。 沿 着 这 个 思路 ， 我 们 还 
学 习 了 宽 化 和 窒 化 的 作用 以 及 checked 和 unchecked 关 键 字 的 作用 。 

再 接 下 来 ,我 们 介绍 了 用 var 关 键 字 创建 的 隐 式 类 型 的 作用 。 正 如 我 们 讨论 的 那样 ， 隐 式 类 型 的 
大 多 数 使 用 场景 都 与 LINQ 编 程 模型 有 关 。 最 后 ， 我 们 快速 介绍 了 C# 支 持 的 各 种 迭代 和 条 件 结 构 。 

我 们 对 基础 细节 已 经 有 了 一 定 的 了 解 ， 下 一 章 将 完成 对 核心 语言 特性 的 研究 。 此 后 ， 你 就 可 以 学 
习 C# 的 面向 对 象 特性 了 。 
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章 的 内 容 是 前 一 章 的 补充 ， 我 们 会 在 本 章 结束 对 C# 编 程 语 言 核心 方面 的 研究 。 首 先 介绍 有 
关 构 造 C# 方 法 的 各 种 细节 ， 然 后 探讨 out 、ref 和 params 关 键 字 。 同 时 ， 我 们 还 将 研究 可 
选 参数 和 命名 参数 的 作用 。 
在 研究 完 方法 重 载 的 主题 后 , 下 一 个 任务 就 是 研究 使 用 C#i 理 法 操作 数组 类 型 的 细节 , 并 了 解 相关 
的 System.Array 类 类 型 中 包含 的 功能 。 
除 此 之 外 ， 本 章 还 讨论 了 枚 举 结构 以 及 结构 类 型 ， 并 详细 介绍 了 值 类 型 和 引用 类 型 之 间 的 区 别 。 
最 后 探讨 了 可 空 数据 类 型 以 及 ?和 ?? 操 作 符 的 作用 。 读 完 本 章 之 后 ， 你 就 可 以 很 好 地 学 习 从 第 5 章 开 始 
介绍 的 C# 面 向 对 象 知识 。 


4.1 方法 和 参数 修饰 符 


我 们 首先 研究 定义 类 型 方法 的 一 些 细节 。 和 Main() 方 法 ( 见 第 3 章 ) 相似 ， 自 定义 方法 可 以 有 或 没 
有 参数 ,也 可 以 有 或 没有 返回 值 。 在 之 后 的 几 章 中 我 们 会 看 到 ,方法 可 以 在 类 或 结构 的 作用 域内 实现 
(还 可 以 在 接口 类 型 中 设置 原型 )、 并 且 可 以 被 各 种 关键 字 ( 如 static、virtual、public、new 等 ) 修 
饰 以 限制 其 行为 。 在 这 里 ， 每 一 个 方法 都 会 遵循 下 面 的 基本 格式 : 

// 还 记得 吗 ? 静态 方法 可 以 被 直接 调用 ， 无 需 创 建 类 的 实例 

class Program 


// static 返 回 值 类 型 方法 名 (参数 列表 ) {/* 实 现 */} 
static int Add(int x, int y){ return x + yj } 


虽然 在 C# 中 方法 的 定义 简单 明了 , 但 还 是 有 一 些 我 们 可 以 用 来 控制 参数 如 何 传人 目标 方法 的 关键 
， 如 表 4-1 所 示 。 


必 


表 4-1 C# 参 数 修饰 符 


参数 修饰 符 作 用 
(无 ) 如 果 一 个 参数 没有 用 参数 修饰 符 标记 ， 则 认为 它 将 按 值 传递 ( pass by value )， 这 意味 着 被 调用 
的 方法 收 到 原始 数据 的 一 份 副本 
out 输出 参数 由 被 调用 的 方法 赋值 ， 因 此 它 按 引 用 传递 ( pass by reference )。 如 果 被 调用 的 方法 没有 
给 输出 参数 赋值 ， 就 会 出 现 编译 器 错误 
ref 调用 者 赋 初 值 ， 并 且 可 以 由 被 调用 的 方法 可 选 地 重新 赋值 ( 因为 数据 是 按 引 用 传递 的 )。 如 果 被 


调用 的 方法 未 能 给 ref 参 数 赋值 ， 也 不 会 有 编译 器 错误 
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( 续 ) 


参数 修饰 符 作 用 
params 这 个 参数 修饰 符 允许 将 一 组 可 变数 量 的 参数 作为 单独 的 逻辑 参数 进行 传递 。 方 法 只 能 有 一 个 
parms 修 饰 符 ， 而 且 必 须 是 方法 的 最 后 一 个 参数 。 事 实 上 ， 你 不 会 经 常 使 用 params 修 饰 符 。 但 要 
知道 的 是 ， 基 础 类 库 中 的 许多 方法 都 使 用 了 这 个 C# 语 言 特性 
为 了 说 明 这 些 关键 字 的 使 用 ， 新 建 一 个 控制 台 应 用 程序 FunWithMethods。 现 在 ， 让 我 们 依次 浏览 
每 一 个 关键 字 的 作用 。 区 


4.1.1 默认 的 参数 传递 行为 

参数 传人 于 数 的 默认 行为 是 按 值 传递 。 简 单 来 说 ， 如 果 没 有 为 参数 标记 参数 相关 的 修饰 符 ， 数 据 
的 副本 就 会 被 传人 函数 。 本 章 的 末尾 会 说 明 ， 到 底 复制 什么 取决 于 参数 是 值 类 型 还 是 引用 类 型 。 而 现 
在 ,假设 Program 类 中 的 如 下 方法 操作 两 个 按 值 传递 的 数值 数据 类 型 . 


// 默认 情况 下 参数 会 按 值 传递 
static int Add(int x, int y) 


int ans = x + y; 


// 由 于 我 们 修改 的 是 原始 数据 的 副本 ,调用 者 不 会 看 到 这 些 改变 


x = 10000; 
y = 88888; 
return ans; 


} 

数值 数据 属于 值 类 型 。 因 此 ， 如 果 在 成 员 的 作用 域内 修改 参数 的 值 ， 改 变 的 就 是 调用 者 数据 值 的 
副本 ,调用 者 完全 不 会 意识 到 这 种 改变 。 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Methods *****\n"); 


// 按 值 传 入 两 个 变量 

int x = 9, y = 10; 

Console.WritelLine("Before call: X: {0}, Y: {1}", x, y); 
Console.WriteLine("Answer is: {0}", Add(x, y)); 
Console.WriteLine("After call: X: {0}, Y: {1}", x, y); 
Console.ReadLine(); 


} 
和 我 们 期 望 的 那样 ,x 和 y 的 值 在 调用 Add() 之 前 和 之 后 保持 不 变 , 因为 数据 点 是 按 值 传 递 的 ， 如 下 
所 示 。Add() 操 作 的 是 数据 的 副本 ， 因 而 调用 者 不 会 意识 到 Add() 方 法 参数 的 任何 改变 。 





****** Fun with Methods 冰冰 冰冰 炒 
Before call: X: 9, Y: 10 
Answer is: 19 


After call: X: 9， Ys 10 
mem 





er et rar 
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4.1.2 ”out 修饰 符 


接 下 来 ， 我 们 将 使 用 输出 参数 。 定 义 为 带 有 输出 参数 ( 通过 关键 字 out ) 的 方法 有 义务 在 退出 这 
个 方法 之 前 ， 给 参数 赋 一 个 恰当 的 值 ( 如果 不 这 样 做 ， 就 会 产生 编译 器 错误 )。 

例如 ， 下 面 是 另 一 个 版 本 的 Add() 方 法 ， 它 使 用 C# 的 out 修 饰 符 返回 两 个 整数 的 和 ( 注意， 这 个 方 
法 实际 的 返回 值 现 在 是 void ): 

// 输出 参数 由 被 调用 的 方法 赋值 

static void Add(int x, int y, out int ans) 


ans =x+y; 


调用 一 个 带 有 输出 参数 的 方法 也 需要 使 用 out 修 饰 符 。 但 是 作为 输出 变量 传递 的 本 地 变量 在 将 它 
们 作为 输出 变量 传递 前 不 需要 赋值 ( 如 果 这 样 做 了 ， 原 来 的 值 在 调用 后 就 会 丢失 )， 编 译 器 允许 你 传 
递 未 分配 的 数据 ,原因 在 于 所 调用 的 方法 内 部 必须 包含 这 种 分 配 。 例 如 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with Methods *****"); 


“7// 不 需要 给 作为 输出 参数 的 本 地 变量 赋 初 值 ， 假 设 第 一 次 使 用 它们 时 是 将 其 作为 输出 参数 的 
int ans; 
Add(90, 90, out ans); 
Console.WritelLine("90 + 90 = {0}", ans); 
Console.ReadLine(); 
} 
前 面 的 例子 意 在 说 明 ， 实际 上 没有 必要 用 输出 参数 返回 这 两 个 数 的 和 。 然 而 ，C# 的 out 修 饰 符 的 
确 有 一 个 很 有 用 的 用 途 : 通过 它 ， 调 用 者 只 使 用 一 次 方法 调用 就 能 获得 多 个 返回 值 。 
// 返回 多 个 输出 参数 
static void FillTheseValues(out int a, out string b, out bool c) 
a=9; 
b = "Enjoy your string."; 
c = true; 


调用 者 可 以 调用 FillTheseValues() 方 法 。 请 注意 ， 在 调用 和 实现 该 方法 时 ， 必 须 使 用 out 修 饰 符 。 
static void Main(string[] args) 
Console.WriteLine("***** Fun with Methods *****"); 


int i; string str; bool b; 
FillTheseValues(out i, out str, out b); 


Console.WriteLine("Int is: {0}", i); 
Console.WriteLine("String is: {0}", str); 
Console.WriteLine("Boolean is: {0}", b); 
Console.ReadLine(); 


最 后 ， 如 果 方 法 定义 了 输出 参数 ， 就 必须 在 退出 方法 之 前 为 这 个 参数 赋 一 个 有 效 值 。 因 此 ， 由 于 
输出 参数 没有 在 方法 域 中 被 赋值 ， 如 下 方法 会 导致 编译 器 错误 : 
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static void ThiswWontCompile(out int a) 


Console.WritelLine("Error! Forgot to assign output arg!"); 


4.1.3 ”ref 修 饰 符 


现在 考虑 C# 的 ref 参 数 修饰 符 的 用 法 。 如 果 希 望 方 法 可 以 对 在 调用 者 作用 域 中 声明 的 不 同 数 据 进 
行 操作 (通常 是 改变 它 的 值 )， 例 如 ， 排 序 和 交换 例 程 ， 就 必须 使 用 引用 参数 。 注 意 输出 参数 和 引用 
参数 之 间 的 区 别 。 

口 输出 参数 不 需要 在 它们 被 传递 给 方法 之 前 初始 化 ， 因 为 方法 在 退出 之 前 必须 为 输出 参数 赋值 。 

口 引用 参数 必须 在 它们 被 传递 给 方法 之 前 初始 化 ， 因 为 是 在 传递 一 个 对 已 存在 变量 的 引用 。 如 

果 不 赋 给 它 初始 值 ， 就 相当 于 要 对 一 个 未 赋值 的 本 地 变量 进行 操作 。 

下 面 通过 交换 两 个 string 变 量 的 方式 ( 此 处 可 使 用 任意 两 个 其 他 的 数据 类 型 ,包括 int bool1 float 

等 ) 来 看 看 ref 关 键 字 的 用 法 : 


// 引用 参数 
public static void SwapStrings(ref string s1, ref string s2) 





string tempStr = s1; 
S1 = S2j 
S2 = tempStr; 


这 个 方法 可 以 这 样 被 调用 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Methods *****"); 


string str1 = "Flip"; 

string str2 = "Flop"; 

Console.WritelLine("Before: {0}, {1} ", str1, str2); 
SwapStrings(ref str1, ref str2); 
Console.WriteLine("After: {0}, {1} ", str1i, str2); 
Console.ReadLine(); 


这 里 , 调用 者 给 局 部 字符 串 数 据 ( str1 和 str2 ) 赋 了 初始 值 。 一 旦 swapstrings() 的 调用 返回 , str1 
现在 包含 的 值 就 为 "Flop"， 而 str2 的 值 为 "Flip"， 如 下 所 示 : 





Before: Flip, Flop 
After: Flop, Flip 





说 明 4.5 节 会 再 次 讨论 C# 的 ref 关 键 字 。 我 们 可 以 看 到 ,这 个 关键 字 的 行为 会 根据 参数 是 值 类 型 ( 结 
构 ) 还 是 引用 类 型 (类 ) 而 变化 。 
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4.1.4 ”params 修 饰 符 


C# 使 用 params 关 键 字 支持 参数 数组 的 使 用 。 要 理解 这 个 语言 特性 ， 就 必须 理解 如 何 操作 C# 数 组 。 
如 果 不 是 这 样 的 话 ， 你 可 能 会 希望 在 读 完 4.2 节 之 后 再 回 到 这 里 。 

params 关 键 字 可 以 把 可 变数 量 的 参数 ( 相同 类 型 ) 作为 单个 逻辑 参数 传 给 方法 。 同 样 ， 如 果 调 用 
者 传人 强 类 型 数组 或 以 逗号 分 隔 的 项 列表 ， 以 params 关 键 字 标 记 的 参数 就 可 以 被 处 理 。 恩 ， 的 确 有 些 
乱 。 为 了 理 清 思路 , 让 我 们 创建 一 个 函数 , 它 允 许 调用 者 传人 任何 数量 的 参数 并 返回 计算 后 的 平均 值 。 

如 果 我 们 采用 这 个 方法 作为 原型 来 接受 double 数 组 ， 就 需要 强制 调用 者 首先 定义 数组 ， 然 后 填充 
数组 ， 最 后 把 它 传 给 方法 。 然 而 ， 如 果 我 们 定义 了 CalculateAverage() 来 接收 double[] 数 据 类 型 的 
params， 调 用 者 只 需要 传人 以 逗号 分 隔 的 double 列 表 。.NET 运 行 库 会 在 后 台 自 动 把 这 组 double 包 装 成 
为 一 个 double 类 型 的 数组 。 

// 返回 一 些 double 型 的 平均 值 

static double CalculateAverage(params double[] values) 


Console.WriteLine("You sent me {0} doubles.", values.Length); 


double sum = 0; 
if(values.Length == 0) 
return sum; 


for (int i = 0; i «< values.Length; i++) 
sum += values[i]; 
return (sum / values.Length); 


} 
这 个 方法 定义 为 带 有 一 个 double 型 参数 数组 。 这 个 方法 相当 于 “在 说 ”:“ 传 递 给 我 任意 个 double 型 
(包括 0 ) 的 数 , 我 会 计算 它们 的 平均 值 ,” 因 此 , 可 以 用 下 列 任何 一 种 方式 调用 CalculateAverage() 方 法 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with Methods *****"); 


// 传递 进 一 个 以 到 号 分 陪 的 double 型 数 的 列表 

double average; 

average = CalculateAverage(4.0, 3.2, 5.7, 64.22, 87.2); 
Console.WritelLine("Average of data is: {0}", average); 


// … 或 传递 一 个 double 型 的 数组 

double[] data = { 4.0, 3.2, 5.7 }; 

average = CalculateAverage(data); 
Console.WritelLine("Average of data is: {oy" ，average); 


// 0 的 平均 值 是 0 
Console.WritelLine("Average of data is: {0}", CalculateAverage()); 
Console.ReadLine(); 


如 果 在 定义 CalculateAverage() 时 没有 使 用 params 修 饰 符 ， 在 第 一 次 调用 该 方法 时 将 导致 编译 带 
错误 ， 因 为 编译 器 需要 的 是 包含 5 个 double 参 数 的 CalculateAverage()。 





说 明 eon Ch 雪夫 方法 只 冯 种 一 机 parans 参 新 ， 而 且 必 须 是 参数 列表 中 的 最 后 一 个 参 艇 。 
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你 可 能 也 猜 到 了 ， 这 项 技术 只 不 过 对 调用 者 来 说 方便 了 一 些 ， 因 为 CLR 还 是 需要 创建 数组 。 如 果 
数组 在 被 调用 的 方法 域 中 ， 我 们 完全 可 以 把 它 当 做 一 个 完整 的 .NET 数 组 ， 其 中 包含 了 System.Array 基 
础 类 库 类 型 的 所 有 功能 。 考 虑 如 下 输出 : 





You sent me 5 doubles. 
Average of data is: 32.864 
You sent me 3 doubles. 
Average of data is: 4.3 
You sent me 0 doubles . 
Average of data is: 0 


4.1.5 ”定义 可 选 参数 


C# 程 序 员 还 可 以 创建 包含 可 选 参数 的 方法 。 这 项 技术 允许 方法 的 调用 者 不 指定 不 必要 的 参数 ,而 
是 使 用 这 些 参数 的 默认 值 。 


说 明 如 第 16 章 所 述 ， 为 C# 加 入 可 选 参 数 的 一 个 主要 原因 是 简化 与 COM 对 象 的 互 操作 。 一 些微 软 的 对 
象 模型 ( 如 Office ) 的 功能 是 通过 COM 对 象 公开 的 , 而 这 些 很 久之 前 编写 的 代码 使 用 了 可 选 参数 。 


为 了 演示 可 选 参数 ， 假 设 我 们 有 一 个 定义 了 可 选 参数 的 EnterLogData() 方 法 : 
static void EnterLogData(string message, string owner = "Programmer") 


Console.Beep(); 
Console.WriteLine("Error: {0}", message); 
Console.WritelLine("Owner of Error: {0}", owner); 


这 里 的 最 后 一 个 string 参 数 使 用 参数 定义 中 的 赋值 语句 设置 了 默认 值 "Programmer"。 这 样 ， 我 们 
就 可 以 通过 两 种 方式 在 Main() 中 调用 EnterLogData() 了 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Methods *****"); 


EnterLogData("Oh no! Grid can't find data"); 
EnterLogData("Oh no! I can't find the payroll data", "CFO"); 


Console.ReadLine(); 


由 于 对 EnterLogData() 方 法 的 第 一 次 调用 并 没有 指定 第 二 个 string 参 数 ， 我 们 就 知道 应 该 由 程序 
员 对 丢失 数据 负责 ， 而 CFO 没 有 得 到 薪酬 数据 ( 因为 在 第 二 次 方法 调用 的 时 候 指 定 了 第 二 个 参数 )。 

非常 重要 的 一 点 是 ， 分 配给 可 选 参数 的 值 必须 在 编译 时 确定 ， 而 不 能 在 运行 时 确定 ( 否则 将 得 到 
编译 时 错误 )。 假 设 我 们 修改 了 EnterLogData() ， 增 加 了 一 个 可 选 参数 ， 如 下 所 示 : 

// 错误 | 可 选 参数 的 默认 值 必 须 在 编译 时 确定 


static void EnterLogData(string message, 
string owner = "Programmer", DateTime timeStamp = DateTime.Now) 
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Console.Beep(); 

Console.WritelLine("Error: {0}", message); 
Console.WritelLine("Owner of Error: {0}", owner); 
Console.WritelLine("Time of Error: {0}", timeStamp); 


这 将 无 法 通过 编译 ， 因 为 DataTime 类 的 Now 属 性 是 在 运行 时 而 不 是 在 编译 时 处 理 的 。 


说 明 为 了 避免 歧义 ， 可 选 参数 必须 放 在 方法 签名 的 最 后 。 将 可 选 参数 放 到 非 可 选 参数 的 前 面 将 导 
致 编译 时 错误 。 


4.1.6 ”使 用 命名 参数 调用 方法 


男 一 个 C# 语 言 特性 是 支持 命名 参数 。 说 实话 , 乍 看 上 去 这 个 语言 结构 除了 带 来 混淆 的 代码 外 ， 似 
乎 没什么 作用 。 再 说 一 句 实话 ， 可 能 真 的 是 这 样 ! 与 可 选 参数 一 样 ， 支 持 命名 参数 的 主要 原因 也 是 为 
了 简化 与 COM 的 互 操 作 (参见 第 16 章 )。 

命名 参数 允许 你 在 调用 方法 时 以 任意 顺序 指定 参数 的 值 。 因 此 ， 你 可 以 使 用 冒号 操作 符 通过 名 称 
来 指定 参数 ， 而 不 必 按 位 置 传递 参数 ( 就 像 你 在 大 多 数 情况 下 所 做 的 那样 )。 为 了 演示 命名 参数 的 用 
法 ， 假 设 我 们 的 Program 类 中 包含 如 下 的 方法 : 


static void DisplayFancyMessage(ConsoleColor textColor, 
ConsoleColor backgroundColor, string message) 


i 
// 在 消息 打印 前 保存 昌 的 颜色 
ConsoleColor oldTextColor = Console.ForegroundColor; 
ConsoleColor oldbackgroundColor = Console.BackgroundColor; 


// 设置 新 的 颜色 并 打印 消息 
Console.ForegroundColor 
Console.BackgroundColor 


textColor; 
backgroundColor; 


Console.WriteLine(message); 


// 恢复 原来 的 颜色 
Console.ForegroundColor = oldTextColor; 
Console.BackgroundColor = oldbackgroundColor; 


} 

按 现 在 DisplayFancyMessage() 方 法 的 书写 方式 ， 你 可 能 希望 调用 者 在 调用 该 方法 时 先 传递 两 个 
ConsoleColor 变 量 , 然后 是 一 个 string 类 型 。 不过, 像 下 面 这 样 使 用 命名 参数 进行 调用 也 完全 没有 问题 : 

static void Main(string[] args) 


Console.WritelLine("***** Fun With Methods *****"); 


DisplayFancyMessage(message: "Wow! Very Fancy indeed!", 
textColor: ConsoleColor.DarkRed, 
backgroundColor: ConsoleColor.White); 


DisplayFancyMessage(backgroundColor: ConsoleColor.Green, 
message: "Testing...", 
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textColor: ConsoleColor.DarkBlue); 
Console.ReadLine(); 


关于 命名 参数 的 一 个 小 问题 是 ， 如 果 你 在 调用 方法 的 时 候 使 用 了 位 置 参数 ,那么 它们 必须 列 在 所 
有 命名 参数 之 前 。 换 句 话 说， 命名 参数 必须 放置 在 方法 调用 的 最 后 。 例 如 ， 下 面 的 代码 : 


// 没有 问题 ， 因 为 位 置 参数 在 命名 参数 之 前 
DisplayFancyMessage(ConsoleColor. Blue, 
message: "Testing.. 
backgroundColor: ConsoleColor. White); 


// 错误 ， 因 为 位 置 参 数 在 命名 参数 之 后 

DisplayFancyMessage(message: "Testing...", 
backgroundColor: ConsoleColor.White, 
ConsoleColor.Blue); 


除了 这 项 限制 ， 你 可 能 仍然 不 清楚 究竟 在 什么 时 候 使 用 这 个 语言 特性 。 毕 竟 ， 如 果 你 要 为 一 个 方 
法 指定 3 个 参数 ， 何 苦 费力 不 讨好 地 变换 它们 的 顺序 呢 ? 

然而 事实 证 明 ， 如 果 你 定义 了 一 个 包含 可 选 参数 的 方法 ， 命 名 参数 就 非常 有 用 了 。 假 设 
DisplayFancyMessage() 现 在 支持 可 选 参数 ， 并 且 设 置 了 合适 的 默认 值 : 


static void DisplayFancyMessage(ConsoleColor textColor = ConsoleColor.Blue, 
ConsoleColor backgroundColor = ConsoleColor.White, 
string message = "Test Message") 


} 

由 于 每 个 参数 都 包含 默认 值 ， 调 用 者 就 可 以 使 用 命名 参数 只 指定 那些 不 希望 用 默认 值 的 参数 。 因 
此 ， 如 果 调 用 者 希望 在 白色 背景 上 显示 蓝 色 文本 “Hello”"， 只 需要 这 样 : 

DisplayFancyMessage(message: "Hello!"); 

或 者 ， 如 果 调 用 者 希望 在 绿色 背景 上 显示 蓝 色 文本 “Test Message”， 可 以 这 样 调用 Display- 
FancyMessage() : 

DisplayFancyMessage(backgroundColor: ConsoleColor.Green); 

如 你 所 见 ， 可 选 参 数 和 命名 参数 往往 会 一 起 使 用 。 在 研究 构建 C# 方 法 的 最 后 部 分 ,我 要 介绍 的 话 


源 代码 ”FunWithMethods 应 用 程序 位 于 Chapter 4 子 目 录 下 。 


4.1.7 成 员 重 载 


和 其 他 现代 的 面向 对 象 语言 一 样 ，C# 人 允许 方法 重 载 。 简 而 言 之 ， 当 我 们 定义 一 组 名 字 相 同 的 成 员 
时 ， 如 果 它 们 的 参数 数量 ( 或 类 型 ) 不 同 ， 这 样 的 成 员 就 叫做 被 重 载 。 

为 了 理解 为 什么 重 载 这 么 有 用 ， 让 我 们 从 VB6 开 发 者 的 角度 来 考虑 一 下 。 假 设 我 们 使 用 VB6 构 建 
了 一 组 返回 各 种 传人 类 型 ( Integer、Double 等 ) 的 求 和 的 方法 。 由 于 VB6 不 支持 方法 重 载 ， 我 们 就 只 
能 定义 唯一 一 组 本 质 上 做 同一 件 事 情 (返回 参数 的 总 和 ) 的 方法 : 
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”VB6 代 码 示例 
Public Function AddInts(ByVal x As Integer, ByVal y As Integer) As Integer 


AddInts = X + y 
End Function 


Public Function AddDoubles(ByVal x As Double, ByVal y As Double) As Double 
AddDoubles =x+y 
End Function 


Public Function AddLongs(ByVal x As Long, ByVal y As Long) As Long 
AddLongs = x + y 
End Function 


这 样 的 代码 不 仅 不 易于 维护 ， 而 且 调用 者 必须 痛苦 地 记 住 每 一 个 方法 的 名 字 。 使 用 重 载 ， 就 可 以 
允许 调用 者 调用 一 个 叫做 Add() 的 方法 。 同样 , 关键 是 要 确保 方法 的 每 一 个 版 本 都 有 不 同 的 参数 组 ( 只 
是 返回 类 型 不 同 的 成 员 不 够 唯一 )。 


说 明 在 第 9 章 中 我 们 会 解释 ， 我 们 可 以 构建 泛 型 方法 ， 以 进一步 提升 重 载 的 概念 。 使 用 泛 型 ， 我们 
可 以 为 方法 的 实现 定义 类 型 占 位 符 ， 并 且 在 调用 成 员 时 进行 指定 。 





让 我 们 新 建 一 个 控制 台 应 用 程序 MethodOverloading 来 亲自 体验 一 下 。 现 在 考虑 如 下 的 类 定义 : 


// C# 代 码 
class Program 


static void Main(string[] args) 
} 

// 重 载 的 Add() 方 法 

static int Add(int x, int y) 


{ return x + yj 


static double Add(double x, double y) 
{ return x + yj } 


static long Add(long x, long y) 
{ return x + yj 


现在 ， 调 用 者 只 需要 使 用 必需 的 参数 调用 Add() 方 法 ， 因 为 编译 器 可 以 通过 所 提供 的 参数 来 解析 
合适 的 实现 ， 从 而 进行 调用 ， 所 以 这 样 的 语法 完全 可 以 通过 编译 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Method Overloading *****\n"); 


// 调用 int 版 本 的 Add() 
Console.WritelLine(Add(10, 10)); 


// 调用 long 版 本 的 Add() 
Console.WriteLine(Add(900000000000, 900000000000)); 


// 调用 double 版 本 的 Add() 
Console.WriteLine(Add(4.3, 4.4)); 
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Console.ReadLine(); 
在 调用 重 载 方法 的 时 候 ，Visual Studio IDE 提 供 了 协助 。 当 输入 重 载 方法 的 名 字 时 ( 例如 我 们 熟悉 


的 Console.WriteLine() )， 智 能 感知 会 列 出 这 个 方法 所 有 版 本 的 列表 。 可 以 在 图 4-1 中 看 到 ， 我 们 可 以 
通过 使 用 键盘 的 上 下 键 在 各 个 重 载 方 法 之 间 切 换 。 


Program.cs* XX 2 = 
,MethodOverioading,Program ~ 全 ,Mainfstringi] acgs)} 
-nanespacs Methodoverloading 二 
《 
class 
stotic void Hain(strine{f}] args) 





itetine("****™ Fun with Method Overlosding “=**\n"); 
Colls 383 versicer of dae} 
-Writetine(Add(10, 10)); 
Calls long versicn of addty 
iriteLine(Add(900900000980，900080000086)); 


alis doubie version of Addi 
"WriteLine(Add(4.3, 4.4)); 
9 WriteLine 
A 11ofl9 9 vod Console.Wntelinelstring value} 
Weites the specified string value foilowed by the cutrent line terrminator, to the standard output stream. | 
vatwe: The voive to write. | 


i106% =» 


图 4-1 Visual Studio 对 重 载 成 员 的 智能 感知 





源 代 码 ”MethodOverloading 项 目的 源 代码 位 于 Chapter 4 子 目 录 下 。 








这 样 , 有 关 使 用 C# 语 法 构建 方法 的 基本 研究 到 此 结束 。 接着 , 让 我 们 来 看 看 如 何 构建 和 操作 数组 、 
枚 举 以 及 结构 。 


4.2 ”C# 数 组 


你 应 该 已 经 知道 ， 数 组 是 一 组 通过 数字 索引 来 访问 的 数据 项 。 更 精确 地 说 ， 数 组 是 一 组 相同 类 型 的 
数据 点 (int 数 组、string 数 组 、SportsCar 数 组 等 )。 使 用 C# 声 明 数组 很 简单 。 让 我 们 新 建 一 个 控制 台 应 
用 程序 项 目 FunWithArrays 来 演示 ， 在 项 目 中 有 一 个 会 从 Main() 调 用 的 叫做 SimpleArrays() 的 辅助 方法 : 

class Program 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Arrays *****"); 
SimpleArrays(); 
Console.ReadLine(); 


} 

static void SimpleArrays() 
Console.WritelLine("=> Simple Array Creation."); 
// 赋值 一 个 包含 3 个 元 素 的 整数 数组 ， 编 号 为 0、1、2 
int[] myInts = new int[3]; 


// 初始 化 一 个 100 项 的 字符 串 数 组 ， 编 号 0 一 99 


102 第 4 章  C# 核 心 编程 结构 工 


string[] booksOnDotNet = new string[100]; 
Console.WritelLine(); 
} 
仔细 看 前 面 那 段 代 码 的 注释 。 如 果 使 用 这 个 语法 声明 C# 数 组 的 话 ,， 数组 声明 中 的 数字 就 表示 项 的 
总 数 , 而 不 是 上 界 。 还 应 注意 , 数组 的 下 界 总 是 从 0 开始 , 因此 , 如 果 我 们 写 int[] myInts = new int[3]， 
最 后 我 们 会 得 到 一 个 包含 3 个 元 素 的 数组 ( 编号 0~2 )。 
定义 了 数组 变量 后 ， 就 可 以 使 用 索引 来 填充 元 素 索 引 了 。 更 新 后 的 SimpleArrays() 方 法 如 下 所 示 : 
static void SimpleArrays() 
Console.WritelLine("=> Simple Array Creation."); 
// 创建 数组 并 且 填 充 3 个 整数 
int[] myInts = new int[3]; 
myInts[0] = 100; 


myInts[1] = 200; 
myInts[2] = 300; 


// 现在 输出 每 一 个 值 
foreach(int i in myInts) 
Console.Writeline(i); 

Console.WriteLine(); 


说 明 ”如 果 我 们 声明 数组 ， 而 不 是 显 式 填 充 每 个 索引 ， 那 么 ,每 一 个 项 都 会 被 设置 为 数据 类 型 的 默 
认 值 (例如 ，bool 的 数组 就 被 设置 为 false，int 的 数组 就 被 设置 为 0， 以 此 类 推 )。 


4.2.1 “C# 数 组 初始 化 语法 


除了 逐个 元 素 填充 数组 之 外 ， 还 可 以 使 用 C# 数 组 初始 化 语法 来 填充 数组 的 元 素 ， 通 过 在 花 括 号 
( 人 } ) 内 指定 每 一 个 数组 项 来 实现 。 如 果 我 们 需要 创建 一 个 已 知 大 小 的 数组 ， 并 且 和 希望 快速 指定 初始 
值 ， 这 个 语法 就 很 有 有用。 例如， 下 面 是 另 一 种 方式 的 数组 声明 : 


static void ArrayInitialization() 
Console.WriteLine("=> Array Initialization."); 


// 使 用 new 关 键 字 的 数组 初始 化 语法 
string[] stringArray = new string[] 
{ "one", "two", "three" }; 
Console.WritelLine("stringArray has {0} elements", stringArray.Length); 


// 不 使 用 new 关 键 字 的 数组 初始 化 语法 
bool[] boolArray = { false, false, true }; 
Console.WritelLine("boolArray has {0} elements", boolArray.Length); 


// 使 用 new 关 键 字 和 大 小 的 数组 初始 化 

int[] intArray = new int[4] { 20, 22, 23, 0 }; 
Console.Writeline("intArray has {0} elements", intArray.Length); 
Console.Writeline(); 


} 
注意 ， 当 使 用 “ 花 括 号 ”语法 时 , 不 需要 指定 数组 大 小 ( 如 构建 stringArray 类 型 的 变量 时 )， 因 为 这 
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可 以 通过 花 括 号 中 项 的 个 数 进行 推断 。 还 要 注意 , new 关键 字 是 可 选 的 ( 如 构建 boolArray 类 型 的 变量 时 )。 
在 intArray 声 明 的 例子 中 ， 要 记 住 指定 的 数字 值 是 数组 中 元 素 的 总 数 而 不 是 上 界 值 。 如 果 声 明 的 
大 小 和 初始 化 的 个 数 不 匹 配 ， 就 会 收 到 一 个 编译 器 错误 ， 如 下 所 示 : 


// 哦 ! 大 小 和 元 素 不 匹配 
int[] intArray = new int[2] { 20, 22, 23, 0 }; 


4.2.2 隐 式 类 型 本 地 数组 


我 们 在 上 一 章 中 学 习 了 隐 式 类 型 本 地 变量 ， 它 由 var 关 键 字 定 义 ， 其 实际 类 型 由 编译 器 确定 。 同 
样 ，var 关 键 字 也 可 以 用 来 定义 隐 式 类 型 本 地 数组 。 这 样 我 们 在 分 配 新 数组 变量 的 时 候 ， 就 不 需要 指 
定数 组 本 身 所 包含 的 类 型 。 


static void DeclareImplicitArrays() 
Console.WritelLine("=> Implicit Array Initialization."); 


// a 实际 上 是 int[] 
var a = new[] { 1, 10, 100, 1000 }; 
Console.WriteLine("a is a: {0}", a.ToString()); 


// b 实 际 上 是 double[] 
var b = new[] { 1, 1.5, 2, 2.5 }; 
Console.WriteLine("b is a: {0}", b.ToString()); 


// c 实 际 上 是 string[] 

var 5 = new[] { "hello", null, "world" }; 
Console.WriteLine("c is a: {0}", c.ToString()); 
Console.WritelLine(); 


} 

当然 , 在 你 用 C# 的 隐 式 语法 分 配 数组 的 时 候 , 数组 的 初始 化 列表 中 每 一 项 的 类 型 都 应 该 是 相同 的 
(例如 ， 全 都 是 int 、string 或 SportsCar )。 与 你 猜 的 不 太一 样 ， 隐 式 类 型 本 地 数组 的 项 默认 不 是 
System.0bject， 因 此 下 面 的 代码 将 生成 编译 时 错误 : 


// 错误 | 混合 类 型 
var d = new[] { 1, "one", 2, "two", false }; 


4.2.3 ”定义 object 数 组 


在 大 部 分 情况 下 ， 在 定义 数组 的 时 候 可 以 指定 保存 在 数组 变量 中 的 项 类 型 。 这 看 起 来 很 简单 ， 但 
有 一 点 需要 注意 。 在 第 6 章 中 ,我们 会 知道 ，System.0bject 是 .NET 类 型 系统 中 所 有 类 型 ( 包括 基本 数 
据 类 型 ) 的 最 终 基 类 。 基 于 这 一 点 ， 如 果 定 义 了 一 个 System.0bject 的 数组 ， 子 项 就 可 以 是 任何 东西 。 
考虑 如 下 Array0fobjects() 方 法 (同样 ， 可 以 从 Main() 调 用 进行 测试 ): 

static void ArTrayOf0bjects() 


Console.WTiteLine("=> Array of Objects."); 


// 对 象 数 组 可 以 是 任何 东西 
object[] myObjects = new object[4]; 
myObjects[0] = 10; 
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myObjects[1] = false; 

myObjects[2] = new DateTime(1969, 3, 24); 
myObjects[3] = "Form & Void"; 

foreach (object obj in myObjects) 

{ 


// 输出 数组 中 每 一 项 的 类 型 和 值 
Console.WriteLine("Type: {0}, Value: {1}", obj.GetType(), obj); 


Console.WriteLine(); 


在 这 里 ， 我 们 遍历 my0bjects 的 内 容 ， 并 使 用 System.0bject 的 GetType() 方 法 输出 每 一 项 的 实际 类 
型 以 及 当前 项 的 值 。 在 这 里 我 们 不 会 过 多 研究 有 关 System.0bject.GetType() 方 法 的 细节 ， 只 需要 理解 
这 个 方法 用 于 获取 项 的 完全 限定 名 (第 15 章 会 完整 研究 类 型 信息 和 反射 服务 相关 主题 )。 下 面 的 输出 
为 调用 Array0fObjects() 的 结果 。 





=> Array of Objects . 

Type: System.Int32, Value: 10 

Type: System.Boolean, Value: False 

Type: System.DateTime, Value: 3/24/1969 12:00:00 AM 
Type: System.String, Value: Form & Void 





4.2.4 使 用 多 维 数组 


除了 前 面 我 们 已 经 见 到 的 一 维 数组 以 外 ，C# 还 支持 两 种 多 维 数组 。 第 一 个 叫做 矩形 数组 ， 它 只 是 
一 个 每 一 行 长 度 都 相同 的 多 维 数组 。 如 下 代码 声明 并 填充 一 个 多 维和 矩形 数组 : 


static void RectMultidimensionalArray() 


Console.WriteLine("=> Rectangular multidimensional array."); 
// 矩形 多 维 数组 

int[,] myMatrix; 

myMatrix = new int[6,6]; 


// 填充 6*6 数 组 
for(int i = 0; i «< 6; i++) 
for(int j = 0; j < 
myMatrix[i, j] = 


// 输出 6*6 数 组 
for(int i = 0; i < 6; i++) 


for(int j = 0; j < 6; j++) 
Console.Write(myMatrix[i, j] + "\t"); 
Console.WritelLine(); 


Console.WritelLine(); 


第 二 种 多 维 数组 的 类 型 叫做 交错 数组 。 顾 名 思 义 ,交错 数组 包含 一 些 内 部 数组 ， 每 一 个 都 有 各 自 
的 上 界 ， 例 如 : 


static void JaggedMultidimensionalArray() 
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Console.WriteLine("=> Jagged multidimensional array."); 
// 交错 多 维 数组 ”( 也 就 是 数组 的 数组 ) 

// 声明 一 个 具有 5 个 不 同 数组 的 数组 

int[][] myJagArray = new int[5][]; 


// 创建 交错 数组 
for (int i = 0; i < myJagArray.Length; i++) 
myJagArray[i] = new int[i + 7]; 


// 输出 每 一 行 ( 记 住 ， 每 一 个 元 素 都 默认 为 0) 


for(int i = 0; i < 5; i++) 
{ 
for(int j = 0; j < myJagArray[i].Length; j++) 


Console.Write(myJagArray[i][j] + " "); 
Console.WritelLine(); 


Console.WritelLine(); 


} 
4-2 展 示 了 调用 Main() 方 法 中 的 RectMultidimensionalArray() 和 JaggedMultidimensionalArray() 方 法 
的 输出 。 
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图 4-2 ” 算 形 多 维 数组 和 交错 多 维 数组 


4.2.5 数组 作为 参数 〈 和 返回 值 ) 


只 要 我 们 创建 了 一 个 数组 ， 就 完全 可 以 把 它 作 为 参数 进行 传递 或 作为 成 员 返 回 值 接收 。 例 如 ， 如 
下 PrintArray() 方 法 接收 传人 的 int 数 组 并 将 每 一 个 成 员 输 出 到 控制 台 ， 而 GetStringArray() 则 填充 
string 数 组 并 返回 给 调用 者 : 
static void PrintArray(int[] myInts) 
for(int i = 0; i < myInts.Length; i++) 


Console.WriteLine("Item {0} is {1}", i, myInts[i]); 


} 
static string[] GetStringArray() 


string[] theStrings = {"Hello", "from", "GetStringArray"}; 
return theStrings; 
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这 些 方法 的 调用 方式 我 们 也 能 想到 : 


static void PassAndReceiveArrays() 


Console.WritelLine("=> Arrays as params and return values."); 
// 传递 数组 作为 参数 
int[] ages = {20, 22, 23, 0}; 
PrintArray(ages); 
// 获取 数组 作为 返回 值 
string[] strs = GetStringArray(); 
foreach(string s in strs) 
Console.WritelLine(s); 


Console.WriteLine(); 


那么 ,至 此 你 应 该 能 很 好 地 理解 定义 、 填 充 和 获取 C# 数 组 变量 内 容 的 整个 过 程 了 。 为 了 完善 这 个 
知识 体系 ， dn 一 下 System.Array 类 的 作用 。 


4.2.6 ”System.Array 基 类 


我 们 创建 的 每 一 个 数组 都 从 System.Array 类 获得 了 很 多 功能 。 使 用 这 些 公共 成 员 ， 我 们 就 能 使 用 
统一 的 对 象 模 型 来 操作 数组 。 表 4-2 列 出 其 中 一 些 有 趣 的 成 员 ( 对 于 完整 细节 , 请 参阅 .NET Framework 
4.5 SDK )。 


表 4-2 ”System.Array 的 部 分 成 员 


Array 类 的 成 员 作 用 
Clear() 这 个 静态 方法 将 数组 中 一 系列 元 素 设置 为 空 值 ( 值 项 为 0， 对 象 引用 为 nul1， 布 尔 值 为 false ) 
CopyTo() 这 个 方法 用 来 将 源 数组 中 的 元 素 复制 到 目标 数组 中 
Length 这 个 属性 返回 数组 中 项 的 个 数 
Rank 这 个 属性 返回 当前 数组 维 数 
Reverse() 这 个 静态 方法 反 转 一 维 数组 的 内 容 
Sort() 这 个 静态 方法 为 内 建 类 型 的 一 维 数组 排序 。 如 果 数 组 中 的 元 素 实现 了 IComparer 接 口 ， 我们 就 


可 以 为 自 定义 类 型 排序 ( 见 第 9 章 ) 





让 我 们 实际 运用 一 下 这 些 成 员 。 下 面 的 辅助 方法 使 用 了 Reverse() 和 Clear() 方 法 来 提取 有 关 数 组 
的 信息 并 输出 到 控制 台 


static void SystemArrayFunctionality() 


Console.WriteLine("=> Working with System.Array."); 
// 初始 化 起 始 项 
string[] gothicBands = {"Tones on Tail", "Bauhaus", "Sisters of Mercy"}; 


// 按 声 明 的 次 序 输出 名 字 
Console.WriteLine("-> Here is the array:"); 
for (int i = 0; i < gothicBands.Length; i++) 


{ 
// 输出 一 个 名 字 
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Console.Write(gothicBands[i] + ", "); 
Console.WriteLine("\n"); 


// 反 转 它们 

Array.Reverse(gothicBands); 
Console.WritelLine("-> The reversed array"); 
// 输出 它们 

for (int i = 0; i «< gothicBands.Length; i++) 


{ 
// 输出 一 个 名 字 
Console.Write(gothicBands[i] + ", "); 





Console.WriteLine("\n"); 


// 清除 除了 最 后 成 员 之 外 的 所 有 项 
Console.WritelLine("-> Cleared out all but one..."); 
Array.Clear(gothicBands, 1, 2); 

for (int i = 0; i < gothicBands.Length; i++) 


{ 
// 输出 一 个 名 字 
Console.Write(gothicBands[i] + ", "); 


Console.Writeline(); 


} 
如 果 从 Main() 中 调用 这 个 方法 ,会 得 到 如 下 所 示 的 输出 结果 。 





=> Working with System.Array. 
-> Here is the array: 
Tones on Tail, Bauhaus, Sisters of Mercy, 


-> The reversed array 
Sisters of Mercy, Bauhaus, Tones on Tail, 


-> Cleared out all but one... 
Sisters of Mercy，，， 








注意 ,System.Array 的 很 多 成 员 都 定义 为 静态 方法 ,因此 可 以 在 类 级 别 进 行 调用 ( 如 Array.Sort() 
或 Array.Reverse() 方 法 )。 这 样 的 方法 都 需要 传人 到 我 们 希望 处 理 的 数组 。System.Array 的 其 他 方法 
( Length 属 性 ) 绑 定 在 对 象 级 别 上 ， 因 此 我 们 可 以 直接 在 数组 上 调用 成 员 。 


源 代码 ”FunWithArrays 项 目的 源 代 码 位 于 Chapter 4 子 目 录 下 。 





4.3 枚 举 类 型 


第 1 章 介 绍 过 ，.NET 类 型 系统 由 类 、 结 构 、 枚 举 、 接 口 和 委托 组 成 。 让 我 们 从 枚 举 ( enumeration ， 
也 可 以 简写 为 enum ) 开始 对 这 些 类 型 的 考查 ， 首 先 新 建 一 个 名 为 FunWithEnums 的 控制 台 应 用 程序 。 
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注意 不 要 混淆 “ 枚 举 ”( enum ) 和 “ 枚 举 器 ”( enumerator )， 它 们 是 完全 不 同 的 概念 。 枚 举 是 自 定 
义 的 名 / 值 对 的 数据 类 型 。 枚 举 器 是 实现 了 .NET 接 口 TEnumerable 的 类 或 结构 。 通 常 来 说 ， 集 合 
类 和 System.ArTray 类 会 实现 该 接口 。 你 将 在 第 8 章 看 到 ， 支 持 IEnumerable 的 对 象 可 以 用 于 
foreach 循 环 。 


在 构建 系统 的 时 候 , 创建 一 组 符号 名 来 对 应 已 知 的 数字 值 会 很 方便 。 例 如 ， 如 果 创 建 一 个 工资 系 
统 ， 我 们 可 能 会 希望 使 用 诸如 副 总 裁 、 经 理 、 职 员 、 实 习 生 等 常量 来 指 代 员工 类 型 。C# 支 持 自 定义 枚 
举 的 概念 来 满足 这 种 需求 。 例 如 ， 下 面 是 一 个 名 为 EmpType 的 枚 举 : 

// 自 定义 枚 举 

te EmpType 


Manager, / 
Grunt, / 
Contractor, / 
VicepPresident / 


[| 
WUEPO 


EmpType 枚 举 定义 了 4 个 命名 常量 来 对 应 一 些 离散 的 数值 。 默 认 情况 下 ， 第 一 个 元 素 被 设置 为 值 0， 
其 余 的 按照 对 1 递 推 。 如 果 需 要 的 话 ， 我 们 完全 可 以 改变 初始 值 。 例 如 ， 如 果 需 要 EmpType 的 成 员 是 
102~105， 我 们 可 以 这 样 做 : 

// 从 102 开 始 

EmpType 


Manager = 102， 

Grunt, // = 103 
Contractor, // = 104 
VicePresident // = 105 


枚 举 不 一 定 是 连续 的 , 也 不 需要 有 唯一 值 。 如 果 ( 由 于 种 种 原因 ) 按 如 下 所 示 创 建 EmpType 是 有 意 
义 的 话 ， 当 然 也 可 以 通过 编译 : 

// 枚 举 的 元 素 不 需要 是 连续 的 

enum EmpType 

{ 


Manager = 10， 
Grunt = 1， 
Contractor = 100， 
VicepPresident = 9 


4.3.1 控制 枚 举 的 底层 存储 


默认 情况 下 ， 用 来 保存 枚 举 值 的 存储 类 型 是 System.Int32 ( C# int )， 当 然 也 可 以 改 成 我 们 喜欢 的 
类 型 。C# 枚 举 可 以 以 相似 的 方式 定义 为 核心 系统 类 型 (byte 、short 、int 或 1ong )。 例如 ， 如 果 和 希望 将 
EmpType 的 实际 存储 值 设 置 为 一 个 byte 而 不 是 一 个 int， 可 以 这 么 写 : 


// 这 次 ，EmpType 对 应 实际 的 byte 
enum EmpType : byte 
{ 
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Manager = 10， 
Grunt = 1， 
Contractor = 100， 
VicepPresident = 9 


} 

如 果 我 们 构建 的 .NET 应 用 程序 将 会 被 部 署 在 低 内 存 的 设备 中 ( 如 支持 .NET 的 手机 或 PDA )， 并 且 
希望 尽 可 能 节省 内 存 ， 那 么 改变 枚 举 的 实际 类 型 可 能 会 很 有 用 。 当 然 ， 如 果 确 实 使 用 byte 作 为 存储 来 
创建 枚 举 ， 每 一 个 值 就 必须 在 其 范围 之 内 ! 例如 ， 下 面 的 EmpType 会 导致 编译 器 错误 ， 因 为 值 999 所 占 
的 空间 大 于 一 个 字 节 : 四 


// 编译 器 错误 | 999 所 占 的 空间 大 于 一 个 字 节 
enum EmpType : byte 
{ 


Manager = 10， 

Grunt = 1, 
Contractor = 100， 
VicepPresident = 999 


4.3.2 ”声明 枚 举 变量 


设 定 了 枚 举 的 范围 和 存储 类 型 之 后 ,就 可 以 使 用 它 来 替代 所 谓 的 幻 数 了 。 因 为 枚 举 只 不 过 是 用 户 
自 定义 的 类 型 ， 我们 可 以 把 它们 作为 函数 的 返回 值 、 方 法 参数 、 本 地 变量 等 。 假 设 我 们 有 一 个 叫做 
AskForBonus() 的 方法 ， 它 接受 EmpType 变 量 作为 唯一 的 参数 。 根 据 传人 参数 的 值 ， 我 们 输出 对 应 奖金 
请 求 的 响应 : 

class Program 


static void Main(string[] args) 


Console.WriteLine("**** Fun with Enums *****"); 
// 创建 职员 的 类 型 

EmpType emp = EmpType.Contractor; 

AskForBonus (emp); 

Console.ReadLine(); 


} 


// 用 枚 举 作 为 参数 
static void AskForBonus(EmpType e) 


switch (e) 
{ 


case EmpType.Manager: 

Console.WriteLine("How about stock options instead?"); 
break; 
case EmpType.Grunt: 

Console.WritelLine("You have got to be kidding..."); 
break; 
case EmpType.Contractor: 

Console.WritelLine("You already get enough cash..."); 
break; 
case EmpType.VicePresident: 

Console.WriteLine("VERY GOOD, Sir!"); 
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break; 


} 
} 


注意 ， 为 枚 举 变量 赋值 时 ， 必 须 以 枚 举 名 (EmpType ) 来 设置 值 ( Grunt )。 因 为 枚 举 是 固定 的 一 组 
名 称 / 值 对 ， 将 枚 举 变量 设置 为 枚 举 类 型 没有 定义 的 值 是 不 合法 的 : 
static void ThisMethodwillNotCompile() 


// 错误 ! SalesManager 不 在 EmpType 枚 举 中 
EmpType emp = EmpType.SalesManager; 


// 错误 ! 忘记 设 定 Grunt 值 为 EmpType 枚 举 
emp = Grunt; 


4.3.3 System.Enum 类 型 


.NET 枚 举 从 System.Enum 类 类 型 获得 了 很 多 功能 。 这 个 类 定义 了 许多 用 来 查询 和 转换 某 个 枚 举 的 
方法 。 一 个 很 有 用 的 方法 就 是 静态 的 Enum.GetUnderlyingType() 方 法 ， 顾 名 思 义 ， 它 返回 用 于 保存 枚 
举 类 型 值 的 数据 类 型 ( 对 于 当前 的 EmpType 声 明 ， 就 是 System.Byte )。 

static void Main(string[] args) 

Console.WriteLine("**** Fun with Enums *****"); 
// 创建 职员 的 类 型 


EmpType emp = EmpType.Contractor; 
AskForBonus (emp); 


// 输出 枚 举 的 存储 

Console.WriteLine("EmpType uses a {0} for storage", 
Enum.GetUnderlyingType(emp.GetType())); 

Console.ReadLine(); 


如 果 我 们 查阅 Visual Studio 对 象 浏览 器 ， 就 会 发 现 Enum.GetUnderlyingType() 方 法 需要 我 们 传人 
System.Type 作 为 第 一 个 参数 。Type 表 示 某 个 .NET 实 体 的 元 数据 描述 ， 这 在 第 15 章 中 会 详细 介绍 。 

获取 元 数据 的 一 个 可 行 方式 ( 前面 提 到 过 ) 是 使 用 GetType() 方 法 ， 这 个 方法 是 所 有 .NET 基 础 类 
库 中 的 类 型 所 共有 的 。 另 外 一 种 方式 是 使 用 C# 的 typeof 操 作 符 。 这 样 做 的 好 处 是 ， 不 需要 我 们 持 有 希 
望 获取 元 数据 描述 的 实体 的 变量 。 


// 使 用 typeof 获 取 一 个 Type 
Console.WritelLine("EmpType uses a {0} for storage", 
Enum.GetUnderlyingType(typeof(EmpType))); 


4.3.4 动态 获取 枚 举 的 名 称 / 值 对 


除了 Enum.GetUnderlyingType() 方 法 之 外 ,所 有 C# 枚 举 都 支持 Tostring() 方 法 , 它 返回 当前 枚 举 值 
的 字符 串 名 。 例 如 : 


static void Main(string[] args) 
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Console.WriteLine("**** Fun with Enums *****"); 
EmpType emp = EmpType.Contractor; 
ASKForBonus (emp); 


// 输出 “emp is a Contractor” 
Console.WriteLine("emp is a {0}.", emp.ToString()); 
Console.ReadLine(); 


} 


如 果 和 希望 获取 某 个 枚 举 变 量 值 ( 而 不 是 它 的 名 字 )， 只 需要 根据 底层 存储 类 型 对 枚 举 变量 进行 强 
制 类 型 转换 即 可 。 例 如 : 


static void Main(string[] args) 





Console.WritelLine("**** Fun with Enums *****"); 
EmpType emp = EmpType.Contractor; 


// 输出 “Contractor = 100” 
Console.WriteLine("{0} = {1}", emp.ToString(), (byte)emp); 
Console.ReadLine(); 


说 明 静态 的 Enum.Format() 方 法 通过 指定 期 望 的 格式 化 标志 来 提供 更 好 的 格式 化 选项 。 有 关 
System.Enum.Format() 方 法 的 完整 细节 ， 请 参考 .NET Framework 4.5 SDK 文 档 。 








System.Enum 还 定义 了 男 外 一 个 名 为 GetValues() 的 静态 方法 。 这 个 方法 返回 System.Array 的 一 个 实 
例 。 数 组 中 每 一 项 都 对 应 指定 枚 举 的 一 个 成 员 。 考 虑 如 下 方法 ， 它 会 输出 作为 参数 传人 的 任何 枚 举 中 
的 每 一 个 名 称 / 值 对 : 

// 这 个 方法 会 输出 任何 枚 举 的 细节 

static void EvaluateEnum(System.Enum e) 


{ 
Console.WriteLine("=> Information about {0}", e.GetType().Name); 


Console.WriteLine("Underlying storage type: {0}", 

Enum. le GetType())); 
// 获取 传 入 参数 的 名 称 / 值 
Array enumData = Enum. nts GetType()); 
Console.WriteLine("This enum has {0} members.", enumData.Length); 
// 现在 使 用 D 格 式 标志 ( 见 第 3 章 ) 显示 字符 串 名 和 关联 的 值 
for(int i = 0; i < enumData.Length; i++) 


Console.WritelLine("Name: {0}, Value: {0:D}", 
enumData.GetValue(i)); 


Console.WriteLine(); 


} 
为 了 测试 这 个 新 方法 ， 我们 更 新 Main() 方 法 来 创建 几 个 在 System 命 名 空间 中 声明 的 枚 举 类 型 
( EmpType 枚 举 也 可 以 用 来 测试 )。 例 如 : 


static void Main(string[] args) 


Console.WriteLine("**** Fun with Enums +*****"); 
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EmpType e2 = EmpType.Contractor; 


// 这 些 类 型 为 System 命名 空间 中 的 枚 举 值 
DayOfWeek day = DayOfWeek.Monday; 
ConsoleColor cc = ConsoleColor.Gray; 


EvaluateEnum(e2); 
EvaluateEnum(day); 
EvaluateEnum(cc); 
Console.ReadLine(); 


} 
输出 结果 如 图 4-3 所 示 。 


3on about EmpType 
derlying storage type: System,Int32 
is enum has 4 members. 
Name: Manager, Value: 0 
Name: Grunt, Value; 1 
‘Name: Contractor, Value: 2 
‘Name: Vicepresident, Value: 3 


Information about DayofWeek 
nderlying storage type: System.Int32 

is enum has 7 members. 

: Sunday, Value: 0 

: Monday, Value: 1 

: Tuesday, Value: 2 

: Wednesday, Value: 3 

: Thursday, Value: 4 

; Friday, Value: 5 

: Saturday, Value: 6 


> Information about ConsoleColor 

Bunderlying storage type: System,Int32 
his enum has 16 members . 

: Black, Value: 0 

: Dark8iue, Value: 1 

: DarkGreen, Value: 2 

: DarkCyan, Yalue: 3 

: DarkRed, Value: 4 

: DarkMagenta, Value: 5 

: DarkYellow, Value: 6 

: Gray, Value: 7 

: DarkGray, Value: 8 

: Blue， Value: 93 

: Green, Value: 10 

: Cyan, Value: 1il 

: Red, Value: 12 

: Magenta, Value: 13 

: Yellow, Value: 14 

: White, Value: 15 


和 拌 桂 拌 拌 挂 笠 提 


图 4-3 ”动态 获取 枚 举 类 型 的 名 称 / 值 对 


在 本 书 中 我 们 会 看 到 ， 枚 举 在 .NET 基 础 类 库 中 被 广泛 使 用 。 例 如 ，ADO.NET 使 用 许多 枚 举 来 表 
示 数 据 库 连 接 的 状态 (已 打开 、 已 关闭 等 )、DataTable 中 行 的 状态 ( 如 被 改变 的 、 新 的 、 分 离 的 ) 等 。 
因此 ， 使 用 枚 举 时 ， 可 以 通过 System.Enum 的 成 员 来 和 名 称 / 值 对 进行 交互 。 





源 代码 ”FunWithEnums 项 目的 源 代码 位 于 Chapter 4 子 目 录 下 。 


4.4 结构 类 型 
既然 我 们 已 经 理解 了 枚 举 类 型 ， 接 下 来 就 研究 一 下 .NET 结 构 ( structure， 简 称 为 struct ) 的 使 用 。 
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结构 类 型 很 适合 在 应 用 程序 中 对 数学 、 几 何以 及 其 他 “原子 ”实体 建 模 。 结 构 ( 和 枚 举 相似 ) 是 用 户 
自 定义 的 类 型 ,然而 , 结构 不 只 是 一 组 名 称 / 值 对 。 结 构 是 可 以 包含 许多 数据 字段 和 操作 这 些 字段 的 成 
员 的 类 型 。 


说 明 ”如 果 你 有 OOP 背 景 ， 可 以 把 结构 看 成 是 “ 轻 量 级 的 类 类 型 "， 因 为 结构 提供 了 一 种 方式 来 定义 
这 样 一 种 类 型 ， 它 们 会 支持 封装 ， 但 不 能 用 来 构建 一 组 相关 类 型 。 如 果 我 们 需要 通过 继承 来 
构建 一 组 相关 类 型 ， 就 需要 使 用 类 类 型 。 





从 表面 上 看 ， 定 义 和 使 用 结构 的 过 程 很 简单 ， 但 是 其 中 的 一 些 细节 很 重要 。 现 在 开始 对 结构 类 型 
的 研究 ， 我 们 新 建 一 个 名 为 FunWithStructures 的 项 目 。 在 C# 中 ， 使 用 struct 关 键 字 来 创建 结构 。 和 定义 
一 个 新 结构 point ， 它 定义 了 两 个 int 类 型 的 成 员 变 量 和 一 组 与 上 述 数据 交互 的 方法 。 
struct Point 
// 结构 的 字段 
public int X; 
public int Y; 


// 将 (X,Y) 坐 标 增 加 1 
public void Increment() 


X++j Y++; 
// 将 (X,Y) 坐 标 减 去 1 
public void Decrement() 
X--; Y--; 
// 显示 当前 坐标 
public void Display() 
Console.WriteLine("X = {0}, Y = {1}"，X，Y); 
} 


这 里 使 用 public 关 键 字 定 义 了 两 个 整 型 数据 类 型 (X 和 Y )， 这 个 关键 字 是 访问 控制 修饰 符 (第 5 章 
会 详细 介绍 )。 使 用 public 关 键 字 来 声明 数据 可 以 确保 调用 者 能 直接 获取 某 个 Point 变 量 的 数据 ( 通过 
点 操作 符 )。 


说 明 通常 在 类 或 结构 中 定义 公共 数据 是 一 个 不 好 的 方式 。 我 们 最 好 使 用 私有 数据 ， 它 可 以 使 用 公 
共 属 性 来 访问 和 改变 。 第 5 章 会 详 述 这 些 细节 。 


Main() 方 法 测试 了 一 下 我 们 的 Point 类 型 : 


static void Main(string[] args) 


Console.WritelLine("***** A First Look at Structures *****\n"); 
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// 创建 初始 Point 
Point myPoint; 
myPoint.X = 349; 
myPoint.Y = 76; 
myPoint.Display(); 


// 调整 X 和 Y 值 
myPoint.Increment(); 
myPoint.Display(); 
Console.ReadLine(); 


} 
输出 结果 和 你 期 望 的 一 样 : 





沙洲 阔 阔 米 A First Look at Structures 闭 沙 沙沙 沙 


X = 349, Y = 76 
X = 350, Y = 77 
创建 结构 变量 


创建 结构 变量 的 方式 有 好 几 种。 在 这 里 ， 我 们 只 是 创建 了 一 个 point 变量 ， 并 在 调用 其 成 员 之 前 
为 每 一 个 公共 字段 数据 赋值 。 如 果 我 们 在 使 用 结构 之 前 不 为 每 一 个 公共 字段 数据 ( 这 里 就 是 x 和 Y ) 赋 
值 ， 就 会 收 到 一 个 编译 器 错误 : 

// 错误 | 没有 为 Y 赋 值 

Point p1; 

p1.X = 10; 

p1.Display(); 


// 正确 ! 在 使 用 前 两 个 字段 都 赋值 了 

Point p2; 

p2.X = 10; 

p2.Y = 10; 

p2.Display(); 

另 一 种 可 行 的 方法 是 ， 使 用 C# 的 new 关 键 字 来 创建 结构 变量 ， 它 会 调用 结构 默认 的 构造 函数 。 根 
据 定义 ,默认 的 构造 函数 不 接受 任何 输入 参数 。 调 用 结构 默认 构造 函数 的 好 处 是 ， 每 一 个 字段 数据 都 
会 被 自动 设置 为 默认 值 : 

// 使 用 默认 构造 函数 将 所 有 字段 设置 为 默认 值 

Point p1 = new Point(); 

// 输出 X=0,Y=0 

p1.Display(); 

还 可 以 使 用 自 定义 构造 函数 来 设计 结构 。 它 允许 我 们 在 创建 变量 时 指定 字段 数据 的 值 ， 而 不 是 逐个 
字段 设置 数据 成 员 。 第 5 章 会 详细 研究 构造 函数 ， 然 而 为 了 演示 ， 让 我 们 使 用 如 下 代码 更 新 Point 结 构 : 


struct Point 


// 结构 的 字段 
public int X; 
public int Y; 
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// 自 定 义 的 构造 函数 
public Point(int XPos, int YPos) 


这 样 ， 我 们 就 可 以 创建 Point 变 量 了 : 

// 调用 自 定义 构造 函数 

Point p2 = new Point(50, 60); 

// 输出 X=50,Y=60 

p2.Display(); 

之 前 提 到 过 ,结构 的 使 用 看 上 去 很 简单 。 但 为 了 更 好 地 理解 这 个 类 型 ,我 们 需要 研究 .NET 值 类 型 
和 .NET 引 用 类 型 之 间 的 区 别 。 


源 代 码 ”FunWithStructures 项 目的 源 代 码 位 于 Chapter 4 子 目录 下 。 


4.5 值 类 型 和 引用 类 型 


说 明 ”下面 对 值 类 型 和 引用 类 型 的 讨论 的 前 提 是 ， 你 已 经 有 了 面向 对 象 编程 的 经 验 。 如 果 没 有 面向 
对 象 编程 的 经 验 ， 你 可 能 需要 跳 过 本 节 和 4.6 节 ， 在 阅读 第 5 章 和 第 6 章 之 后 再 来 重新 阅读 这 部 


分 内 容 。 


和 数组 、 字 符 串 或 枚 举 不 同 ，C# 结 构 在 .NET 类 库 中 没有 完全 同名 的 表示 (也 就 是 说 ， 没 有 
System.Structure 类 ), 但 是 它们 都 隐 式 派生 自 System.ValueType。 简 而 言 之 ,System.ValueType 的 作用 
是 确保 所 有 派生 类 型 (如 任何 结构 ) 都 分 配 在 栈 上 而 不 是 垃圾 回收 堆 上 。 创 建 和 销毁 分 配 在 栈 上 的 数 
据 都 很 快 ,因为 它 的 生命 周期 是 由 定义 的 作用 域 决定 的 。 而 分 配 在 堆 上 的 数据 由 .NET 垃 圾 回收 器 监控 ， 
其 生命 周期 的 决定 因素 有 很 多 ， 这 将 在 第 13 章 中 介绍 。 

从 功能 上 说 ，Ssystem.ValueType 的 唯一 目的 是 ， 重 载 由 System.0bject 定 义 的 虚 方法 来 使 用 基于 值 
而 不 是 基于 引用 的 语法 。 你 可 能 已 经 知道 ， 重 载 会 改变 定义 在 基 类 中 的 虚 ( 也 可 能 是 抽象 的 ) 方法 的 
实现 。yVvalueType 的 基 类 是 System.0bject 。 事 实 上 ， 由 System.ValueType 定 义 的 实例 方法 和 由 
System.0bject 定 义 的 完全 一 样 : 

// 结构 和 枚 举 隐 式 扩展 了 System.ValueType 
public abstract class ValueType : object 


public virtual bool Equals(object obj); 
public virtual int GetHashCode(); 
public Type GetType(); 
public virtual string ToString(); 

} 
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由 于 值 类 型 使 用 基于 值 的 语法 ,结构 ( 也 包括 所 有 数值 数据 类 型 int、float 等 ， 以 及 任何 枚 举 或 
自 定义 结构 ) 的 生命 周期 是 可 以 预测 的 。 当 结构 变量 离开 定义 域 时 ， 它 就 会 立即 从 内 存 中 移 除 : 
// 本 地 变量 在 方法 返回 时 弹出 栈 
static void LocalValueTypes() 
// "int" 其 实 是 System.Int32 结 构 


int i = 0; 


// Point 是 结构 类 型 
Point p = new Point(); 
} // "i" 和 "p" 在 这 里 弹出 栈 


4.5.1 值 类 型 、 引 用 类 型 和 赋值 操作 符 


当 把 一 个 值 类 型 赋 给 另外 一 个 时 ， 就 是 对 字段 成 员 逐 一 进行 复制 。 对 于 System.Int32 这 样 的 简单 
数据 类 型 ， 唯 一 需要 复制 的 成 员 就 是 数值 。 然 而 ， 对 于 我 们 的 point ，X 和 Y 值 会 被 复制 到 新 的 结构 变量 
中 。 例 如 ， 新 建 一 个 名 为 ValueAndReferenceTypes 的 控制 台 应 用 程序 ， 并 且 将 之 前 的 Point 定 义 复制 到 
新 的 命名 空间 中 。 现 在 为 Program 类 型 增加 如 下 的 方法 : 


// 为 两 个 内 建 的 值 类 型 赋值 会 在 栈 上 产生 两 个 独立 变量 
static void ValueTypeAssignment() 


Console.WriteLine("Assigning value types\n"); 


Point p1 = new Point(10, 10); 
Point p2 = p1; 


// 输出 两 个 Point 
p1.Display(); 
p2.Display(); 


// 改变 p1.X 并 且 输 出 。p2.X 不 会 改变 

p1.X = 100; 

Console.WriteLine("\n=> Changed p1.X\n"); 
p1.Display(); 

p2.Display(); 


现在 已 经 创建 了 一 个 point 类 型 的 变量 ( 命名 为 p1 )， 并 赋值 给 另外 一 个 Point ( p2 )。 由 于 Point 是 
值 类 型 ， 在 栈 上 会 有 MyPoint 类 型 的 两 个 副本 ， 每 一 个 都 可 以 被 独立 操作 。 因 此 ， 当 改变 p1.X 的 值 时 ， 
p2.X 不 会 受到 影响 : 





Assigning value types 





和 栈 中 的 值 类 型 相 比 ， 当 对 引用 类 型 ( 也 就 是 所 有 类 实例 ) 应 用 赋值 操作 符 时 ， 我 们 就 是 在 内 存 
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中 重 定向 引用 变量 的 指向 。 让 我 们 新 建 一 个 类 类 型 PointRef 来 说 明 , 它 和 point 结构 有 几乎 相同 的 成 员 ， 
只 不 过 重 命名 了 构造 阴 数 来 匹配 类 名 。 

// 类 总 是 引用 类 型 

class PointRef 


// 和 Point 结 构 有 相同 的 成 员 


// 确保 将 构造 函数 名 改 为 PointRef 
public PointRef(int XPos, int YPos ) 


4 
X = XPos; 
等 便 - 
} 
现在 ,在 如 下 新 方法 中 使 用 PointRef 类 型 。 注 意 在 其 他 地 方 使 用 PointRef 类 而 不 是 Point 结 构 ， 其 
代码 和 ValueTypeAssignment() 方 法 完全 一 样 。 


static void ReferenceTypeAssignment() 


Console.WritelLine("Assigning reference types\n"); 
PointRef p1 = new PointRef(10, 10); 
PointRef p2 = p1; 


// 输出 两 个 Point ref 

p1.Display(); 

p2.Display(); 

// 改变 p1.X 并 且 再 次 输出 

p1.X = 100; 

-Console.WriteLine("\n=> Changed p1.X\n"); 
p1.Display(); 

p2.Display(); 


在 这 里 ， 有 两 个 引用 指向 托管 堆 中 的 同一 个 对 象 。 因 此 ， 当 使 用 p1 引 用 改变 X 值 时 ，p2.X 也 报告 了 
相同 值 。 假 定 在 Main() 中 调用 了 这 个 新 方法 ， 输 出 结果 如 下 : 





Assigning reference types 


4.5.2 包含 引用 类 型 的 值 类 型 


现在 你 已 经 更 好 地 理解 了 值 类 型 和 引用 类 型 之 间 的 区 别 ， 下 面 就 分 析 一 个 更 复杂 的 例子 。 假 设 有 
下 面 这 个 引用 (类 ) 类 型 ， 它 保存 着 一 个 能 够 用 自 定义 构造 函数 设置 的 信息 字符 串 : 
class ShapeInfo 


public string infoString; 
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public ShapeInfo(string info) 
infoString = info; 
} 
} 
现在 ,假设 要 在 名 为 Rectangle 的 值 类 型 中 包含 这 个 类 类 型 的 变量 。 为 了 允许 调用 者 设置 内 部 的 
ShapeInfo 成 员 变量 的 值 ， 还 提供 了 一 个 自 定义 的 构造 隐 数 。 下 面 是 Rectangle 类 型 的 完整 定义 : 


struct Rectangle 


// Rectangle 结 构 包 含 一 个 引用 类 型 成 员 
public ShapeInfo rectInfo; 


public int rectTop, rectleft, rectBottom, rectRight; 
public Rectangle(string info, int top, int left, int bottom, int right) 


rectInfo = new ShapeInfo(info); 

rectTop = top; rectBottom = bottom; 

rectleft = left; rectRight = right; 
} 


public void Display() 


Console.WriteLine("String = {0}, Top = {1}, Bottom = {2}, "+ 
"Left = {3}, Right = {4}", 
rectInfo.infoString, rectTop, rectBottom, rectlLeft, rectRight); 


} 
} 


这 里 的 值 类 型 中 包含 了 一 个 引用 类 型 。 一 个 非常 重要 的 问题 出 现 了 : 将 一 个 Rectangle 变 量 赋 给 
男 一 个 变量 ,会 发 生 什么 呢 ?” 由 于 我 们 已 经 了 解 了 值 类 型 ， 由 此 假设 整 型 数据 ( 事实 上 是 个 结构 ) 
对 每 一 个 Rectangle 变 量 都 应 该 是 一 个 独立 的 实体 ， 这 是 正确 的 。 但 内 部 的 引用 类 型 会 怎样 呢 ? 是 对 
象 的 状态 将 被 完全 复制 ， 还 是 指向 对 象 的 引用 被 复制 呢 ? 为 了 回答 这 个 问题 ， 定 义 下 面 这 个 方法 并 
且 从 Main() 中 调用 它 : 


static void ValueTypeContainingRefType() 
{ 
// 创建 第 一 个 Rectangle 
Console.WriteLine("-> Creating r1"); 
Rectangle r1 = new Rectangle("First Rect", 10, 10, 50, 50); 


// 现在 将 一 个 新 的 Rectangle 赋 值 给 rT1 
Console.WritelLine("-> Assigning r2 to r1"); 
Rectangle IT2 = IT1; 


// 改变 T2 的 值 

Console.WritelLine("-> Changing values of r2"); 
r2.rectInfo.infoString = "This is new info!"; 
r2.rectBottom = 4444; 


// 输出 两 个 rectangle 的 值 
r1.Display(); 
r2.Display(); 

} 


输出 结果 如 下 所 示 : 
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-> Creating r1 
-> Assigning r2 to r1 

-> Changing values of r2 

String = This is new info!, Top = 10, Bottom = 50, Left = 10, Right = 50 
String = This is new info!, Top = 10, Bottom = 4444, Left = 10, Right = 50 


可 以 看 到 ， 当 使 用 r2 的 引用 改变 信息 字符 串 的 值 时 ，r1 的 引用 显示 了 同样 的 值 。 默 认 情 况 下 ， 当 
值 类 型 包含 其 他 引用 类 型 时 ， 赋 值 将 生成 一 个 引用 的 副本 。 这 样 就 有 两 个 独立 的 结构 ， 每 一 个 都 包含 
指向 内 存 中 同一 个 对 象 的 引用 ( 也 就 是 “ 浅 复 制 ”)。 当 想 执 行 一 个 “ 深 复制 "， 即 将 内 部 引用 的 状态 
完全 复制 到 一 个 新 对 象 中 时 ， 需 要 实现 ICloneable 接 口 (第 8 章 会 讲 到 )。 








源 代码 ”ValueAndReferenceTypes 项 目的 源 代码 位 于 Chapter 4 子 目录 下 。 


4.5.3 ” 按 值 传递 引用 类 型 

引用 类 型 或 值 类 型 显然 可 以 作为 参数 传递 给 方法 。 但 是 ， 按 引用 传递 一 个 引用 类 型 ( 如 类 ) 与 按 
值 传递 一 个 类 型 有 很 大 的 不 同 。 为 了 理解 这 个 区 别 ， 假 设 新 的 控制 台 应 用 程序 RefTypeValType Params 
中 有 一 个 Person 类 ， 定 义 如 下 : 


class Person 


public string personName; 
public int personAge; 


// 构造 隙 数 
public Person(string name, int age) 


personName = name; 
personAge = age; 


public Person(){} 
public void Display() 
Console.WriteLine("Name: {0}, Age: {1}", personName, personAge); 


} 
现在 ， 如 果 创 建 一 个 方法 ,允许 调 用 者 按 值 传人 Person 类 型 ， 会 怎么 样 呢 ( 注意 ， 没 有 参数 修饰 
符 ， 如 out 或 ref ) ? 


static void SendAPersonByValue(Person p) 


人 
// 改变 "p 的 年 龄 
p.personAge = 99; 


// 调用 者 能 看 到 这 个 重新 赋值 吗 
p = new Person("Nikki", 99); 


注意 SendAPersonByValue() 方 法 是 怎样 试图 将 传人 的 Person 引 用 重新 赋 给 一 个 新 对 象 ,并 且 改 变 一 
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些 状态 数据 的 。 现 在 使 用 下 面 的 Main() 方 法 来 测试 一 下 这 个 方法 : 
static void Main(string[] args) 


{ 
// 按 值 传递 引用 类 型 
Console.WritelLine("***** passing Person object by value *****"); 
Person fred = new Person("Fred", 12); 
Console.WritelLine("\nBefore by value call, Person is:"); 
fred.Display(); 


SendAPersonByValue(fred); 
Console.WriteLine("\nAfter by value call, Person is:"); 


fred.Display(); 
Console.ReadLine(); 


这 个 调用 的 输出 结果 如 下 所 示 : 


****** passing Person object by Value ***** 


Before by value call, Person is: 
Name: Fred, Age: 12 


After by value call, Person is: 
Name: Fred, Age: 99 





可 以 看 出 ，personAge 的 值 被 修改 了 。 这 个 行为 看 起 来 似乎 违反 了 “ 按 值 ”传递 的 语义 。 如 果 能 够 
改变 传人 的 Person 的 状态 ,那么 复制 的 是 什么 ? 答案 是 : 复制 了 指向 调用 者 对 象 的 引用 。 由 于 
SendAPersonByValue() 方 法 与 调用 者 指向 同一 个 对 象 ， 所 以 改变 对 象 的 状态 数据 是 可 能 的 。 但 是 无 法 
把 引用 重新 赋值 给 一 个 新 的 对 象 ”。 


4.5.4 按 引 用 传递 引用 类 型 
现在 假设 有 一 个 SendAPersonByReference() 方 法 , 它 按 引用 来 传递 引用 类 型 ( 注意 ref 参 数 修饰 符 ): 


static void SendAPersonByReference(ref Person p) 


// 改变 "p "的 一 些 数据 
p.personAge = 555; 


//“p "现在 指向 了 堆 上 的 一 个 新 对 象 
p = new Person("Nikki", 999); 
以 上 代码 使 得 被 调用 者 操作 传人 参数 时 有 完全 的 灵活 性 。 被 调用 者 不 仅 可 以 改变 对 象 的 状态 ， 而 
且 在 改变 对 象 状 态 后 还 可 以 将 引用 重新 赋值 为 Person 类 型 。 考 虑 下 面 更 新 后 的 Main() 方 法 : 
static void Main(string[] args) 


// 按 引用 传递 引用 类 型 
Console.WriteLine("***** passing Person object by reference *****"); 





GD 就 像 上 面 的 p = new Person("Nikki"，99);， 代 码 并 没有 起 作用 。 有 一 点 像 C++ 中 的 常量 指针 。 一 一 译 者 注 
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Person mel = new Person("Mel", 23); 
Console.WriteLine("Before by ref call, Person is:"); 


mel.Display(); 


SendAPersonByReference(Ief mel); 
Console.WritelLine("After by ref call, Person is:"); 


mel.Display(); 
Console.ReadLine(); 


注意 输出 结果 如 下 所 示 : 





****** passing Person object by reference ***** 


Before by ref call, Person is: 


Name: Mel, Age: 23 


After by ref call, Person is: 


Name: Nikki, Age: 999 





可 以 看 到 ， 在 调用 后 对 象 nel 返 回 一 个 名 为 Nikki 的 Person 类 型 ， 这 是 因为 方法 可 以 改变 传人 的 引用 在 
内 存 中 的 指向 。 按 引用 传递 引用 类 型 时 需要 记 住 的 黄金 规则 如 下 : 


口 如 果 按 引用 传递 引用 类 型 ， 被 调用 者 可 能 改变 对 象 的 状态 数据 的 值 和 所 引用 的 对 象 ; 


口 如 果 按 值 传递 引用 类 型 ， 被 调用 者 可 能 改变 对 象 的 状态 数据 的 值 ， 但 不 能 改变 所 引用 的 对 象 。 


源 代 码 ”RefTypeValTypeParams 项 目的 源 代 码 位 于 Chapter 4 子 目 录 下 。 


4.5.5” 值 类 型 和 引用 类 型 : 最 后 的 细节 
最 后 ， 表 4-3 总 结 了 值 类 型 和 引用 类 型 之 间 主 要 的 区 别 。 


问 题 
这 个 类 型 分 配 在 哪里 
变量 是 怎样 表示 的 


基 类 型 是 什么 


这 个 类 型 能 作为 其 他 类 型 的 基 类 吗 
默认 的 参数 传递 行为 是 什么 


这 个 类 型 能 重 写 System.0bject. 
Finalize() 吗 





可 以 为 这 个 类 型 定义 构造 函数 吗 


这 个 类 型 的 变量 什么 时 候 消亡 


表 4-3” 值 类 型 和 引用 类 型 的 比较 


值 类 型 
分 配 在 栈 上 
值 类 型 变量 是 局 部 复制 


必须 派生 自 System.ValueType 


不 能 。 值 类 型 总 是 密封 的 ， 不 能 被 
继承 

变量 是 按 值 传 递 的 (也 就 是 说 , 一 
个 变量 的 副本 传人 被 调用 的 函数 ) 
不 能 。 值 类 型 不 会 放 在 堆 上 ， 因 此 
不 需要 被 终结 


引用 类 型 
分 配 在 托管 堆 上 
引用 类 型 变量 指向 被 分 配 的 实例 所 占 
的 内 存 
可 以 派生 自 除 了 System.ValueType 以 外 
的 任何 类 型 ， 只 要 那个 类 型 不 是 密封 的 
(关于 密封 的 更 多 细节 见 第 6 章 ) 


能 。 如 果 这 个 类 型 不 是 密封 的 ， 它 可 以 
作为 其 他 类 型 的 基 类 


对 于 值 类 型 ， 对 象 按 值 复制 。 对 于 引用 
类 型 ， 引 用 按 值 复制 


可 以 间接 地 重 写 (更 多 细节 见 第 8 章 ) 





是 的 , 但 是 默认 的 构造 函数 被 保留 
( 也 就 是 自 定义 构造 函数 必须 全 部 
带 有 参数 ) 

当 它 们 越 出 定义 的 作用 域 时 


当 托 管 堆 被 垃圾 回收 时 
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尽管 它们 存在 差异 , 但 是 值 类 型 和 引用 类 型 都 有 实现 接口 的 能 力 , 并 且 可 以 支持 任意 数量 的 字段 、 
方法 、 重 载 操 作 符 、 常 量 、 属 性 和 事件 。 


4.6”C# 可 空 类 型 


在 结束 本 章 之 前 ,让 我 们 使 用 最 后 一 个 叫做 NullableTypes 的 控制 台 应 用 程序 来 研究 可 空 数据 类 型 。 
我 们 知道 ，CLR 数 据 类 型 有 一 个 固定 的 范围 ， 并 且 由 System 命名 空间 中 的 类 型 进行 表示 。 例 如 ， 
System.Boolean 数 据 类 型 可 以 从 集合 {true,false} 中 赋值 。 现在 我 们 应 该 记得 所 有 数值 数据 类 型 (也 包 
括 Boolean 数 据 类 型 ) 都 是 值 类 型 。 按 照 规则 ，null 用 来 建立 一 个 空 的 对 象 引 用 ， 所 以 值 类 型 永远 不 可 
以 被 赋值 为 nul1。 


static void Main(string[] args) 


// 编译 器 错误 

// 值 类 型 不 能 设置 为 nul1 
bool myBool = null; 

int myInt = null; 


// 没 错 ! 字符 囊 是 引用 类 型 
string myString = null; 





自从 .NET 2.0 发 布 之 后 ， 我 们 就 可 以 创建 可 空 数据 类 型 了 。 简 而 言 之 ,可 空 类 型 可 以 表示 所 有 实 
际 类 型 的 值 加 上 null。 因 此 ， 如 果 声 明 一 个 可 空 的 boo1, 就 可 以 从 集合 {true, false, nul1} 中 进行 赋值 。 
如 果 和 关系 数据 库 打 交道 ， 这 就 会 很 有 有 用， 因为 在 数据 库 表 中 遇 到 未 定义 的 列 是 很 常见 的 事情 。 如 果 
没有 可 空 数据 类 型 的 概念 ， 在 C# 中 就 没有 很 方便 的 方式 来 表示 没有 值 的 数值 数据 点 。 
为 了 定义 一 个 可 空 变量 类 型 ， 应 在 底层 数据 类 型 中 添加 问号 ( ? ) 作为 后 级 。 注 意 ， 这 种 语法 只 
对 值 类 型 是 合法 的 。 如 果 试 图 创建 一 个 可 空 引用 类 型 (包括 字符 串 )， 就 会 遇 到 编译 时 错误 。 与 非 可 
空 变量 一 样 ， 局 部 可 空 变量 必须 赋 一 个 初始 值 才能 使 用 。 
static void LocalNullableVariables() 
{ 
// 定义 一 些 局 部 可 空 类 型 
int? nullableInt = 10; 
double? nullableDouble = 3.14; 
bool? nullableBool = null; 


char? nullableChar = 'a'; 
int?[] arrayOfNullableInts = new int?[10]; 


// 错误 ! 字符 串 是 引用 类 型 


// string? s = "oops"; 


在 C# 中 ，? 后 级 记 法 实际 上 是 创建 一 个 泛 型 system.Nullable<T> 结 构 类 型 实例 的 简写 。 尽 管 第 9 音 
才 分 析 泛 型 但 了 解 system.Nullable<T> 类 型 提供 了 一 组 所 有 可 空 类 型 都 可 以 使 用 的 成 员 是 很 重 
要 的 。 

例如 , 可 以 通过 编程 , 用 HasValue 属 性 或 != 操 作 符 判 断 , 一 个 可 空 变量 是 否 确 实 被 赋予 了 一 个 null 
值 。 可 空 类 型 被 赋 的 值 可 以 通过 Value 属 性 或 直接 获得 。 因 为 ?后 级 只 是 使 用 Nullable<T> 的 一 种 简化 表 
示 ， 所 以 可 以 按 如 下 所 示 实 现 LocalNullableVariables() 方 法 。 
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static void LocalNullableVariablesUsingNullable() 

{ 
// 使 用 NullablekT> 定 义 一 些 局 部 可 空 变量 
Nullable<int> nullableInt = 10; 
Nullable<double> nullableDouble = 3.14; 
Nullable<bool> nullableBool = null; 
Nullable<char> nullableChar = 'a'; 
Nullable<int>[] arrayOfNullableInts = new int?[10]; 


4.6.1 使 用 可 空 类 型 


在 涉及 数据 库 编 程 时 ， 可 空 数据 类 型 可 能 特别 有 用 ， 因 为 一 个 数据 表 中 的 列 可 能 有 意 是 空 的 〈 例 
如 ,未 定义 )。 举 个 例子 ， 假 设 有 下 面 的 类 ， 模 拟 访问 一 个 数据 库 的 过 程 ， 该 数据 库 包含 一 个 表 ， 其 
中 有 两 个 可 能 为 null 的 列 。 注 意 ，GetIntFromDatabase() 方 法 没有 给 可 空 整 型 成 员 变量 赋值 ， 
GetBoo1FromDatabase() 给 bool1? 成 员 赋 了 一 个 合法 的 值 : 


class DatabaseReader 

{ 
// 可 空 数据 字段 
public int? numericValue = null; 
public bool? boolValue = true; 


// 注意 可 空 返 回 类 型 
public int? GetIntFromDatabase() 
{ return numericValue; } 


// 注意 可 空 返回 类 型 
public bool? GetBoolFromDatabase() 
{ return boolValue; } 


} 
现在 , 假设 有 下 面 的 Main() 方 法 , 调用 了 DatabaseReader 类 的 每 一 个 成 员 , 并 使 用 HasValue 和 Value 
成 员 以 及 C# 相 等 操作 符 ( 准确 地 说 ， 不 相等 ) 发 现 了 被 赋 的 值 : 


static void Main(string[] args) 

{ 
Console.WriteLine("***** Fun with Nullable Data *****\n"); 
DatabaseReader dr = new DatabaseReader(); 


// 从 “数据 库 ” 获 取 int 
int? i = dr.GetIntFromDatabase(); 
if (i.HasValue) 
Console.WritelLine("Value of 'i' is: {0}", i.Value); 
else 
Console.WritelLine("Value of 'i' is undefined."); 


// 从 “数据 库 ” 获 取 bool 
bool? b = dr.GetBoolFromDatabase(); 
if (b != null) 

Console.WriteLine("Value of 'b' is: {0}", b.Value); 
else 

Console.WriteLine("Value of 'b' is undefined."); 
Console.ReadLine(); 
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4.6.2 ?? 操 作 符 


关于 可 空 类 型 需要 知道 的 最 后 一 点 是 ， 可 以 使 用 ?? 操 作 符 。 在 获得 的 值 实际 上 是 null 时 ， 我 们 可 
以 用 这 个 操作 符 给 一 个 可 空 类 型 赋值 。 对 于 上 面 这 个 示例 来 说 ,假设 从 GetIntFromDatabase() 返 回 的 
值 是 null ( 当然 ， 这 个 方法 被 编程 为 总 是 返回 nul1， 但 我 相信 你 能 明白 其 中 的 思路 ): 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Nullable Data *****\n"); 
DatabaseReader dr = new DatabaseReader(); 


// 从 GetIntFromDatabase() 返 回 的 值 为 nul1 时 ， 将 本 地 变量 赋值 为 100 
int myData = dr.GetIntFromDatabase() ?? 100; 
Console.WriteLine("Value of myData: {0}", myData); 
Console.ReadLine(); 


使 用 ?? 操 作 符 的 好 处 是 , 它 比 传统 的 if/else 条 件 的 写法 更 加 紧凑 。 不 过 ,如 果 愿 意 , 你 也 可 以 编 
写 如 下 功能 相同 的 代码 ， 以 确保 如 果 值 为 空 ， 则 设置 为 100: 


// 使 用 ? : ?? 语法 的 长 版 本 
int? moreData = dr.GetIntFromDatabase(); 
if (!moreData.HasValue) 
moreData = 100; 
Console.WriteLine("Value of moreData: {0}", moreData); 


源 代码 ”NullableTypes 项 目的 源 代码 位 于 Chapter 4 的 子 目 录 下 。 


4.7 ”小结 


本 章 首 先 介 绍 了 几 个 可 用 来 构建 自 定义 方法 的 C# 关 键 字 。 还 记得 吗 ,， 在 默认 情况 下 ， 参数 按 值 传 
递 。 然 而 ， 如 果 参 数 被 标记 为 ref 或 out ， 我 们 可 以 按 引用 进行 传递 。 我 们 还 学 习 了 可 选 参数 的 作用 ， 
以 及 如 何 定 义 和 调 用 接受 参数 数组 的 方法 。 

在 研究 了 方法 重 载 的 主题 之 后 , 接 下 来 的 大 部 分 篇 幅 探 讨 了 有 关 数 组 、 枚 举 和 结构 如 何在 C# 中 定 
义 ， 以 及 如 何在 .NET 基 础 类 库 中 进行 表示 。 然 后 ,我 们 研究 了 有 关 值 类 型 和 引用 类 型 的 细节 ， 包括 当 
作为 参数 传人 方法 后 它们 如 何 响应 ， 以 及 如 何 使 用 ?和 ?? 操 作 符 来 和 可 空 数 据 类 型 进行 交互 。 


第 三 部 分 





C# 面向 对 象 编程 


本 ,部 ,分 /内容 


| 第 5 章 
第 6 章 
日 第 7 章 


利 第 8 章 





封装 
继承 和 多 态 
结构 化 异常 处 理 
接口 








年。 我 们 研究 了 所 有 .NET 应 用 程序 共有 的 许多 核心 语法 结构 。 本 章 中 ， 我 们 会 研究 
C# 的 面向 对 象 功能 。 首 先 介绍 如 何 构建 支持 任意 数量 的 构造 函数 的 定义 明确 的 类 类 型 。 理 
解 了 定义 类 以 及 分 配对 象 的 基本 知识 之 后 ,本 章 余下 的 内 容 会 研究 封装 的 作用 。 然 后 我 们 会 讨论 如 何 
定义 类 属性 以 及 静态 成 员 、 对 象 初始 化 语法 、 只 读 字段 、 常 量 和 分 部 类 的 作用 。 


5.1 C# 类 类 型 


就 .NET 平 台 而 言 ， 最 基本 的 编程 结构 就 是 类 类 型 。 正 式 地 说 ,类 是 由 字段 数据 ( 通常 叫做 成 员 变 
量 ) 以 及 操作 这 个 数据 的 成 员 ( 如 构造 函数 、 属 性 、 方 法 、 事 件 等 ) 所 构成 的 自 定 义 类 型 。 总 地 来 说 ， 
其 中 的 字段 数据 用 于 表示 类 实例 的 “状态 ”( 或 称 为 对 象 ),C# 这 类 面向 对 象 的 语言 的 强大 之 处 就 在 于 ， 
通过 将 数据 和 相关 功能 集合 在 类 定义 中 ， 我 们 就 可 以 仿照 现实 生活 中 的 实体 来 设计 软件 。 

首先 ， 新 建 一 个 名 为 SimpleClassExample 的 C# 控 制 台 应 用 程序 。 如 图 5-1 所 示 ， 通 过 Project 一 Add 
Class 菜 单 选项 ， 从 结果 对 话 框 中 选择 Class 图 标 ， 单 击 Add 按 钮 ， 插 入 一 个 新 的 类 文件 ( 名 为 Car.cs ) 
到 我 们 的 项 目 中 。 


User Control (WPF) 
二 


Abcu Eos 





图 5-1 插入 一 个 新 的 C# 类 类 型 
在 C# 中 ， 类 使 用 class 关 键 字 来 定义 。 下 面 是 最 简单 的 声明 : 


class Car 


} 
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定义 了 类 类 型 之 后 ， 我 们 需要 考虑 用 于 表示 类 状态 的 一 组 成 员 变量 。 例 如 ， 我 们 可 能 决定 让 Car 
维护 一 个 int 数 据 类 型 来 表示 当前 速度 , 以 及 用 一 个 string 数 据 类 型 来 表示 汽车 的 昵称 。 有 了 这 样 的 初 
始 设计 方案 ， 按 如 下 所 示 更 新 Car 类 : 


class Car 


{ 
// Car 的 “状态 ” 
public string petName; 
public int currSpeed; 


注意 ， 这 些 成 员 变 量 都 使 用 public 访 问 修饰 符 来 声明 。 类 型 的 对 象 创建 之 后 ， 就 可 以 直接 访问 类 
的 公共 成 员 。 你 可 能 已 经 知道 ,“ 对 象 ” 这 个 术语 表示 使 用 new 关 键 字 创 建 的 某 个 类 类 型 的 实例 。 


说 明 类 的 字段 数据 很 少 定义 为 公共 的 。 为 了 保护 状态 数据 的 完整 性 ,最 好 将 数据 定义 为 私有 的 (或 
者 是 受 保护 的 )， 并 且 通 过 类 型 属性 ( 本章 稍 后 会 介绍 ) 对 数据 提供 受 控 制 的 访问 。 但 为 了 让 
第 一 个 示例 足够 简单 ， 公 共 的 数据 正好 符合 这 个 要 求 。 


定义 了 表示 类 状态 的 一 组 成 员 变 量 之 后 , 下 一 个 设计 步骤 就 是 创建 描述 其 行为 的 成 员 。 例如，Car 
类 会 定义 一 个 名 为 SpeedUp() 的 方法 和 另 一 个 名 为 PrintState() 的 方法 ， 如 下 所 示 更 新 你 的 类 : 
class Car 
// Car 的 “状态 ” 
public string petName; 
public int currSpeed; 


// Car 的 功能 
public void PrintState() 


Console.WriteLine("{0} is going {1} MPH.", petName, currSpeed); 


public void SpeedUp(int delta) 
currSpeed += delta; 


} 

我 们 可 以 看 到 ,PrintState() 相 当 于 一 个 调试 功能 , 它 只 将 某 个 Car 对象 的 当前 状态 转 储 到 命令 窗 
口 。SpeedUp() 会 根据 传人 的 int 参 数 指定 的 数量 来 增加 car 的 速度 。 现在 , 使 用 如 下 代码 来 更 新 Program 
类 中 的 Main() 方 法 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Class Types *****\n"); 


// 分 配 和 设置 Car 对 象 

Car myCar = new Car(); 
myCar.petName = "Henry"; 
myCar.currSpeed = 10; 


// 将 Car 加 速 几 次 ， 然 后 输出 新 的 状态 





for 


(int i = 0; i <= 10; i++) 


myCar. SpeedUp(5); 
myCar.PrintState(); 


Console.ReadLine(); 


运行 程序 之 后 ， 我 们 会 看 到 Car 变 量 ( myCar ) 在 应 用 程序 的 整个 生命 中 都 维持 当前 的 状态 ， 如 下 
述 代 码 所 示 。 





六 冰冰 冰冰 


Henry 
Henry 
Henry 
Henry 
Henry 
Henry 
Henry 
Henry 
Henry 
Henry 
Henry 








Fun with Class Types ***** 


is going 15 MPH. 
is going 20 MPH. 
is going 25 MPH. 
is going 30 MPH. 
is going 35 MPH. 
is going 40 MPH. 
is going 45 MPH. 
is going 50 MPH. 
is going 55 MPH. 
is going 60 MPH. 
is going 65 MPH. 





使 用 new 关 键 字 来 分 配对 象 


从 之 前 的 代码 示例 中 我 们 可 以 看 到 ， 对 象 必须 使 用 new 关 键 字 来 分 配 到 内 存 中 。 如 果 我 们 不 使 用 
new 关 键 字 ,并且 在 之 后 的 代码 语句 中 尝试 使 用 类 变量 的 话 ， 就 会 收 到 一 个 编译 器 错误 。 例 如 ， 下 面 
的 Main() 方 法 不 会 编译 : 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Class Types *****\n"); 


// 错误 ! 忘记 使 用 new 创 建 对 象 
Car myCar; 
myCar.petName = "Fred"; 


要 使 用 new 关 键 字 正确 创建 对 象 ， 我 们 可 以 在 单行 代码 中 定义 并 分 配 一 个 car 对象 : 


static void Main(string[] args) 


Console.WritelLine("***** Fun with Class Types *****\n"); 
Car myCar = new Car(); 
myCar.petName = "Fred"; 


或 者 ， 


如 果 我 们 希望 分 开 定义 和 分 配对 象 的 话 ， 可 以 这 么 做 : 


static void Main(string[] args) 


Console.WritelLine("***** Fun with Class Types *****\n"); 
Car myCar; 
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myCar = new Car(); 
myCar.petName = "Fred"; 


在 这 里 ， 第 一 句 代 码 只 是 声明 了 指向 尚未 被 创建 的 car 对象 的 引用 。 在 我 们 通过 new 关 键 字 把 引用 
赋 给 对 象 之 后 ， 这 个 引用 才 会 指向 内 存 中 的 有 效 类 实例 。 

不 管 怎 么 样 ， 在 这 里 我 们 已 经 有 了 一 个 没什么 实际 意义 的 类 ， 并 且 定 义 了 一 些 数据 和 基本 方法 。 
要 增强 当前 Car 类 的 功能 ， 我 们 需要 理解 构造 函数 的 作用 。 


5.2 构造 函数 


由 于 对 象 有 状态 ( 由 对 象 的 成 员 变 量 的 值 来 表示 )， 对 象 用 户 通常 希望 在 使 用 对 象 之 前 先 给 对 象 
的 字段 数据 赋 相 关 的 值 。 现在 , Car 类 型 需要 petName 和 currSpeed 字 段 逐 一 被 赋值 。 对 于 当前 示例 来 说 ， 
问题 不 大 ， 因 为 我 们 只 有 两 个 公共 的 数据 点 。 然 而 ， 一 个 拥有 很 多 字段 的 类 也 是 常见 的 。 显 然 ， 要 编 
写 20 个 初始 化 语句 来 设置 20 个 数据 点 是 很 麻烦 的 事情 。 

还 好 ，C# 文 持 构造 函数 , 它 允 许 在 创建 对 象 时 创建 其 状态 。 构造 函数 是 类 的 特殊 方法 , 在 使 用 new 
关键 字 创 建 对 象 时 被 间接 调用 。 然 而， 和 “普通 ”方法 不 同 , 构造 函数 永远 不 会 返回 值 ( 即使 是 void )， 
并 且 它 的 名 字 总 是 和 需要 构造 的 类 的 名 字 相 同 。 


5.2.1 默认 构造 函数 的 作用 


每 一 个 C# 类 都 提供 了 内 建 的 默认 构造 函数 , 需要 时 可 以 重新 定义 。 根 据 定义 , 默认 的 构造 函数 不 
会 接受 参数 ,除了 把 新 对 象 分 配 到 内 存 中 , 默认 构造 函数 确保 所 有 字段 数据 都 设置 为 正确 的 默认 值 ( 更 
多 有 关 C# 数 据 类 型 默认 值 的 信息 ， 请 参阅 第 3 章 )。 

如 果 你 对 这 些 默 认 的 赋值 不 满意 ,可 以 重新 定义 默认 的 构造 函数 来 满足 需求 。 按 如 下 所 示 更 新 C# 
Car 类 来 进行 说 明 : 

class Car 


// Car 的 状态 
public string petName; 
public int currSpeed; 


// 自 定义 的 默认 构造 函数 
public Car() 
{ 


petName = "Chuck"; 
currSpeed = 10; 


在 这 里 ， 我 们 强制 所 有 Car 对 象 一 开始 就 命名 为 Chuck， 时 速 为 10。 这 样 ， 我 们 就 可 以 创建 一 个 具 
有 如 下 默认 值 的 Car 对 象 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Class Types *****\n"); 
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// 调用 默认 构造 函数 
Car chuck = new Car(); 


// 输出 "Chuck is going 10 MPH." 
chuck.PrintState(); 


; 
5.2.2 ”定义 自 定义 的 构造 函数 
大 多 数 情况 下 ， 除 了 默认 构造 函数 之 外 ， 类 还 会 定义 其 他 构造 函数 。 这 样 ， 我 们 就 可 以 为 对 象 用 
户 提供 简单 而 一 致 的 方式 : 在 创建 对 象 时 直接 初始 化 对 象 的 状态 。 考 虑 如 下 car 类 的 修改 ， 现 在 它 一 
共 支 持 3 个 类 构造 函数 : 
class Car 
// Car 的 “状态 ” 


public string petName; 
public int currSpeed; 


// 自 定义 的 默认 构造 函数 
public Car() 
{ 


petName = "Chuck"; 
CurrSpeed = 10; 


// 在 这 里 ，currSpeed 会 获得 int 的 默认 值 0 
public Car(string pn) 
{ 


petName = pn; 


// 让 调用 者 设置 Car 的 完整 “状态 ” 
public Car(string pn, int cs) 


petName = pn; 
currSpeed = cs; 


i 
记 住 ， 让 构造 函数 彼此 不 同 ( 就 C# 编 译 器 而 言 ) 的 是 构造 函数 参数 的 个 数 和 类 型 。 回 顾 一 下 第 4 
章 ， 当 我 们 定义 了 具有 同样 名 字 但 参数 数量 和 类 型 不 同 的 方法 时 ， 就 是 重 载 方 法 。 因 此 ，Car 类 型 重 
载 了 构造 函数 来 提供 许多 种 在 声明 时 创建 对 象 的 方式 。 不 管 怎么 样 ,我 们 现在 可 以 使 用 其 中 任何 一 种 
公共 构造 函数 来 创建 Car 对 象 。 例 如 : 
static void Main(string[] args) 
Console.WritelLine("***** Fun with Class Types *****\n"); 
// 创建 一 个 叫 Chuck 的 Car， 时 速 为 10MPH 
Car chuck = new Car(); 
chuck.PrintState(); 


// 创建 一 个 叫 Mary 的 Car， 时 速 为 OMPH 
Car mary = new Car("Mary"); 
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mary.PrintState(); 


// 创建 一 个 叫 Daisy 的 Car， 时 过 为 75MPH 
Car daisy = new Car("Daisy", 75); 
daisy.PrintState(); 


b 
5.2.3 ”再 谈 默 认 构 造 函 数 

我 们 已 经 知道 了 ， 所 有 类 都 有 免费 的 默认 构造 函数 。 因 此 ， 如 果 我 们 插入 一 个 新 类 Motorcycle 到 
当前 的 项 目 中 ， 并 这 么 定义 : 

class Motorcycle 7 

public void PopAWheely() 

Console.WriteLine("Yeeeeeee Haaaaaeewww!"); 
} 

} 

就 可 以 直接 通过 默认 构造 函数 来 创建 Motorcycle 类 型 的 实例 了 : 

static void Main(string[] args) 


Console.WriteLine("***** Fun with Class Types *****\n"); 
Motorcycle mc = new Motorcycle(); 
mc.PopAWheely(); 


} 

然而 ,一 旦 定义 了 自 定义 构造 函数 ， 默 认 构造 函数 就 被 自动 从 类 中 移 除 ， 并 且 不 再 有 效 ! 这 样 来 
想 吧 ， 如 果 不 定 义 自 定义 构造 函数 ，C# 编 译 器 就 会 给 我 们 一 个 默认 值 ， 以 便 对 象 用 户 分 配 类 型 实例 ， 
字段 数据 都 设置 为 正确 的 默认 值 。 然 而 ， 如 果 我 们 定义 了 唯一 的 构造 函数 ， 编 译 器 就 会 认为 我 们 会 自 
己 处 理 。 

因此 ， 如 果 希 望 对 象 用 户 使 用 默认 构造 函数 和 自 定义 构造 函数 创建 类 型 实例 ， 就 必须 显 式 重新 定 
义 默认 构造 函数 。 最 后 ,请 记 住 在 大 多 数 情况 下 ， 类 的 默认 构造 函数 的 实现 故意 为 空 ， 因 为 我 们 需要 
的 只 是 创建 具有 默认 值 的 对 象 的 能 力 。 考 虑 如 下 对 Motorcycle 类 的 更 新 : 


class Motorcycle 

public int driverIntensity; 

public void PopAWheely() 

{ 

for (int i = 0; i «= driverIntensity; i++) 

Console.Writeline("Yeeeeeee Haaaaaeewww!"); 

} 

// 恢复 默认 的 构造 函数 ， 将 所 有 数据 成 员 设 为 默认 值 

public Motorcycle() {} 


// 自 定义 构造 函数 
public Motorcycle(int intensity) 
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driverIntensity = intensity; 


} 


说 明 你 应 该 已 经 能 较 好 地 理解 类 构造 函数 的 作用 了 。 下 面 我 们 来 看 个 简便 方法 。Visual Studio IDE 
提供 了 ctor 代 码 段 ,输入 ctor 并 按 下 Tab 键 两 次 ,IDE 会 自动 定义 一 个 定制 的 默认 构造 函数 。 此 
后 你 就 可 以 添加 自 定义 参数 和 实现 逻辑 了 ， 你 不 妨 尝 试 一 下 |! 


5.3 this 关键 字 的 作用 


C# 支 持 this 关 键 字 来 提供 对 当前 类 实例 的 访问 。this 关 键 字 可 能 的 用 途 就 是 ， 解 决 当 传人 参数 的 
名 字 和 类 型 数据 字段 的 名 字 相 同时 产生 的 作用 域 歧 义 。 当 然 ， 最 理想 的 是 我 们 采用 一 个 不 会 产生 这 种 
歧义 的 命名 习惯 。 然 而 ， 为 了 演示 this 关 键 字 的 使 用 ， 更 新 Motorcycle 类 ， 创 建新 的 string 字 段 (名 
为 name ) 来 表示 司机 的 名 字 。 然 后 ， 增 加 一 个 名 为 SetDriverName() 的 方法 ， 其 实现 如 下 所 示 : 


class Motorcycle 
public int driverIntensity; 


// 表示 司机 名 称 的 新 成 员 
public string name; 
public void SetDriverName(string name) 


name = name; 


尽管 这 段 代 码 可 以 通过 编译 ,但 是 Visual Studio 会 显示 一 条 警告 信息 通知 你 使 用 变量 本 身 来 设置 
该 变量 。 为 了 演示 ， 更 新 Main() 方 法 来 调用 SetDriverName() ， 然 后 输出 name 字 段 的 值 ， 你 可 能 会 惊奇 
地 发 现 name 字 段 的 值 是 空 字符 串 ! 


// 创建 一 个 摩托 车 对 象 ， 其 各 驶 者 为 Tiny 

Motorcycle c = new Motorcycle(5); 

Cc.SetDriverName("Tiny"); 

c.PopAWheely(); 

Console.WriteLine("Rider name is {0}",，c.name); // 输出 空 字符 串 


问题 就 是 , 由 于 编译 器 会 认为 name 指 向 当前 方法 作用 域内 的 变量 , 而 不 是 类 作用 域 中 的 name 字 段 ， 
因此 SetDriverName() 的 实现 为 传 入 参数 本 身 赋值 了 。 要 想 让 编译 器 知道 我 们 希望 将 当前 对 象 的 name 数 
据 字段 设置 为 传人 的 name 参 数 ， 只 需要 使 用 this 就 能 解决 这 个 歧义 : 

public void SetDriverName(string name) 


this.name = name; 


要 知道 , 如 果 没 有 歧义 的 话 , 我 们 不 需要 在 类 访问 它 自己 的 数据 或 成 员 时 使 用 this 关 键 字 。 例如 ， 
如 果 我 们 重 命名 string 数 据 成 员 为 driverName ( 也 需要 更 新 Main() 方 法 )，this 就 是 可 选 的 ， 并 且 也 不 
会 存在 作用 域 歧义 : 
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class Motorcycle 


public int driverIntensity; 
public string driverName; 


public void SetDriverName(string name) 


// 这 两 个 语句 从 功能 上 说 是 一 样 的 
driverName = name; 
this.driverName = name; 


尽管 在 无 歧义 的 情况 下 使 用 this，this 也 没有 给 我 们 很 多 惊喜 ， 但 实现 成 员 时 我 们 会 发 现 这 个 关 
键 字 很 有 用 ， 如 SharpDevelop 和 Visual Studio 这 样 的 IDE 在 指定 this 时 会 启用 智能 感知 。 这 样 ， 如 果 我 
们 忘记 类 成 员 的 名 字 并 且 希 望 快速 回忆 起 其 定义 ，this 就 会 很 有 用。 考虑 图 5-2。 


%s, SimpleClassExample.Motorcycle ~ © SetDriverNamefstring name)} 
} 党 


本 


} 


// New members to represent 《he name of the driver. 
pubiic string driverName; 
public void SetDriverName(string name) 
' this.driverkHame = name; a 
} } be [dveriniensity 本 Motorcycle.driverlntensity | | | 
jly @ driverName BB 
全 Equals i 
® GetHashCode | 
全 GetType 
H, MemberwiseClone 
@ PopAWheely 
外 SetDriverName 
@ ToString 


20% ~ + [cs et 


图 $-2 this 的 智能 感知 


5.3.1 使 用 this 进 行 串联 构造 函数 调用 


this 关 键 字 的 另 一 种 用 法 是 使 用 一 项 名 为 构造 函数 链 的 技术 来 设计 类 。 当 类 定义 了 多 个 构造 函数 
时 ， 这 个 设计 模式 就 会 很 有 用 。 由 于 构造 函数 通常 会 验证 传人 的 参数 来 强制 各 种 业务 规则 ， 所 以 在 类 
的 构造 函数 集合 中 经 常会 找到 元 余 的 验证 逻辑 。 考 虑 如 下 更 新 后 的 Motocycle: 


class Motorcycle 


public int driverIntensity; 
public string driverName; 


public Motorcycle() { } 
// 兄 余 的 构造 函数 逻辑 
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public Motorcycle(int intensity) 
if (intensity > 10) 
intensity = 10; 


driverIntensity = intensity; 


public Motorcycle(int intensity, string name) 
if (intensity > 10) 
{ 
intensity = 10; 


driverIntensity = intensity; 
driverName = name; 


} 

在 这 里 〈 可 能 是 要 确保 驾驶 者 的 安全 )， 每 一 个 构造 函数 确保 强度 等 级 不 超过 10。 虽 然 可 以 这 么 
做 , 但 是 在 两 个 构造 函数 中 有 克 余 代码 语句 。 这 不 够 完美 ， 如 果 规 则 改变 的 话 ， 就 必须 在 多 个 位 置 更 
新 代码 ( 例如 ， 如 果 强 度 应 该 不 大 于 5 )。 

改进 这 种 情况 的 一 个 方法 就 是 在 Motorcycle 类 中 定义 一 个 用 来 验证 传人 参数 的 方法 。 如 果 这 么 做 
的 话 ， 每 一 个 构造 函数 就 可 以 在 进行 字段 赋值 之 前 调用 这 个 方法 。 虽然 这 个 方法 确实 可 以 隔离 在 业务 
规则 改变 时 需要 修改 的 代码 ， 但 是 我 们 就 会 面临 如 下 的 宛 余 : 


class Motorcycle 


public int driverIntensity; 
public string driverName; 


// 构造 函数 
public Motorcycle() { } 


public Motorcycle(int intensity) 


SetIntensity(intensity); 


public Motorcycle(int intensity, string name) 
SetIntensity(intensity); 
driverName = name; 
public void SetIntensity(int intensity) 
if (intensity > 10) 
. intensity = 10; 


driverIntensity = intensity; 
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一 个 更 简洁 的 方案 就 是 ， 让 一 个 接受 最 多 参数 个 数 的 构造 函数 做 “ 主 构造 机 数 "， 并 且 实 现 必需 
的 验证 逻辑 。 其 余 的 构造 函数 可 以 使 用 this 关 键 字 把 传人 的 参数 转发 给 主 构造 函数 ， 并 且 提 供 所 有 必 
需 的 其 他 参数 。 这 样 ， 整 个 类 中 只 会 有 一 个 构造 函数 需要 我 们 去 操心 ， 其 余 构 造 函 数 基本 上 都 是 空 的 。 

下 面 是 Motorcycle 类 的 最 后 一 次 迭代 (为 了 演示 ， 又 多 了 一 个 构造 函数 )。 在 串联 构造 函数 时 ,请 
注意 this 如 何在 构造 函数 本 身 的 作用 域 之 外 “ 艇 开 ” 构 造 函 数 的 声明 ( 通过 冒号 操作 符 ): 

class Motorcycle 


public int driverIntensity; 
public string driverName; 


// 构造 函数 链 
public Motorcycle() {} 
public Motorcycle(int intensity) 
: this(intensity, "") {} 
public Motorcycle(string name) 
: this(0, name) {} 





// 这 是 做 所 有 工作 的 “ 主 ” 构 造 济 数 
public Motorcycle(int intensity, string name) 


if (intensity > 10) 
{ 
intensity = 10; 


driverIntensity = intensity; 
driverName = name; 


i 

需要 理解 的 是 ， 使 用 this 关 键 字 串 联 构造 函数 不 是 强制 的 。 但 如 果 使 用 这 项 技术 ， 类 定义 就 会 更 
容易 维护 、 更 简明 。 再 说 一 次 ， 使 用 这 项 技术 可 以 简化 编程 任务 ， 因 为 真正 的 工作 都 交 给 了 一 个 构造 
函数 (通常 这 个 构造 函数 有 大 多 数 的 参数 ) 来 做 ， 而 其 他 构造 函数 只 是 将 “皮球 ” 踢 给 它 就 可 以 了 。 








说 明 回想 一 下 ， 第 4 章 我 们 介绍 过 ，C# 支 持 可 选 参数 ， 如 果 在 类 构造 函数 中 使 用 可 选 参数 ， 可 以 达 
到 跟 使 用 构造 函数 链 一 样 的 效果 ， 还 能 省 下 不 少 代码 。 过 会 儿 我 们 就 来 展示 一 下 。 





5.3.2 ”观察 构造 函数 流程 

最 后 ,我 们 要 知道 在 构造 函数 传递 参数 给 指定 的 主 构造 函数 (并且 构 造 函 数 处 理 了 数据 ) 之 后 ， 
调用 者 最 初 调用 的 构造 函数 还 会 执行 所 有 剩余 的 代码 语句 。 为 了 说 明 清 楚 ， 更 新 每 一 个 Motorcycle 类 
的 构造 晒 数 ， 各 自 调 用 Console.WriteLine() : 

class Motorcycle 


public int driverIntensity; 
public string driverName; 


// 构造 函数 链 
public Motorcycle() 
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Console.WriteLine("In default ctor"); 


public Motorcycle(int intensity) 
: this(intensity, "") 


Console.WriteLine("In ctor taking an int"); 


public Motorcycle(string name) 
: this(0, name) 


Console.WriteLine("In ctor taking a string"); 


} 
//“ 主 ”构造 函数 完成 所 有 实际 工作 
public Motorcycle(int intensity, string name) 


Console.WriteLine("In master ctor "); 
if (intensity > 10) 
{ 


intensity = 10; 


driverIntensity = intensity; 
driverName = name; 


} 


现在 ,确保 Main() 方 法 按 如 下 代码 使 用 Motorcycle 对 象 : 


static void Main(string[] args) 


Console.WriteLine("***** Fun with class Types *****\n"); 


// 创建 Motorcycle 

Motorcycle c = new Motorcycle(5); 
c.SetDriverName("Tiny"); 

c.PopAWheely(); 

Console.WriteLine("Rider name is {0}", c.driverName); 
Console.ReadLine(); 


} 
考虑 前 面 的 Main() 方 法 输出 : 





*A***** Fun with class Types ***** 


In master ctor 

In ctor taking an int 
Yeeeeeee Haaaaaeewww! 
Yeeeeeee Haaaaaeewww! 
Yeeeeeee Haaaaaeewww! 
Yeeeeeee Haaaaaeewww! 
Yeeeeeee Haaaaaeewww! 
Yeeeeeee Haaaaaeewww! 
Rider name is Tiny 


?rs me ew a 


我 们 可 以 看 到 ， 构 造 函 数 的 逻辑 流程 如 下 。 
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口 通过 调用 只 有 单个 int 的 构造 聘 数 来 创建 对 象 。 

口 构造 函数 将 提供 的 数据 转发 给 主 构造 函数 ， 并 且 提 供 调 用 者 没有 提供 的 其 他 初始 参数 。 

口 主 构 造 函 数 把 传人 的 数据 赋值 给 对 象 的 字段 数据 。 

口 控制 返回 到 最 初 调用 的 构造 函数 ， 并 且 执 行 所 有 剩余 的 代码 语句 。 

使 用 构造 函数 链 的 好 处 是 ， 这 种 编程 模式 在 任何 版 本 的 C 夫 看 言 和 .NET 平 台中 都 是 可 用 的 。 然 而 ， 
在 使 用 .NET 4.0 或 更 高 版 本 时 ， 你 还 可 以 使 用 可 选 参数 代替 传统 的 构造 函数 链 ， 从 而 大 大 简化 编程 


任务 。 


5.3.3 ”再 谈 可 选 参 数 

我 们 在 第 4 章 中 学 习 了 可 选 参数 和 命名 参数 。 可 选 参 数 允许 我 们 对 传人 参数 提供 默认 值 。 如 果 调 
用 者 希望 使 用 这 些 默 认 值 而 不 是 使 用 自 定义 数据 ， 就 不 必 再 单独 指定 这 些 参数 。 考 虑 下 面 这 个 版 本 的 
Motorcycle 类 ， 它 只 用 一 个 构造 哺 数 定义 却 提供 了 多 种 构造 对 象 的 方式 : 


class Motorcycle 


{ 
// 使 用 可 选 参数 的 单个 构造 函数 
public Motorcycle(int :intensity = 0，string name = "") 





if (intensity > 10) 
intensity = 10; 


driverIntensity = intensity; 
driverName = name; 


有 了 这 个 构造 函数 , 现在 你 可 以 分 别 使 用 0 个 、1 个 或 2 个 参数 来 新 建 Motorcycle 对 象 。 使 用 命名 参 


数 语法 ， 可 以 跳 过 接受 的 默认 设置 ( 见 第 3 章 )。 
static void MakeSomeBikes() 


// driverName = "", driverIntensity = 0 

Motorcycle m1 = new Motorcycle(); 

Console.WritelLine("Name= {0}, Intensity= {1}", 
m1.driverName, m1.driverIntensity); 


// driverName = "Tiny", driverIntensity = 0 

Motorcycle m2 = new Motorcycle(name: "Tiny"); 

Console.WriteLine("Name= {0}, Intensity= {1}", 
m2.driverName, m2.driverIntensity); 


// driverName = "", driverIntensity = 7 
Motorcycle m3 = new Motorcycle(7); 
Console.Writeline("Name= {0}, Intensity= {1}", 
m3.driverName, m3.driverIntensity); 
} 


尽管 可 选 /命名 参数 灵巧 地 简化 了 为 给 定 类 定义 构造 函数 集 的 方式 ， 但 要 记 住 的 是 这 种 语法 只 能 
在 .NET 4.0 或 更 高 版 本 的 平台 下 运行 。 如 果 你 需要 构建 一 个 在 任何 版 本 的 .NET 平 台 下 都 能 工作 的 类 ， 
最 好 坚持 使 用 传统 的 构造 函数 链 技术 。 
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不 管 怎样 ， 现 在 我 们 已 经 可 以 定义 一 个 包含 字段 数据 ( 即 成 员 变 量 ) 和 各 种 成 员 ( 如 方法 和 构造 
函数 ) 的 类 了 。 接 下 来 ， 我 们 正式 介绍 static 关 键 字 。 





源 代 码 ”SimpleClassExample 项 目的 源 代码 位 于 Chapter 5 子 目录 下 。 


5.4 static 关键 字 


C# 类 (或 结构 ) 可 以 通过 static 关 键 字 来 定义 许多 静态 成 员 。 如 果 这 样 的 话 ， 这 些 成 员 就 只 能 直 
接 从 类 级 别 而 不 是 对 象 引 用 调用 。 为 了 说 明 区 别 , 考虑 一 下 我 们 的 老 朋 友 System.Console。 可 以 看 到 ， 
我 们 没有 从 对 象 级 别 调用 WriteLine() 方 法 : 

// 错误 | WriteLine() 不 是 对 象 级 别 的 方法 


Console c = new Console(); 
c.WriteLine("I can't be printed..."); 


而 是 将 类 型 名 字 作 为 静态 成 员 WriteLine() 的 前 级 : 


// 正确 ! WriteLine() 是 静态 方法 
Console.WriteLine("Thanks..."); 


简 而 言 之 ， 静 态 方法 被 ( 类 设计 者 ) 认为 是 非常 普遍 的 项 ， 并 且 不 需要 在 调用 成 员 时 创建 类 型 的 
实例 。 虽 然 任 何 类 都 可 以 定义 静态 方法 ， 但 是 它们 通常 出 现在 “工具 类 ”中 。 根 据 定 义 ， 工 具 类 是 不 
维护 任何 对 象 级 别 的 状态 且 并 非 由 new 关 键 字 创建 的 类 。 因 此 ， 工 具 类 会 以 类 级 别 ( 即 静 态 ) 成 员 公 
开 所 有 功能 。 

例如 ， 如 果 我 们 使 用 Visual Studio 对 象 浏览 器 ( 通过 View 一 Object Browser 菜 单项 ) 来 查看 
mscorlib.dll 的 System 命名 空间 ， 你 将 发 现 Console 、Math、Environment 和 GC 类 的 所 有 成 员 都 通过 静态 成 
员 公 开 其 所 有 功能 。.NET 基 础 类 库 中 的 工具 类 不 多 ， 有 几 个 。 

另外 ,还 要 注意 ,静态 成 员 并 不 只 是 存在 于 工具 类 中 ,它们 可 以 是 任何 类 定义 的 一 部 分 。 只 需 记 住 
静态 成 员 推动 给 定 项 到 类 级 别 ， 而 不 是 对 象 级 别 。 在 后 面 的 几 节 中 我 们 会 看 到 ，static 关 键 字 可 应 用 于 : 

口 类 的 数据 

口 类 的 方法 

口 类 的 属性 

口 构造 函数 

口 整个 类 定义 

让 我 们 从 静态 数据 的 概念 开始 ， 看 看 每 种 情况 。 


说 明 本 章 后 面 在 学 习 属性 的 作用 时 你 就 能 一 睹 静态 属性 的 作用 了 。 


5.4.1 定义 静态 数据 


当 我 们 设计 类 时 ， 大 部 分 情况 下 ， 我 们 会 将 数据 定义 为 实例 级 别 的 数据 ， 也 就 是 非 静态 数据 。 如 
果 类 定义 了 非 静态 数据 〈 或 者 说 是 实例 数据 )， 类 型 的 每 一 个 对 象 都 会 维护 字段 的 独立 副本 。 相 较 而 
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zl 


定义 类 的 静态 数据 时 ， 同 一 类 别 的 所 有 对 象 都 会 共享 内 存 。 


// 一 个 简单 的 储 著 账户 类 
class SavingsAccount 


// 实例 级 别 的 数据 
public "double currBalance; 


public SavingsAccount(double balance) 
currBalance = balance; 
} 
} 
创建 savingsAccount 对 象 的 时 候 ， 每 一 个 对 象 都 会 分 配 currBalance 字 段 的 内 存 。 因 此 你 可 以 创建 五 个 
不 同 的 SavingsAccount 对 象 ， 每 一 个 都 有 自己 的 余额 。 这 样 ， 改 变 一 个 账户 的 余额 ， 其 他 对 象 都 不 会 受 影响 。 
在 男 一 方面 , 静态 数据 分 配 一 次 并 且 在 相同 类 型 的 所 有 对 象 之 间 共 享 。 为 了 演示 静态 数据 的 作用 ， 
为 SavingsAccount 类 增加 一 个 名 为 currInterestRate 的 静态 数据 点 ， 并 设置 为 默认 值 0.04 


// 一 个 简单 的 储 著 账 户 类 
Class SavingsAccount 





// 实 例 级 别 的 数据 
public double currBalance; 


// 静 态 数据 点 
public static double currInterestRate = 0.04; 


public SavingsAccount(double balance) 
{ 
currBalance = balance; 
} 
} 
如 果 要 在 Main() 方 法 中 创建 3 个 SavingsAccount 实 例 ， 可 以 按 如 下 方式 编写 代码 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Static Data *****\n"); 
SavingsAccount s1 = new SavingsAccount(50); 
SavingsAccount s2 = new SavingsAccount(100); 
SavingsAccount s3 = new SavingsAccount(10000.75); 
Console.ReadLine(); 


} 
内 存 中 的 数据 分 配 和 图 5-3 所 示 的 差不多 。 


Savings Account:S1 


currBalance=50 如 
Savings AccountS2 


curealancasi0D 一 一 > curinterestRate=.04 


Savings AccountS3 
currBalance=10000.75 


图 5-3 ”静态 数据 分 配 一 次 并 被 类 的 所 有 实例 所 共享 


140 


第 5 章 封装 


这 里 , 我们 的 前 提 是 所 有 储蓄 账户 的 利率 都 相同 。 因 为 静态 数据 字段 是 由 所 有 对 象 共享 的 ， 因 此 
如 果 以 某 种 方式 改变 了 它 ， 所 有 对 象 在 下 次 访问 静态 数据 时 都 会 看 到 新 值 。 因 为 它们 实际 上 都 关注 同 
一 个 内 存 位 置 。 要 了 解 如 何 改变 ( 或 获取 ) 静态 数据 ， 需 要 考虑 静态 方法 的 作用 。 


5.4.2 ”定义 静态 方法 

下 面 更 新 SavingsAccount 类 来 定义 两 个 静态 方法 。 第 一 个 静态 方法 ( GetInterestRate() ) 会 返回 
当前 利率 ， 第 二 个 静态 方法 ( SetInterestRate() ) 允许 你 改变 利率 。 

// 一 个 简单 的 储 著 账户 类 


class SavingsAccount 


} 


// 实例 级 别 数据 
public double currBalance; 


// 静态 数据 点 
public static double currInterestRate = 0.04; 


public SavingsAccount(double balance) 


currBalance = balance; 


} 


// 获取 /设置 利率 的 静态 成 员 
public static void SetInterestRate(double newRate) 
{ currInterestRate = newRate; } 


public static double GetInterestRate() 
{ return currInterestRate; } 


现在 ， 看 看 下 面 的 用 法 : 


static void Main(string[] args) 


{ 


} 


Console.WritelLine("***** Fun with Static Data *****\n"); 
SavingsAccount s1 = new SavingsAccount(50); 
SavingsAccount s2 = new SavingsAccount(100); 


// 打印 当前 利率 
Console.WritelLine("Interest Rate is: {0}", SavingsAccount.GetInterestRate()); 


// 生成 新 对 象 ， 这 并 没有 重 设 利率 
SavingsAccount s3 = new SavingsAccount(10000.75); 
Console.WritelLine("Interest Rate is: {0}", SavingsAccount.GetInterestRate()); 


Console.ReadLine(); 


前 面 的 Main() 方 法 的 输出 如 下 所 示 : 
CG 


六 沙沙 冰冰 Fun With Static Data ***** 


Interest Rate is: 0.04 
Interest Rate is: 0.04 
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可 以 看 到 ， 当 创建 savingsAccount 类 的 新 实例 时 ， 静 态 数据 的 值 没有 重 置 ， 因 为 CLR 把 数据 分 配 到 
内 存 中 只 会 进行 一 次 。 之 后 , 所 有 SavingsAccount 类 型 的 对 象 会 针对 currInterestRate 字 段 操作 同一 个 值 。 

在 设计 C# 类 时 ， 哪 一 部 分 数据 应 该 定义 为 静态 成 员 ， 而 哪 一 部 分 数据 不 应 该 定义 为 静态 成 员 ， 这 
是 一 个 难题 。 尽 管 没有 硬性 规定 ， 但 要 记 住 静态 数据 字段 是 由 所 有 对 象 共享 的 。 因 此 ， 如 果 你 要 定义 
一 个 所 有 对 象 都 可 以 分 享 的 数据 点 ， 就 可 以 使 用 静态 成 员 。 

想 想 看 如 果 利 率 变量 不 定义 成 静态 的 ， 将 会 是 什么 样 。 这 意味 着 每 个 SavingsAccount 对 象 都 必须 
包含 自己 的 currInterestRate 字 段 。 假 设 你 创建 了 100 个 SavingsAccount 对 象 ， 并 且 需 要 改变 利率 。 那 
么 就 需要 调用 100 次 SetInterestRate() 方 法 ! 这 显然 不 是 建立 共享 数据 模型 的 有 效 方 
法 。 同 样 ， 如 果 同 种 类 的 所 有 对 象 都 经 常 使 用 某 个 值 ， 也 非常 适合 使 用 静态 数据 。 


说 明 静态 成 员 在 其 实现 中 引用 非 静态 成 员 会 导致 编译 器 错误 。 与 此 类 似 , 在 静态 成 员 中 将 this 操 作 
符 用 做 上 暗示 对 象 的 “this” 也 是 错误 的 。 


5.4.3 ”定义 静态 构造 函数 
在 本 章 前 面 解释 过 ,常见 的 构造 函数 用 于 在 创建 对 象 时 设置 对 象 的 实例 数据 的 值 。 因 此 ， 如 果 在 实 
例 级 别 的 构造 函数 中 赋值 给 静态 数据 成 员 ， 你 会 惊奇 地 发 现 每 次 新 建 对 象 的 时 候 ， 值 都 会 重 置 。 例 如 ， 
假设 我 们 按 如 下 所 示 更 新 SavingsAccount 类 ( 同时 注意 我 们 不 再 内 联 初始 化 currInterestRate 字 段 ): 
class SavingsAccount 


public double currBalance; 
public static double currInterestRate; 


// 注 意 构造 函数 正在 设置 静态 成 员 currInterestRate 的 值 
public SavingsAccount(double balance) 


currInterestRate = 0.04; // 这 是 一 个 静态 数据 
currBalance = balance; 


机 
在 Main() 方 法 中 添加 以 下 代码 
static void Main( string[] args ) 


Console.WritelLine("***** Fun with Static Data *****\n"); 


// 创 建 一 个 账户 


SavingsAccount s1 = new SavingsAccount(50); 


// 输 出 当前 利率 
Console.WriteLine("Interest Rate is: {0}", SavingsAccount.GetInterestRate()); 


// 通 过 属性 改变 利率 
SavingsAccount.SetInterestRate(0.08); 


// 再 创建 一 个 账户 


SavingsAccount s2 = new SavingsAccount(100); 








// 应 该 打印 0.08， 对 吗 
Console.WriteLine("Interest Rate is: {0}", SavingsAccount.GetInterestRate()); 
Console.ReadLine(); 


如 果 我 们 执行 之 前 的 Main() 方 法 ， 就 会 注意 到 ， 每 次 创建 新 的 SavingsAccount 对 象 的 时 候 ， 
currInterestRate 变 量 就 会 被 重 置 , 并 且 总 是 被 设置 为 0.04。 显然, 用 一 个 普通 的 实例 级 别 的 构造 函数 
设置 静态 数据 的 值 ， 这 在 某 种 程度 上 违背 了 我 们 最 初 的 意愿 。 每 次 新 建 对 象 ， 类 级 别 的 数据 都 将 被 重 
置 ! 设置 静态 字段 的 一 种 方法 是 像 原 来 一 样 使 用 成 员 初 始 化 语法 : 

class SavingsAccount 


public double currBalance; 


// 静态 数据 点 
public static double currInterestRate = 0.04; 
} 
不 管 创建 多 少 个 对 象 ， 这 种 方法 都 可 以 确保 静态 数据 只 被 分 配 一 次 。 但 是 , 万 一 静态 数据 的 值 是 
在 运行 时 获取 的 呢 ? 例如 , 在 一 个 普通 的 银行 应 用 程序 中 , 利率 变量 的 值 应 该 从 数据 库 或 外 部 文件 中 
读 取 。 要 完成 这 样 的 任务 ， 需 要 一 个 类 似 构 造 函 数 的 方法 作用 域 来 执行 代码 语句 。 
正 是 由 于 这 个 原因 , C# 人 允许 我 们 定义 静态 构造 函数 , 安全 地 设置 静态 数据 的 值 。 考虑 下 面 的 更 新 : 


class SavingsAccount 


public double currBalance; 
public static double currInterestRate; 


public SavingsAccount(double balance) 


currBalance = balance; 


// 静态 构造 函数 


static SavingsAccount() 


Console.WritelLine("In static ctor!"); 
currIinterestRate = 0.04; 


} 

简 而 言 之 ,静态 构造 函数 是 特殊 的 构造 函数 ,并 且 非 常 适用 于 初始 化 在 编译 时 未 知 的 静态 数据 的 
值 (例如 , 我 们 需要 从 外 部 文件 读 取 值 或 者 生成 随机 数 等 ), 假如 你 重新 运行 之 前 的 Main() 方 法 , 输出 
会 如 你 所 料 。 注 意 信息 “In static ctor!” 只 会 打印 一 次 ， 因 为 CLR 在 第 一 次 使 用 之 前 调用 了 所 有 静态 构 
造 函 数 〈 且 对 于 应 用 程序 的 该 实例 不 再 调用 它们 ): 





六 来 水 炒米 Fun with Static Data ***** 


In static ctor! 
Interest Rate is: 0.04 
Interest Rate is: 0.08 
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这 里 是 有 关 静 态 构 造 函 数 有 趣 的 几 点 。 

口 一 个 类 只 可 以 定义 一 个 静态 构造 函数 。 换 句 话 说 ， 就 是 静态 构造 函数 不 能 被 重 载 。 

口 静态 构造 函数 不 允许 访问 修饰 符 并 且 不 能 接受 任何 参数 。 

口 无 论 创建 了 多 少 类 型 的 对 象 ， 静 态 构 造 函 数 只 执行 一 次 。 

口 运行 库 创 建 类 实例 或 调用 者 首次 访问 静态 成 员 之 前 ， 运 行 库 会 调用 静态 构造 晴 数 。 

口 静态 构造 函数 的 执行 先 于 任何 实例 级 别 的 构造 函数 。 

有 了 这 样 的 修改 ， 在 我 们 创建 新 SavingsAccount 对 象 时 ， 静 态 数 据 的 值 就 会 被 维持 。 因 为 不 管 创 
建 了 多 少 对 象 ， 静 态 成 员 只 会 在 静态 构造 函数 中 设置 一 次 。 


源 代码 ”StaticDataAndMember 项 目 包含 在 Chapter 5 子 目录 下 。 


5.4.4 定义 静态 类 


也 可 以 直接 在 类 级 别 应 用 static 关 键 字 。 如 果 一 个 类 被 定义 为 静态 的 , 就 不 能 使 用 new 关 键 字 来 创 
建 ， 并且 只 能 包含 用 static 关 键 字 标记 的 成 员 或 字段 。 如 果 不 是 这 样 ， 就 会 收 到 编译 错误 。 


说 明 只 包含 静态 功能 的 类 或 结构 通常 称 为 工具 类 。 在 设计 工具 类 时 ,将 类 定义 为 静态 类 是 一 个 非 
常 好 的 做 法 。 


乍 一 看 这 好 像 是 完全 无 用 的 特性 ， 因 为 一 个 类 不 能 被 创建 似乎 不 算 什 么 好 处 。 然 而 ， 如 果 我 们 创 
建 一 个 只 包含 静态 成 员 或 常量 数据 的 类 ， 就 不 需要 先进 行 分 配 。 为 了 说 明 这 一 点 ,我 们 创建 一 个 控制 
台 应 用 程序 SimpleUftilityClass， 下 一 步 定义 一 个 新 的 静态 类 类 型 ; 

// 静态 类 只 能 包含 静态 成 员 


static class TimeUtilClass 


public static void PrintTime() 
{ Console.WriteLine(DateTime.Now.ToShortTimeString()); } 


public static void PrintDate() 
{ Console.WritelLine(DateTime.Today.ToShortDateString()); } 


由 于 这 个 类 定义 了 static 关 键 字 ， 我 们 就 不 能 使 用 new 关 键 字 创建 TimeUtilClass 的 实例 ， 而 是 所 
有 功能 都 从 类 级 别 公开 : 
static void Main(string[] args) 
Console.WritelLine("***** Fun with Static Data *****\n"); 


// 这 刚刚 好 

TimeUtilClass.PrintDate(); 
TimeUtilClass.PrintTime(); 

// 编译 器 错误 | 不 能 创建 静态 类 
TimeUtilClass u = new TimeUtilClass (); 


Conskle.ReadLine(); 
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本 章 进行 至 此 ， 你 应 该 已 经 对 创建 包含 构造 函数 、 字 段 以 及 各 种 静态 ( 非 静 态 ) 成 员 的 类 类 型 有 
了 充分 的 了 解 。 既 然 已 经 熟悉 了 这 些 基 础 ， 那 么 让 我 们 来 正式 研究 OOP ( 面向 对 象 编程 ) 的 3 个 支柱 。 


源 代码 ”SimpleUtilityClass 项 目的 源 代码 位 于 Chapter 5 子 目录 下 。 


5.5 定义 OOP 的 支柱 


所 有 面向 对 象 的 语言 ( C#、Java、C++ 和 Visual Basic 等 ) 必须 满足 OOP 的 3 个 核心 原则 ,通常 也 叫 
做 “OOP 的 支柱 ”。 

口 封装 : 这 种 语言 怎样 隐藏 一 个 对 象 的 内 部 实现 并 且 保 护 数据 完整 性 ? 

口 继承 : 这 种 语言 是 怎样 促进 代码 重用 的 ? 

口 多 态 : 这 种 语言 是 怎样 让 你 用 同样 的 方式 处 理 相关 对 象 的 ? 

在 深入 每 一 个 支柱 的 语法 细节 之 前 ， 理 解 每 一 个 支柱 的 基本 作用 是 很 重要 的 。 因 此 ， 下 面 简要 介 
绍 一 下 ， 本 章 其 余部 分 和 第 6 章 将 会 讨论 完整 细节 。 


5.5.1 封装 的 作用 


OOP 的 第 一 个 支柱 是 封装 (encapsulation ) 。 这 是 将 对 象 用 户 ? 不 必 了 解 的 实现 细节 隐藏 起 来 的 一 
种 语言 能 力 。 例 如 ， 假 设 你 正在 使 用 DatabaseReader 类 ， 它 有 0pen() 和 Close() 两 个 方法 : 


// 假设 DatabaseReader 封 装 了 数据 库 操 作 的 细节 
DatabaseReader dbReader = new DatabaseReader(); 
dbReader .Open(@"C:\AutoLot .mdf"); 


// 使 用 数据 文件 来 做 一 些 事情 ， 然 后 关闭 文件 

dbReader.Close(); 

这 个 假想 的 DatabaseReader 类 封装 了 查找 、 加 载 、 操 作 和 关闭 数据 文件 的 内 部 细节 。 程 序 员 喜 欢 
封装 ， 因 为 OOP 的 这 个 支柱 让 程序 设计 任务 更 简单 。 没 有 必要 担心 在 幕后 完成 DatabaseReader 类 的 工作 
的 众多 代码 ， 只 需 创建 一 个 实例 并 发 送 合 适 的 消息 ( 例如,“ 打开 位 于 C 驱 动 器 的 AutoLot.mdf 文 件 ”) 
即 可 。 

和 封装 编程 逻辑 紧密 相关 的 概念 是 数据 保护 的 概念 。 理 想 情 况 下 ， 对 象 的 状态 数据 应 该 使 用 
private ( 或 protected ) 关键 字 来 指定 。 这 样 的 话 ， 外 部 世界 就 不 能 直接 改变 或 获取 底层 的 值 ， 而 必 
须 “有 礼貌 地 请 求 ”。 这 是 好 事情 ， 因 为 公共 的 数据 点 很 容易 被 破坏 (但 愿 是 无 意 的 , 而 不 是 有 意 的 )。 
我 们 稍 后 会 全 面 研 究 封 装 。 


5.5.2 ”继承 的 作用 


OOP 的 下 一 个 支柱 是 继承 ( inheritance ) ， 它 是 指 基于 已 有 类 定义 来 创建 新 类 定义 的 语言 能 力 。 
本 质 上 ,通过 继承 ,， 子 类 可 以 继承 基 类 ( 或 称 父 类 ) 核心 的 功能 ， 并 扩展 基 类 的 行为 。 图 5-4 是 一 个 简 
单 的 例子 。 





Qz 指使 用 你 编写 的 类 进行 编程 的 人 。 一 一 编者 注 
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图 5-4 ”is-a 关 系 


从 图 5-4 中 我 们 可 以 知道 “六 边 形 是 图 形 ， 图 形 又 是 对 象 " 。 如 果 我 们 的 类 是 这 种 形式 的 继承 ， 就 
在 类 型 之 间 创 建 一 种 “is-a” 的 关系 。 "is-a” 关 系 又 称 为 继承 。 

在 这 里 ,我 们 会 认为 shape 定 义 了 许多 所 有 派生 类 都 公有 的 成 员 ( 可 能 是 用 于 绘制 形状 的 颜色 值 ， 
也 可 能 是 表示 高 度 和 宽度 的 值 )。 由 于 Hexagon 类 扩展 了 shape， 它 也 就 继承 了 由 Shape 和 0bject 定 义 的 
核心 功能 ， 并 且 它 自己 也 定义 了 其 他 六 边 形 相关 的 功能 ( 不管 是 什么 )。 
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说 明 在 .NET 平 台 下 , System.0bject 是 所 有 类 层次 关系 中 的 最 高 父 类 ， 它 定义 了 最 基本 的 一 些 
在 第 6 章 中 会 完整 介绍 。 


在 OOP 中 还 有 男 一 种 形式 的 代码 重用 : 包含 /委托 模型 ( 也 就 是 has-a 关 系 ， 或 称 聚合 )。 这 种 重用 
的 形式 不 是 用 来 建立 父 类 / 子 类 关系 的 。 它 意味 着 ,一 个 类 可 以 定义 另 一 个 类 的 成 员 变量 , 并 向 对 象 用 
户 间接 公开 它 的 功能 ( 如 果 需 要 的 话 )。 

例如 ， 给 一 辆 汽车 建 模 ， 你 可 能 想 表达 一 辆 车 has-a (有 一 个 ) 收音 机 的 概念 。 让 Car 继 承 Radio 类 
或 反之 都 是 不 合 逻 辑 的 。( Car 是 一 个 Radio? 当然 不 是 ! ) 实际 上 , 你 有 两 个 类 一 起 合作 ,其 中 car 类 创 
建 并 公开 了 Radio 的 功能 : 

class Radio 


public void Power(bool turnOn) 
Console.WriteLine("Radio on: {0}", turnOn); 
} 
class Car 


{ 
// 汽车 “has-a” 收 音 机 
private Radio myRadio = new Radio(); 


public void TurnOnRadio(bool onOff) 





{ 
// 到 内 部 对 象 的 委托 调用 
myRadio.Power(onOff); 
} 
注意 ， 对 象 用 户 不 知道 Car 类 在 使 用 内 部 的 Radio 对 象 : 
static void Main(string[] args) 
// 调用 在 内 部 被 转发 到 Radio 


Car viper = new Car(); 
viper.TurnOnRadio(false); 


5.5.3 ”多 态 的 作用 


OOP 的 最 后 一 个 支柱 是 多 态 (polymorphism ) ， 它 表示 的 是 语言 以 同一 种 方式 处 理 相 关 对 象 的 能 力 。 
准确 地 说 ， 这 个 面向 对 象 语言 的 原则 人 允许 基 类 为 所 有 的 派生 类 定义 一 个 成 员 集合 ( 正式 的 术语 为 多 态 接 
口 )。 一 个 类 类 型 的 多 态 接口 由 任意 个 虚拟 (virtual ) 或 抽象 (abstract ) 成 员 组 成 (第 6 章 会 详细 介绍 )。 

简 而 言 之 ， 虚 拟 成 员 是 定义 默认 实现 的 基 类 中 的 成 员 ， 它 可 能 被 派生 类 改变 ( 更 正式 的 说 法 是 重 
写 )， 而 抽象 方法 是 基 类 中 不 提供 默认 实现 的 成 员 , 但 它 提供 签名 。 当 一 个 类 派生 自 定义 了 抽象 方法 
的 基 类 时 ， 抽 象 方法 必须 被 派生 类 所 重 写 。 当 派生 类 重 写 由 基 类 定义 的 成 员 时 ， 其 实 就 重 定义 了 响应 
相同 请 求 的 方式 。 

为 了 预览 多 态 ， 让 我 们 再 来 看 图 $-5 中 的 图 形 层 次 结构 。 假 设 shape 类 定义 了 Draw() 虚 拟 方法 ， 该 
方法 不 带 参数 。 因 为 每 一 个 图 形 需 要 用 不 同 的 方式 绘制 ， 所 以 子 类 ( 例如 ，Hexagon 和 Circle ) 可 以 按 
自己 的 需要 重 写 这 个 方法 ( 如 图 5-5 所 示 )。 
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在 Hexagon 对 象 上 调用 
Draw() 绘 制 一 个 二 维 的 
六 边 形 


图 $-5 ”传统 多 态 


5.6 “CH# 访 问 修饰 符 147 


在 设计 完 多 态 接口 后 ， 可 以 在 代码 中 开始 做 不 同 的 假设 。 例 如 ， 由 于 Hexagon 和 Circle 都 继承 
自 共同 的 父 类 ( shape ), 因此 Shape 类 型 的 数组 可 以 包含 任何 派生 自 该 基 类 的 类 型 。 此外, 由 于 Shape 
为 所 有 派生 类 定义 了 多 态 接口 (本 例 中 为 Draw() 方 法 )， 我 们 可 以 假设 数组 中 的 每 个 成 员 都 具有 该 
功能 。 

考虑 下 面 的 Main() 方 法 ， 它 指示 一 个 Shape 的 派生 类 型 的 数组 使 用 Draw() 方 法 绘制 自己 : 

class Program 


static void Main(string[] args) 


Shape[] myShapes = new Shape[3]; 
myShapes[0] = new Hexagon(); 
myShapes[1] = new Circle(); 
myShapes[2] = new Hexagon(); 


foreach (Shape s in myShapes) 


// 使 用 多 态 接 口 
s.Draw(); 


Console.ReadLine(); 
} 
} 


我 们 对 OOP 支 柱 的 基本 讲述 就 是 这 些 。 现 在 你 已 经 对 这 些 理论 有 了 概念 ,本章 的 其 他 篇 幅 会 研究 
C# 如 何 处 理 封装 的 更 多 细节 。 第 6 章 会 处 理 继承 和 多 态 的 细节 。 


5.6 ”C# 访 问 修 饰 符 


在 使 用 封装 的 时 候 ， 我们 必须 考虑 类 型 的 哪些 方面 对 我 们 应 用 程序 的 哪些 部 分 可 见 。 准 确 地 说 ， 
类 型 ( 类、 接口 、 结 构 、 枚 举 以 及 委托 ) 以 及 它们 的 成 员 ( 属性 、 方 法 、 构 造 函 数 、 字 段 等 ) 总 是 使 
用 某 个 关键 字 来 定义 ， 这 个 关键 字 用 来 控制 它们 对 应 用 程序 其 他 部 分 如 何 “可 见 "。 尽 管 C# 定 义 了 许 
多 关键 字 来 控制 权限 ,但 是 它们 会 因为 应 用 的 地 方 不 同 ( 类 型 或 成 员 ) 而 不 同 。 表 5-1 列 举 了 每 一 个 访 
问 修饰 符 的 作用 以 及 它们 可 以 应 用 到 的 地 方 。 


表 5-1 C# 访 问 修饰 符 





C# 访 问 修饰 符 可 以 应 用 到 的 地 方 作 用 
Public 类 型 或 者 类 型 成 员 公共 的 项 没有 限制 。 公 共 成 员 可 从 对 象 以 及 任何 派生 类 访问 。 
公共 类 型 可 以 从 其 他 外 部 程序 集 进行 访问 
Private 类 型 成 员 或 者 骨 套 类 型 ”私有 项 只 能 由 定义 它们 的 类 (或 结构 ) 进行 访问 
protected 类 型 成 员 或 者 嵌 套 类 型 ” 受 保护 项 可 以 由 定义 它们 的 类 及 其 任意 子 类 使 用 ,但 外 部 类 无 
法 通过 C# 的 点 操作 符 访问 
internal 类 型 或 者 类 型 成 员 内 部 项 只 能 在 当前 程序 集中 访问 。 因 此 ， 如 果 我 们 在 .NET 类 库 


中 定义 一 组 内 部 类 型 的 话 ， 其 他 程序 集 就 不 能 使 用 它们 
protected internal 类 型 成 员 或 者 垦 套 类 型 如果 在 一 个 项 上 组 合 protected 和 internal 关 键 字 ， 项 在 定义 它 
们 的 程序 集 、 类 以 及 派生 类 中 可 用 
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在 本 章 中 , 我 们 只 关心 public 和 private 关 键 字 。 后 面 的 章节 会 研究 internal 和 protected internal 
修饰 符 ( 构建 .NET 代 码 类 库 的 时 候 有 用 ) 以 及 protected 修 饰 符 ( 在 创建 类 层次 关系 的 时 候 有 用 ) 的 
作用 。 


5.6.1 默认 的 访问 修饰 符 


默认 情况 下 ， 类 型 成 员 是 隐 式 私有 的 ， 而 类 型 是 隐 式 内 部 的 。 因 此 ， 下 面 的 类 定义 自动 设置 为 内 
部 的 ， 而 类 型 的 默认 构造 函数 自动 设置 为 私有 的 : 
// 具有 私有 默认 构造 也 数 的 内 部 类 


class Radio 


Radio( ){} 


因此 ， 要 允许 其 他 类 型 调用 对 象 的 成 员 ， 我们 必须 将 它们 标记 为 公共 可 访问 的 。 同 样 ， 如 果 我 们 
希望 对 外 部 程序 集 ( 再 说 一 次 ， 在 构建 .NET 代 码 库 的 时 候 很 有 用 ， 见 第 14 章 ) 公开 Radio， 就 需要 增 
加 public 修 饰 符 。 

// 具有 公共 默认 构造 函数 的 公共 类 

public class Radio 


public Radio(){} 


5.6.2 访问 修饰 符 和 内 套 类 型 


在 表 5-1 中 提 到 过 ，private、protected 以 及 protected internal 访 问 修饰 符 可 以 应 用 到 误 套 类 
型 上 。 第 6 章 会 详细 研究 骨 套 。 然 而 ， 在 这 里 我 们 需要 知道 的 是 ， 骨 套 类 型 是 直接 声明 在 类 或 结构 
作用 域 中 的 类 型 。 下 面 的 示例 是 一 个 赃 套 在 一 个 公共 类 〈 叫 做 SportsCar ) 中 的 私有 枚 举 ( 名 为 


CarColor ): 


public class SportsCar 


// 没 错 ! 谈 套 类 型 可 以 标记 为 私有 的 
private enum CarColor 


{ 


Red, Green, Blue 
; } 
在 这 里 ， 我 们 可 以 在 藤 套 类 型 上 应 用 private 访 问 修饰 符 。 然 而 ， 非 散 套 类 型 ( 如 SportsCar ) 只 
能 用 public 或 internal 修 饰 符 定义 。 因 此 ， 下 面 的 类 定义 是 不 合法 的 : 
// 错误 | 非 谈 套 类 型 不 能 被 标记 为 私有 的 
private class SportsCar 


{} 
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封装 概念 的 核心 是 , 对 象 的 内 部 数据 不 应 该 从 对 象 实例 直接 访问 。 对 象 数据 应 该 被 定义 为 私有 的 ， 
如 果 调 用 者 想 改变 对 象 的 状态 ， 就 要 间接 使 用 公共 成 员 。 为 了 解释 封装 的 必要 性 ， 假 设 你 创建 了 下 面 
的 类 定义 : 

// 只 有 一 个 公共 字段 的 类 

class Book 


public int numberOfPages; 


公共 数据 的 问题 是 ， 它 们 无 法 知道 ， 被 赋予 的 当前 值 是 否 符合 系统 的 当前 业务 规则 。C# 的 int 上 
限 是 非常 大 的 (2 147 483 647 )。 因 此 ， 编 译 器 允许 下 面 的 赋值 : 

// 嗯 ， 是 

static void Main(string[] args) 


Book miniNovel = new Book(); 
miniNovel.numberOfPages = 30000000; 


尽管 没有 溢出 Int 数 据 类 型 的 边界 ， 但 很 显然 ， 一 部 有 3000 万 页 的 迷你 小 说 在 现实 世界 中 是 不 合 
理 的 。 可 见 ， 公 共 字 段 不 能 提供 设置 上 下 限 的 方法 。 如 果 系 统 有 一 条 业务 规则 规定 一 部 迷你 小 说 必须 
有 1~1000 页 ， 怎 样 编程 施加 这 样 的 规则 就 成 了 大 问题 。 正 因为 这 样 ， 公 共 字 段 一 般 不 会 出 现在 产品 级 
的 类 定义 中 。 


说 明 0 表示 对 象 状 态 的 类 成 员 都 不 应 该 标记 为 公共 的 。 在 本 章 后 面 你 将 看 到 ， 可 以 使 
公共 常量 和 公共 只 读 字 段 。 


封装 提供 了 一 种 保护 状态 数据 完整 性 的 方法 。 与 定义 公共 字段 相 比 〈 很 容易 发 生 数 据 损坏 )， 应 该 
更 多 地 定义 私有 数据 字段 ， 这 种 字段 可 以 由 调用 者 间接 地 操作 。 定 义 私有 字段 的 主要 方式 有 以 下 两 种 : 
口 定义 一 对 传统 的 访问 方法 ( get， 也 称 为 获取 方法 ) 和 修改 方法 ( set， 也 称 为 设置 方法 ); 
> 
论 选 择 哪 一 种 技术 ， 关 键 是 封装 良好 的 类 应 该 对 外 部 世界 隐藏 操作 数据 方式 的 细节 。 这 通常 称 
wa we we 
层 的 实现 方式 ， 而 不 影响 任何 已 存在 的 使 用 它 的 代码 (假设 方法 的 参数 和 返回 值 保持 不 变 )。 


5.7.1 使 用 传统 的 访问 方法 和 修改 方法 执行 封装 


在 本 章 剩 余 的 内 容 中 ， 我 们 会 构建 一 个 相对 完整 的 类 来 模拟 普通 员工 。 首 先 ， 新 建 一 个 名 为 
EmployeeApp 的 控制 台 应 用 程序 ， 然 后 使 用 Project 一 Add 类 菜单 项 插入 一 个 新 的 类 文件 (叫做 
Employee.cs )。 使 用 如 下 字段 、 方 法 以 及 构造 函数 更 新 Employee 类 : 


class Employee 


// 字段 数据 
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private string empName; 
private int empID; 
private float currPay; 


// 构造 函数 

public Employee() {} 

public Employee(string name, int id, float pay) 
{ 


empName = name; 
empID = id; 
currPay = pay; 


// 方法 
public void GiveBonus(float amount) 


currPay += amount; 


public void Displaystats() 
{ 


Console.WriteLine("Name: {0}", empName); 
Console.WriteLine("ID: {0}", empID); 
Console.WriteLine("Pay: {0}", currPay); 


} 
注意 ， 现 在 使 用 private 关 键 字 来 定义 Employee 类 的 字段 。 这 样 ， 就 不 能 从 对 象 变量 直接 访问 
empName 、empID 以 及 currPay 字 段 。 因 此 ，Main() 方 法 中 的 以 下 逻辑 会 导致 编译 器 错误 : 
static void Main(string[] args) 
// 错误 ! 不 能 直接 从 对 象 访 问 私 有 成 员 


Employee emp = new Employee(); 
emp.empName = "Marv"; 


如 果 希 望 外 部 世界 和 表示 工人 姓名 的 私有 字符 串 进行 交互 ， 传 统 的 做 法 是 定义 访问 方法 ( 即 get 方 
法 ) 和 修改 方法 ( 即 set 方 法 )。set 方 法 可 以 改变 当前 实际 状态 数据 的 值 ， 只 要 它 满足 定义 的 业务 规则 。 

为 了 演示 这 一 点 ， 我 们 封装 一 个 empName 字 段 。 向 Employee 类 添加 如 下 所 示 的 public 方 法 。 注 意 ， 
SetName() 方 法 对 传人 的 数据 进行 了 检查 ， 以 确保 string 的 字符 数 少 于 或 等 于 15。 否 则 , 将 在 控制 台 打 
印 错误 并 返回 没有 修改 的 empName 字 段 。 


说 明 如 果 这 是 一 个 产品 级 的 类 ， 你 还 需要 在 构造 函数 逻辑 中 检查 员工 名 称 的 字符 长 度 。 我 们 暂时 
忽略 这 个 细节 ， 等 到 学 习 .NET 属 性 语法 时 再 整理 这 些 代码 。 


class Employee 
// 字段 数据 


private string empName; 


// 访问 方法 (get 方 法) 
public string GetName() 
{ 
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return empName; 


// 修改 方法 (set 方法 ) 
public void SetName(string name) 


// 在 赋值 之 前 检查 输入 的 值 
if (name.Length > 15) 
Console.WritelLine("Error! Name must be less than 16 characters!"); 
1 
a = Name; 
} 
} 
这 个 技术 需要 两 个 操作 单个 数据 点 的 特殊 方法 。 为 了 测试 新 方法 ， 按 如 下 所 示 更 新 Main() 方 法 : 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Encapsulation *****\n"); 
Employee emp = new Employee("Marvin", 456, 30000); 
emp.GiveBonus(1000); 

emp.DisplayStats(); 


// 使 用 get/set 方 法 来 和 对 象 的 名 字 进 行 交互 
emp.SetName("Marv"); 

Console.WritelLine("Employee is named: {0}", emp.GetName()); 
Console.ReadLine(); 


】 
鉴于 SetName() 方 法 中 的 代码 ， 如 果 你 指定 一 个 大 于 16 个 字符 的 字符 串 ( 如 下 所 示 )， 控 制 台 将 打 
印 一 个 硬 编码 的 错误 消息 : 


static void Main(string[] args) 


{ 


Console.WriteLine("***** Fun with Encapsulation *****\n"); 


// 大 于 16 个 字符 ! 控制 台 将 打印 错误 消息 
Employee emp2 = new Employee(); 
emp2.SetName("Xena the warrior princess"); 


Console.ReadLine(); 


到 目前 为 止 ， 一 切 正常 。 我 们 用 两 个 方法 GetName() 和 SetName() 封 装 了 私有 变量 empName。 如 果 要 
进一步 封装 Employee 类 中 的 数据 ， 需 要 添加 各 种 传统 方法 ( 如 GetID()、SetID()、GetCurrentPay()、 
SetCurrentPay() )。 每 个 修改 方法 都 可 能 包含 多 行 代码 来 执行 额外 的 业务 规则 检查 。 虽 然 这 没什么 复 
杂 的 ， 但 C# 语 言 提供 了 一 个 可 选 的 记 法 来 封装 类 数据 。 


5.7.2 ”使 用 .NET 属 性 进行 封装 


尽管 可 以 使 用 传统 的 获取 方法 和 设置 方法 封装 这 些 字段 数据 , ,NET 语言 还 是 提倡 使 用 属性 来 强制 
数据 封装 状态 数据 。 首 先 ， 理 解 属性 总 是 映射 到 “实际 的 ”访问 方法 和 修改 方法 。 因 此 ， 类 的 设计 者 
还 是 可 以 在 值 赋值 之 前 执行 任何 必要 的 内 部 逻辑 ( 比如 , 对 值 进行 大 写 转换 , 过 滤 值 中 的 不 合法 字符 ， 
检查 数字 值 的 边界 等 )。 
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下 面 是 更 新 后 的 Employee 类 ， 现 在 使 用 属性 语法 而 不 是 传统 的 获取 方法 和 设置 方法 来 强制 封装 : 


class Employee 


// 字段 数据 

private string empName; 
private int empID; 
private float currPay; 


// 属性 
public string Name 


get { return empName; } 
set 


if (value.Length > 15) 

Console.WritelLine("Error! Name must be less than 16 characters!"); 
else 

empName = value; 


} 
} 
// 我 们 可 以 在 这 些 属性 的 Set 中 添加 额外 的 业务 规则 ， 但 本 例 中 没有 这 个 必要 
public int ID 


get { return empID; } 
set { empID = value; } 


public float Pay 


get { return currpay; } 
set { currPpay = value; } 


} 


} 

C# 属 性 由 属性 作用 域 中 定义 的 get 作 用 域 (访问 方法 ) 和 set 作 用 域 (修改 方法 ) 构成 。 注 意 , 属 
性 通过 返回 值 指定 了 它 所 封装 的 数据 类 型 。 还 要 注意 的 是 , 属性 在 定义 时 没有 使 用 括号 ( 甚至 空 括号 )。 
考虑 下 面 ID 属性 的 注释 : 

// int 表 示 该 属性 所 封装 的 数据 类 型 


// 数据 类 型 必须 与 相关 的 字段 (empID) 相同 
public int ID // 没有 括号 
{ 


get { return empID; } 
set { empID = value; } 
在 属性 的 set 作 用 域 中 ， 我们 使 用 了 value 标 记 ， 它 用 来 表示 调用 者 设置 属性 时 传人 的 值 。 该 标记 
不 是 真正 的 C# 关 键 字 ， 而 是 上 下 文 关键 字 。 在 属性 的 set 作 用 域 里 ，value 总 是 表示 调用 者 设置 的 值 ， 
并 且 总 是 和 属性 本 身 的 数据 类 型 相同 。 因 此 ， 注 意 Name 属 性 是 如 何 测试 string 的 范围 的 : 


public string Name 


get { return empName; } 
set 


// 这 时 ，value 是 一 个 string 
if (value.Length > 15) 
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Console.WritelLine("Error! Name must be less than 16 characters!"); 
else 
empName = value; 


} 
} 
一 旦 创建 了 属性 ， 对 调用 者 来 说 就 好 像 是 获取 或 设置 公共 数据 点 ， 但 在 背后 会 调用 相应 的 get 或 
set 块 来 保持 封装 : 


static void Main(string[] args) 
{ 
Console.WriteLine("***** Fun with Encapsulation *****\n"); 
Employee emp = new Employee("Marvin", 456, 30000); 
emp.GiveBonus(1000); 
emp.DisplayStats(); ss 
// 设置 和 获取 Name 属 性 
emp.Name = "Marv"; 
Console.WritelLine("Employee is named: {0}", emp.Name); 
Console.ReadLine(); 


J 

属性 ( 和 访问 方法 、 修 改 方法 相对 ) 还 能 让 我 们 的 类 型 易于 操作 ， 因 为 属性 可 以 结合 C# 内 部 操作 
符 进行 使 用 。 假 设 我 们 的 Employee 类 类 型 有 一 个 私有 成 员 变量 表示 员工 的 年 龄 。 这 里 是 相关 更 新 ( 注 
意 使 用 了 构造 函数 链 ): 


class Employee 


// 新 字段 和 属性 
private int empAge; 
public int Age 


get { return empAge; } 
set { empAge = value; } 


// 更 新 的 构造 函数 

public Employee() {} 

public Employee(string name, int id, float pay) 
:this(name, 0, id, pay){} 


public Employee(string name, int age, int id, float pay) 
{ 


empName = name; 
empID = id; 
empAge = age; 
currPay = pay; 


// 更 新 的 DisplayStats() 方 法 现在 考虑 了 年 龄 
public void DisplayStats() 


Console.NriteLine( "Name: {0}", empName); 
Console.WriteLine("ID: {0}", empID); 
Console.WritelLine("Age: {0}", empAge); 
Console.WritelLine("Pay: {0}", currPay); 
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现在 假设 我 们 创建 了 名 为 joe 的 Employee 对 象 。 在 他 生日 的 时 候 ， 我们 希望 为 其 年 龄 加 1。 使 用 传 
统 的 访问 方法 和 修改 方法 ， 需 要 如 下 代码 : 


Employee joe = new Employee(); 
joe.SetAge(joe.GetAge() + 1); 


然而 ， 如 果 使 用 Age 属 性 封装 empAge， 就 可 以 将 代码 简化 为 : 


Employee joe = new Employee(); 
joe.Age++; 


5.7.3 ”使 用 类 的 属性 


属性 ， 特 别 是 属性 的 set 部 分 ， 常 用 于 打包 类 的 业务 规则 。 当 前 ，Employee 类 的 Name 属 性 可 以 确保 
名 称 不 多 于 15 个 字符 。 其 余 的 属性 (ID 、pPay 和 Age ) 也 可 以 用 相关 的 逻辑 进行 更 新 。 
尽管 这 很 好 ,但 是 想 想 通 常情 况 下 类 的 构造 函数 会 做 些 什 么 呢 ?” 接 收 传人 参数 ， 检 查 有 效 数 据 ， 
然后 赋值 给 内 部 私有 字段 。 现 在 ， 主 构造 函数 没有 检查 传 和 字符 串 数据 的 有 效 范围 ， 因 此 可 以 这 样 
修改 : 
public Employee(string name, int age, int id, float pay) 
二 
if (name.Length > 15) 
Console.Writeline("Error! Name must be less than 16 characters!"); 


else 
empName = name; 


empID = id; 
empAge = age; 
currPay = pay; 


我 相信 你 能 看 出 这 种 方法 的 问题 所 在 。Name 属 性 和 主 构造 函数 执行 了 相同 的 错误 检查 ! 如 果 对 其 
他 数据 点 也 执行 这 样 的 检查 ,将 产生 大 量 的 重复 代码 。 为 了 简化 代码 ， 并 把 所 有 的 错误 检查 隔离 到 一 
个 中 心 位 置 ， 可 以 一 直 在 类 中 使 用 属性 ， 不 管 你 何 时 需要 获取 或 设置 属性 的 值 。 考 虑 如 下 修改 后 的 构 
造 函 数 : 
Employee(string name, int age, int id，float pay) 
// 更 好 一 些 ! 在 设置 类 数据 的 时 候 使 用 属性 ， 减 少 了 重复 的 错误 检查 
Name = name; 
Age = age; 
ID = id; 
} Pay = pay; 


除了 更 新 构造 函数 使 用 属性 分 配 值 外 ,在 整个 类 实现 中 一 直 使 用 属性 也 是 不 错 的 做 法 ， 这 可 以 确 
保 业 务 规则 总 是 被 强制 检查 。 在 多 数 情况 下 ， 唯 一 需要 直接 使 用 私有 数据 的 情况 是 在 属性 内 部 。 考 虑 
到 这 一 点 ， 用 如 下 的 代码 更 新 Employee 类 


class Employee 


// 字段 数据 
private string empName; 
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private int empID; 
private float currPay; 
private int empAge; 


// 构造 函数 

public Employee() { } 

public Employee(string name, int id，float pay) 
:this(name, 0, id, pay){} 

public Employee(string name, int age, int id, float pay) 

{ 


Name = name; 


Age = age; 

ID = id; 

Pay = pay; 
// 方法 





public void GiveBonus(float amount) 
{ Pay += amount; } 


public void Displaystats() 
Console.WriteLine("Name: {0}", Name); 
Console.WriteLine("ID: {0}", ID); 
Console.WritelLine("Age: {0}", Age); 
Console.WriteLine("Pay: {0}", Pay); 
} 


// 和 前 面 例子 一 样 的 属性 


5.7.4 ”只 读 和 只 写 属性 


当 封 装 数据 时 ， 可 能 希望 配置 一 个 只 读 属性 。 为 此 ， 可 以 忽略 set 块 。 类 似 地 ， 如 果 想 拥有 一 个 
只 写 属 性 ， 就 忽略 get 语 句 块 。 在 这 个 例子 中 我 们 没有 必要 这 样 做 ， 下面 的 代码 说 明了 
SocialSecurityNumber 属 性 ( 封装 一 个 私有 的 字符 串 变量 empsSN ) 是 怎样 被 转换 为 只 读 的 : 


public string SocialSecurityNumber 
get { return empSSN; } 
有 了 这 个 调整 ， 设 置 雇员 社会 安全 号 码 ( SSN ) 的 唯一 方式 就 是 通过 构造 函数 参数 。 而 如 果 试 图 
在 主 构造 函数 中 设置 雇员 的 社会 安全 号 码 ， 将 会 收 到 编译 器 错误 ， 因 为 该 属性 只 读 
public Employee(string name, int age, int id, float pay, string ssn) 


Name = name; 


Age = age; 
ID = id; 
Pay = pay; 


// 啊 ， 如 果 属 性 是 只 读 的 ， 这 样 就 不 行 了 
SocialSecurityNumber = ssn; 
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除非 重新 设计 属性 的 值 ， 否 则 就 只 能 按照 如 下 方式 使 用 构造 函数 逻辑 中 的 empSSN 成 员 变 量 了 : 


public Employee(string name, int age, int id, float pay, string ssn) 


empSSN = ssn; 


本 节 内 容 到 此 就 结束 了 , 请 记 住 C# 俩 向 于 用 属性 来 封装 数据 。 这 些 句 法 实体 的 目的 和 传统 的 访问 
方法 和 修改 方法 相同 。 属 性 的 好 处 是 ， 对 象 的 使 用 者 可 以 使 用 单个 命名 的 项 来 控制 内 部 数据 点 。 


源 代码 ”EmployeeApp 项 目的 源 代码 位 于 Chapter 5 子 目录 下 。 


5.7.5 ”静态 属性 


回想 一 下 本 章 前 面 介绍 的 static 关 键 字 的 作用 ,现在 你 应 该 知道 使 用 C# 属 性 语法 的 原因 了 ,我 们 
可 以 形式 化 静态 属性 。 在 StaticDataAndMembers 项 目 中 ， SavingsAccount 类 有 两 个 公共 的 静态 属性 , 分 
别 用 于 获取 和 设置 利率 。 但 更 标准 的 做 法 是 将 该 数据 点 封装 在 一 个 属性 中 。 这 样 的 话 ， 即 使 没有 分 别 
获取 和 设置 利率 的 方法 ,你 也 可 以 定义 下 面 的 类 属性 ( 注意 static 关 键 字 的 用 法 ): 

// 简 单 的 储 著 账 户 类 


class SavingsAccount 


// 实 例 级 别 的 数据 
public double currBalance; 


// 静 态 数据 点 
private static double currInterestRate = 0.04; 


// 静 态 属 性 
public static double InterestRate 
{ 


get { return currInterestRate; } 
set { currInterestRate = value; } 
这 
如 果 你 想 使 用 这 个 属性 ， 而 不 用 之 前 的 两 个 静态 方法 ， 可 以 按照 如 下 方式 更 新 Main() 方 法 : 


// 通 过 属性 输出 当前 利率 
Console.WritelLine("Interest Rate is: {0}", SavingsAccount.InterestRate); 


5.8 自动 属性 
在 创建 属性 封装 数据 的 过 程 中 ， 大 多 数 C# 属 性 都 在 set 作 用 域 中 包含 业务 逻辑 。 但 有 时 候 你 可 能 


只 需要 简单 的 获取 和 设置 值 ， 而 不 需要 任何 实现 逻辑 。 这 意味 你 能 够 以 如 下 所 示 的 代码 结尾 : 


// 使 用 标准 属性 语法 的 Car 类 型 
class Car 
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private string carName = ""; 
public string PetName 


get { return carName; } 
set { carName = value; } 


} 

在 这 种 情况 下 ， 多 次 定义 私有 返回 字段 和 简单 属性 就 显得 十 分 累 袭 了。 例如， 你 正在 创建 一 个 需 
要 15 个 和 有 字段 数据 点 的 类 ， 你 编写 了 15 个 相关 的 属性 ， 而 它们 仅仅 对 封装 服务 做 了 简单 的 包装 。 

要 简化 封装 字段 数据 的 过 程 ， 可 以 使 用 自动 属性 语法 。 顾 名 思 义 ， 该 特性 使 用 一 种 新 的 语法 ， 为 
编译 器 减轻 了 定义 私有 返回 字段 和 相关 C# 属 性 成 员 的 工作 。 考 虑 下 面 对 于 Car 类 的 改造 ， 我 们 使 用 这 
种 语法 快速 创建 了 3 个 属性 : 

class Car 

A ee 

public string PetName { get; set; } 


public int Speed { get; set; } 
public string Color { get; set; } 


说 明 Visual Studio 提 供 了 prop 代 码 段 。 输 入 prop 并 按 下 Tab 键 两 次 ，IDE 将 为 一 个 新 的 自动 属性 生成 
一 段 开始 代码 ! 你 还 可 以 在 定义 的 各 个 部 分 使 用 Tab 键 来 添加 细节 ， 赶 紧 动 手 试 试 吧 | 


在 定义 自动 属性 时 ， 只 指定 访问 修饰 符 、 实 际 的 数据 类 型 、 属 性 名 称 和 空 的 get/set 作 用 域 。 在 编 
译 时 ， 编 译 器 为 类 型 自动 生成 了 私有 返回 字段 和 适当 的 get/set 实 现 逻辑 。 


说 明 自动 生成 的 私有 返回 字段 的 名 称 在 你 的 C# 代 码 库 中 是 不 可 见 的 。 查 看 它 的 唯一 方法 是 使 用 
ildasm.exe 这 样 的 工具 。 


但 与 传统 的 C# 属 性 不 同 的 是 , 不 允许 构建 只 读 或 只 写 的 自动 属性 。 也 许 你 会 认为 像 下 面 那样 仅仅 
忽略 属性 声明 中 的 get; 或 set; 就 可 以 了 : 

// 只 读 属性 ? 错误 

public int MyReadOnlyProp { get; } 


// 只 写 属性 ? 错误 
public int MyWriteOnlyProp { set; } 


而 这 将 导致 编译 器 错误 。 自 动 属性 在 定义 时 必须 同时 支持 读 写 功能 。 但是， 定义 更 严格 的 get 或 
set 是 可 以 的 : 


// 自动 属性 必须 同时 可 以 读 写 
public string PetName { get; set; } 
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5.8.1 与 自动 属性 交互 


由 于 编译 器 在 编译 时 才 会 定义 私有 的 返回 字段 , 所 以 定义 自动 属性 的 类 通常 都 需要 使 用 属性 语法 
来 获取 和 设置 实际 的 值 。 注 意 到 这 一 点 是 很 重要 的 ， 因 为 很 多 程序 员 在 类 定义 的 内 部 直接 使 用 私有 字 
段 ， 而 这 在 这 种 情况 下 是 行 不 通 的 。 例 如 ， 如 果 Car 类 提供 了 Displaystats() 方 法 ,实现 该 方法 时 需要 
使 用 属性 名 称 : 


class Car 


// 自动 属性 

public string PetName { get; set; } 
public int Speed { get; set; } 
public string Color { get; set; } 


public void Displaystats() 
{ 


Console.WriteLine("Car Name: {0}", PetName); 
Console.WriteLine("Speed: {0}", Speed); 
Console.WriteLine("Color: {0}", Color); 


} 
在 使 用 定义 了 自动 属性 的 对 象 时 ， 可 以 用 属性 语法 来 设置 和 获取 值 : 
static void Main(string[] args) 

Console.WritelLine("***** Fun with Automatic Properties *****\n"); 


Car C = new Car(); 
c.PetName = "Frank"; 
c.9peed = 55; 
c.Color = "Red"; 


Console.WriteLine("Your car is named {0}? That's odd...", 
c.PetName); 
c.DisplayStats(); 


Console.ReadLine(); 


} 


5.8.2 ”关于 自动 属性 和 默认 值 


你 可 以 直接 在 代码 库 中 使 用 封装 了 数字 或 布尔 数据 的 自动 属性 ,因为 隐藏 的 返回 字段 将 设置 一 个 
可 以 直接 使 用 的 安全 的 默认 值 。 但 如 果 自 动 属性 包装 了 另 一 个 类 变量 ,隐藏 的 私有 引用 类 型 的 默认 值 
也 将 设置 为 nul1。 

考虑 下 面 新 的 Garage 类 ， 它 使 用 了 两 个 自动 属性 〈 当然 真实 的 车 库 类 会 维护 Car 对 象 的 集合 ， 目 前 
我 们 先 忽略 这 一 细节 ) : 


class Garage 


// 隐藏 的 jnt 返 回 字 段 设置 为 0 
public int NumberOfCars { get; set; } 


// 隐藏 的 Car 返 回 字段 设置 为 null 
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public Car MyAuto { get; set; } 


由 于 C# 会 为 字段 数据 提供 默认 值 ， 你 能 知道 Numberofcars 的 值 ( 自动 设置 为 0 ) , 但 当 你 直接 调用 
MyAuto 时 ， 将 在 运行 时 得 到 “ 空 引用 异常 ”。 这 是 因为 没有 为 后 台 使 用 的 Car 成 员 变 量 设置 新 的 对 象 : 


static void Main(string[] args) 


Garage 8 = new Garage(); 


// 打印 默认 值 0 
Console.WTiteLine("Number of Cars: {0}", g.NumberOfCars); 


// 运行 时 错误 | 返回 字段 现在 为 null " 
Console.WritelLine(g.MyAuto.PetName); 
Console.ReadLine(); 
} 
由 于 私有 的 返回 字段 是 在 编译 时 创建 的 ， 所 以 你 不 能 使 用 C# 的 字段 初始 化 语法 用 new 关 键 字 直接 
分 配 引用 类 型 。 这 项 工作 必须 在 类 构造 函数 内 部 执行 ， 以 确保 对 象 以 安全 的 方式 诞生 。 例 如 : 


class Garage 


// 隐藏 的 返回 字段 设置 为 0 
public int NumberOfCars { get; set; } 


// 隐藏 的 返回 字段 设置 为 nul1 
public Car MyAuto { get; set; } 


// 必须 使 用 构造 函数 重 写 分 配给 隐藏 返回 字段 的 默认 值 
public Garage() 


MyAuto = new Car(); 
NumberOfCars = 1; 


ublic Garage(Car car, int number) 


n= 和 


MyAuto = car; 
NumberOfCars = number; 


3 
更 新 之 后 ， 就 可 以 像 下 面 这 样 将 Car 对 象 传 人 Garage 对 象 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Automatic Properties *****\n"); 


// 创建 一 个 汽车 

Car c = new Car(); 
Cc.PetName = "Frank"; 
Cc.Speed = 55; 
Cc.Color = "Red"; 
c.DisplayStats(); 


// 将 汽车 放 入 车 库 中 

Garage 8 = new Garage(); 

g-MyAuto = c; 

Console.WriteLine("Number of Cars in garage: {0}", g.NumberOfCars); 
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Console.WriteLine("Your car is named: {0}", g.MyAuto.PetName); 


Console.ReadLine(); 


这 是 C# 编 程 语言 中 非常 好 的 特性 ,你 可 以 使 用 这 种 简单 的 语法 在 类 中 定义 大 量 属性 。 当 然 , 如 果 
属性 除了 获取 和 设置 实际 的 私有 字段 外 ， 还 需要 额外 的 代码 (如 数据 验证 逻辑 、 编 写 事件 日 志 、 与 数 
据 库 通信 等 ) ， 你 就 需要 手工 定义 “普通 的 ”.NET 属 性 。C# 自 动 属 性 只 能 对 ( 编译 器 生成 的 ) 私有 数 
据 进行 简单 的 封装 。 


源 代 码 ”AutoProps 项 目的 源 代 码 位 于 Chapter 5 子 目 录 下 。 


5.9 对象 初始 化 语法 


在 本 章 前 面 的 内 容 中 ， 在 新 建 对 象 时 可 以 通过 构造 函数 指定 一 些 初始 值 。 而 属性 允许 我 们 安全 地 
获取 或 设置 实际 的 数据 。 当 你 使 用 其 他 人 设计 的 类 时 ,包括 使 用 .NET 基 础 类 库 中 的 类 时 ,你 往往 会 发 
现 没 有 一 个 构造 隐 数 允许 我 们 设置 所 有 的 状态 数据 。 因此 , 程序 员 常 常 被 迫 去 挑选 最 合适 的 构造 函数 ， 
然后 再 使 用 所 提供 的 一 些 属性 赋值 。 

为 了 简化 新 建 对 象 的 过 程 ，C# 提 供 了 对 象 初始 化 语法 。 使 用 这 项 技术 ,只 用 少量 代码 就 可 以 创建 
对 象 并 设置 一 些 属性 和 公共 字段 。 在 语法 上 ， 对象 初始 化 器 的 组 成 为 : 大 括号 内 部 用 逗号 分 隔 的 指定 
值 列表 。 初 始 化 列表 中 的 每 个 成 员 都 映射 为 正在 初始 化 的 对 象 中 公共 字段 或 公共 属性 的 名 称 。 

为 了 查看 该 语法 的 实际 情况 ， 我 们 新 建 一 个 Console Application， 取 名 为 ObjectInitializers。 现 在 ， 
考虑 下 面 的 用 自动 属性 创建 的 简单 类 Point ( 在 本 例 中 ， 使 用 自动 属性 并 不 是 必需 的 ， 但 它 能 使 我 们 
的 代码 更 简洁 ) : 

class Point 

public int X { get; set; } 
public int Y { get; set; } 


public Point(int xVal, int yVal) 
{ 


we Point() { } 

public void DisplayStats() 

Console.WriteLine("[{0}, {1}]", X, Y); 
人 } 
现在 ,考虑 下 面 的 创建 Point 对 象 的 方法 : 
static void Main(string[] args) 


Console.WriteLine("***** Fun with Object Init Syntax *****\n"); 
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// 通过 手动 设置 各 个 属性 来 创建 Point 
Point firstPoint = new Point(); 
firstPoint.X = 10; 

firstPoint.Y = 10; 
firstPoint.DisplaySstats(); 


// 或 通过 自 定义 构造 函数 创建 Point 
Point anotherPoint = new Point(20, 20); 
anotherPoint.DisplayStats(); 


// 或 使 用 对 象 初始 化 语法 创建 Point 

Point finalPoint = new Point { X = 30, Y = 30 }; 
finalPoint.DisplayStats(); 

Console.ReadLine(); 


最 后 一 个 point 变量 没有 像 以 前 那样 使 用 自 定义 构造 函数 , 但 仍然 可 以 对 公共 的 X、Y 属 性 赋值 。 在 
后 人 台 调 用 的 是 类 型 的 默认 构造 函数 ,然后 再 给 指定 的 属性 赋值 。 因 此 ， 对 象 初始 化 语法 只 是 使 用 默认 
构造 函数 创建 类 变量 并 设置 各 个 属性 状态 数据 的 语法 的 简写 形式 。 


使 用 初始 化 语法 调用 自 定义 构造 函数 
前 面 示例 中 初始 化 的 point 类 型 隐 式 地 调用 了 类 型 的 默认 构造 函数 


// 这 里 隐 式 地 调用 了 默认 构造 函数 
Point finalPoint = new Point { X = 30, Y = 30 }; 


如 果 你 想 看 得 更 清楚 一 点 ， 也 可 以 显 式 地 调用 默认 构造 函数 : 


// 这 里 显 式 地 调用 了 默认 构造 函数 
Point finalPoint = new Point() { X = 30, Y = 30 }; 
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要 知道 ， 在 使 用 初始 化 语法 构建 类 型 时 ， 可 以 调用 类 定义 的 任意 构造 函数 。 我 们 的 Point 类 型 当 


// 调用 自 定义 构造 涵 数 
Point pt = new Point(10, 16) { X = 100, Y = 100 }; 


前 定义 了 包含 两 个 参数 的 构造 函数 ， 用 来 设置 (YX，Y) 坐 标 。 因 此 ， 下 面 Point 声 明 的 结果 是 Xx 和 Y 的 值 都 
是 100， 而 不 是 构造 函数 参数 所 指定 的 10 和 16: 


对 于 当前 Point 类 型 的 定义 ,使 用 初始 化 语法 调用 自 定义 构造 函数 除了 增加 一 些 宛 余 代 码 外 没有 


public enum PointColor 
{ LightBlue, BloodRed, Gold } 


class Point 


public int X { get; set; } 

public int Y { get; set; } 

public PointColor Color{ get; set; } 
public Point(int xVal, int yVal) 


X = xVal; 


任何 好 处 。 但 是 ， 如 果 Point 类 型 提供 了 一 个 新 的 构造 函数 ， 人 允许 调用 者 设置 颜色 (通过 自 定义 的 
PointColor 枚 举 ), 那么 这 种 自 定义 构造 函数 和 对 象 初始 化 语法 的 组 合 就 显得 十 分 清晰 了 。 假设 修改 后 
的 Point 如 下 : 
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Y = yVal; 
Color = PointColor.Gold; 


public Point(PointColor ptColor) 


Color = ptColor; 
public Point() 

: this(PointColor.BloodRed){ } 
public void DisplayStats() 


Console.WriteLine("[{0}, {1}]", xX, Y); 
Console.WriteLine("Point is {0}", Color); 


} 
使 用 这 个 新 的 构造 函数 ， 可 以 创建 一 个 金色 的 点 (位置 在 (90, 20) ) : 
// 使 用 初始 化 语法 调用 自 定义 构造 函数 


Point goldPoint = new Point(PointColor.Gold){ X = 90, Y = 20 }; 
Console.WriteLine("Value of Point is: {0}", goldPoint.DisplayStats()); 


5.9.2 ”初始 化 内 部 类 型 


本 章 前 面 简单 提 到 了 ( 将 在 第 6 章 中 全 面 介绍 ) 包含 ( has-a ) 关系 允许 我 们 通过 定义 已 知 类 的 成 员 
变量 来 组 合 新 类 。 例 如 ,假设 你 有 Rectangle 类 ， 这 个 类 使 用 Point 类 型 来 表示 左上 角 和 右 下 角 的 坐标 。 
由 于 自动 属性 将 所 有 的 内 部 类 变量 设置 为 nul1， 所 以 你 需要 用 “传统 的 ”属性 语法 来 实现 这 个 新 类 : 


class Rectangle 


private Point topLeft = new Point(); 
private Point bottomRight = new Point(); 


public Point TopLeft 


get { return topLeft; } 
set { topLeft = value; } 


} 
public Point BottomRight 
{ 
get { return bottomRight; } 
set { bottomRight = value; } 
public void DisplayStats() 
{ 
Console.WriteLine("[TopLeft: {0}, {1}, {2} BottomRight: {3}, {4}, {5}]", 


topLeft.X, topLeft.Y, topLeft.Color, 
bottomRight.X, bottomRight.Y, bottomRight.Color); 


} 
使 用 对 象 初始 化 语法 ， 可 以 像 下 面 这 样 新 建 Rectangle 变 量 并 设置 内 部 point: 


// 创建 并 初始 化 Rectangle 
Rectangle myRect = new Rectangle 
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TopLeft = new Point { X 

BottomRight = new Point 

对 象 初始 化 语法 的 好 处 是 ， 从 根本 上 减少 了 键盘 获 击 的 次 数 (假设 没有 合适 的 构造 函数 )。 传 统 
的 建立 Rectangle 的 方法 如 下 : 


// 旧 的 方法 

Rectangle r = new Rectangle(); 
Point p1 = new Point(); 

p1.X = 10; 

p1.Y = 10; 

r.TopLeft = pi1; 

Point p2 = new Point(); 

p2.X = 200; 

p2.Y = 200; 

IT.BottomRight = p2; 


你 可 能 会 不 太 习 惯 这 种 对 象 初始 化 语法 , 但 一 旦 习惯 之 后 ,你 将 对 这 种 快速 无 扰 的 新 建 对 象 状态 
的 方式 感到 十 分 欣慰 。 

在 本 章 最 后 ， 我 将 介绍 3 个 较 小 的 话题 一 一 常量 数据 、 只 读 字段 和 分 部 类 定义 ， 它 们 将 使 你 更 好 
地 了 解 如 何 构建 封装 良好 的 类 。 


= 10，Y 
{三 2 


源 代码 ”ObjectInitializers 项 目的 源 代 码 位 于 Chapter 5 子 目 录 下 。 


5.10 常量 数据 

C# 提 供 了 const 关 键 字 来 定义 常量 ( 它 在 赋 初 始 值 后 从 未 变 过 )。 你 可 能 会 猜 到 ， 如 果 我 们 要 为 应 
用 程序 定义 逻辑 上 和 某 个 类 或 结构 相关 的 一 组 已 知 值 的 话 ， 就 非常 有 用 。 

假设 我 们 正在 构建 一 个 叫 MyMathClass 的 工具 类 , 并 且 需 要 定义 一 个 PI 值 (假设 是 3.14 )。 先 新 建 一 
个 叫 ConstData 的 控制 台 应 用 程序 。 如 果 不 希望 其 他 开发 人 员 改 变 代码 中 的 这 个 值 , 可 以 使 用 如 下 常量 
来 定义 PI: 

namespace ConstData 

class MyMathClass 


public const double PI = 3.14; 


class Program 
static void Main(string[] args) 
Console.WriteLine("***** Fun with Const *****\n"); 
Console.WriteLine("The value of PI is: {0}", MyMathClass.PI); 
// 错误 ! 不 能 改变 常量 
// MyMathClass.PI = 3.1444; 


Console.ReadLine(); 
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注意 ,我 们 使 用 类 名 前 级 ( 即 MyMathClass.PI ) 引用 MyMathClass 定 义 的 常量 数据 。 这 是 因为 类 的 
常量 字段 是 隐 式 静态 的 。 然 而 ， 我 们 可 以 在 类 型 成 员 中 定义 和 访问 局 部 常量 。 例 如 : 


static void LocalConstStringVariable() 


// 局 部 常量 可 以 被 直接 访问 
const string fixedStr = "Fixed string Data"; 
Console.WritelLine(fixedStr); 


// 错误 
fixedstr = "This will not work!"; 
不 管 在 哪里 定义 常量 ， 有 一 点 我 们 需要 记 住 ， 定义 常量 时 必须 为 常量 指定 初始 值 。 因 此 ， 如 果 按 
如 下 代码 修改 MyMathClass， 在 类 构造 函数 中 为 PI 的 值 进行 赋值 : 
class MyMathClass 


{ 
// 尝试 在 构造 函数 中 设置 PI 
public const double PI; 


public MyMathClass() 


// 错误 
PI = 3.14; 


} 

我 们 将 会 收 到 编译 时 错误 。 有 这 种 限制 是 因为 在 编译 时 必须 知道 常量 的 值 。 我 们 知道 , 构造 函数 
是 在 运行 时 调用 的 。 
5.10.1 只 读 字段 

和 常量 紧密 联系 的 概念 是 只 读 字 段 数据 (不 要 和 只 读 属性 混淆 )。 和 常量 相似 ， 只 读 字段 不 能 在 
赋 初 始 值 后 改变 。 然 而 ， 和 常量 不 同 的 是 ， 赋 给 只 读 字段 的 值 可 以 在 运行 时 决定 ， 因 此 在 构造 函数 作 
用 域 中 进行 赋值 是 合法 的 〈 其 他 地 方 不 行 )。 

如 果 直 到 运行 时 才 知 道 字段 值 ( 可 能 我 们 需要 读 取 外 部 文件 来 获得 值 )， 并且 希 望 之 后 值 不 会 被 
改变 ， 那么 上 面 的 做 法 就 很 有 用 。 假 设 按 如 下 代码 更 新 MyMathClass: 

class MyMathClass 


// 可 以 在 构造 函数 中 为 只 读 字段 轩 值 ， 其 他 地 方 不 行 
public readonly double PI; 


public MyMathClass () 
{ 
PI = 3.14; 


} 
同样 ， 在 构造 函数 作用 域 之 外 用 readonly 为 字段 赋值 的 任何 尝试 都 会 导致 编译 器 错误 : 
人 MyMathClass 


public readonly double PI; 
public MyMathClass () 
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PI = 3.14; 


// 错误 
public void ChangePI() 
{ PI = 3.14444;} 


5.10.2 静态 只 读 字 段 

和 常量 字段 不 同 ， 只 读 字段 不 是 隐 式 静态 的 。 因 此 ， 如 果 要 从 类 级 别 公 开 PI， 就 必须 显 式 使 用 
static 关 键 字 。 如 果 在 编译 时 已 经 知道 静态 只 读 字段 的 值 , 那么 它 的 初始 赋值 方式 将 和 常量 字段 非常 
相似 : 


class MyMathClass 





public static readonly double PI = 3.14; 


class Program 


static void Main(string[] args) 


{ 


Console.WriteLine("***** Fun with Const *****"); 
Console.WriteLine("The value of PI is: {0}", MyMathClass.PI); 
Console.ReadLine(); 


} 
但 是 ， 如 果 直 到 运行 时 才 知 道 静 态 只 读 字 段 的 值 ， 就 必须 使 用 本 章 前 面 描述 过 的 静态 构造 函数 。 
class MyMathClass 

public static readonly double PI; 

static MyMathClass() 


{ PI = 314; } 
} 


源 代码 ”ConstData 项 目的 源 代码 位 于 Chapter 5 子 目录 下 。 


5.11 分 部 类 型 


最 后 ， 理 解 C# 中 partial 关 键 字 的 作用 也 是 很 重要 的 。 一 个 产品 级 别 的 类 很 容易 就 会 达到 成 百 上 
千 行 代码 。 而 一 个 类 常常 定义 在 单个 *.cs 文 件 中 ， 这 就 将 导致 代码 文件 非常 长 。 而 在 创建 类 时 ， 大 多 
数 代码 在 确立 之 后 基本 上 就 可 以 忽略 不 计 。 例如, 字段 数据 、 属 性 和 构造 函数 在 生产 过 程 中 很 少 变动 ， 
而 方法 却 需 要 经 常 修改 。 

如 果 愿 意 , 你 可 以 将 一 个 类 分 布 到 多 个 C# 文 件 中 ,这 样 可 以 从 样板 代码 中 分 离 出 有 用 的 成 员 。 为 
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了 演示 这 一 点 , 在 Visual Studio 中 打开 本 章 前 面 创建 的 EmployeeApp 项 目 , 打开 Employee.cs 文 件 。 当 前 
该 文件 包含 的 是 该 类 所 有 部 分 的 代码 : 
class Employee 
// 字段 数据 
// 构造 隙 数 
// 方法 
// 属性 
使 用 分 部 类 将 构造 函数 和 字段 数据 转移 到 全 新 的 Employee.Internal.cs 文 件 中 ( 请 注意 ， 文 件 名 可 
以 随意 起 , 我 在 这 里 使 用 Internal 是 想 表示 类 的 内 部 )。 第 一 步 是 向 当前 的 类 定义 中 添加 partial 关 键 字 ， 
再 剪 切 要 转移 到 新 文件 中 的 代码 : 


// Employee.cs 
partial class Employee 


// 方法 
// 属性 
} 
然后 ,假设 已 经 在 项 目 中 插入 了 新 的 类 文件 ， 将 数据 字段 和 构造 函数 粘贴 到 新 文件 中 。 此 外 ,还 
必须 在 类 定义 中 添加 partial 关 键 字 。 例 如 : 


// Employee.Internal.cs 
partial class Employee 


{ 
// 字段 数据 
} // 构造 函数 


说 明 记 住 ! 分 部 类 的 每 个 部 分 都 必须 用 partial 关 键 字 标记 。 


编译 这 个 修改 后 的 项 目 ， 你 会 发 现 一 切 都 没有 变化 。 分 部 类 的 整个 理念 都 是 在 设计 时 实现 的 。 编 
译 应 用 程序 后 ， 程 序 集中 只 存在 唯一 的 类 。 定 义 分 部 类 唯一 的 要 求 是 类 型 名 称 ( 本 例 中 为 Employee ) 
必须 相同 ， 并 且 必 须 定义 在 相同 的 .NET 命 名 空间 中 。 

实际 上 ， 你 没有 必要 频繁 地 使 用 分 部 类 。 但 Visual Studio 却 总 是 在 后 台 使 用 它们 。 在 本 书后 面 开 
始 使 用 WPF 或 ASPNET 等 研究 GUI 应 用 程序 开发 时 , 你 会 发 现 Visual Studio 将 设计 器 生成 的 代码 隔离 到 
分 部 类 中 ， 而 你 只 需要 关注 应 用 中 特定 的 程序 逻辑 。 


源 代码 ”EmployeeAppPartial 项 目的 源 代码 位 于 Chapter 5 子 目 录 下 。 


5.12 ”小结 


本 章 的 宗旨 是 介绍 C# 类 类 型 的 作用 。 我 们 看 到 , 类 可 以 接受 任意 构造 函数 来 允许 对 象 用户 在 创建 
对 象 时 创建 状态 。 本 章 还 演示 了 几 个 类 设计 技术 (以 及 相关 关键 字 )。 回 忆 一 下 ，this 关 键 字 可 以 用 
于 访问 当前 对 象 ，static 关 键 字 可 以 用 于 在 类 ( 不 是 对 象 ) 级 别 定义 字段 和 成 员 ， 而 const 关 键 字 ( 以 
及 readonly 修 饰 符 ) 可 以 用 来 定义 在 赋 初 始 值 之 后 永远 不 能 改变 的 数据 点 。 

本 章 大 部 分 笔墨 花 在 了 OOP 第 一 个 支柱 的 细节 : 封装 。 在 这 里 我 们 学 习 了 C# 的 访问 修饰 符 以 及 类 
型 属性 、 对 和 象 初始 化 语法 以 及 分 部 类 的 作用 。 有 了 这 些 , 我 们 现在 就 可 以 转 到 下 一 章 来 学 习 使 用 继承 
和 多 态 构建 一 组 相关 类 。 
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和 代打 5 章 研 究 了 OOP 的 第 一 个 支柱 一 一 封装 , 并 探讨 了 如 何 使 用 构造 函数 和 各 种 成 员 ( 构造 函数 、 
字段 、 属 性 、 方 法 、 常 量 、 只 读 字段 等 ) 来 构建 一 个 定义 明确 的 类 类 型 。 本 章 会 关注 OOP 
其 余 两 个 支柱 : 继承 和 多 态 。 
首先 ， 我 们 会 学 习 如 何 使 用 继承 来 构建 一 组 相关 类 。 我 们 会 看 到 ， 这 种 形式 的 代码 重用 人 允许 我 们 
在 父 类 中 定义 通用 功能 ， 并 且 这 种 功能 可 以 被 子 类 所 使 用 (或 者 改变 )。 然 后 ， 我 们 会 学 习 如 何 使 用 
虚 成 员 和 抽象 成 员 在 类 层次 结构 中 创建 多 态 接口 。 最 后 介绍 .NET 基 础 类 库 中 超级 父 类 System.0bject 
的 作用 。 


6.1 继承 的 基本 机 制 


第 5 章 介绍 过 ， 继 承 是 OOP 的 一 个 方面 ， 可 以 促进 代码 重用 。 更 具体 地 说 ， 代 码 重用 归 为 两 类 : 
继承 (“is-a” 关 系 ) 和 包含 /委托 模型 (“has-a” 关 系 )。 让 我 们 通过 研究 经 典 的 “is-a” 继 承 模型 来 开 
始 本 章 。 

在 类 之 间 创 建 “is-a” 关 系 ， 也 就 在 两 个 或 两 个 以 上 类 类 型 之 间 构 建 了 依赖 关系 。 经 典 继承 的 基 
本 思想 是 新 的 类 可 以 利用 既 有 类 的 功能 。 让 我 们 新 建 一 个 控制 台 应 用 程序 BasicInheritance 来 开始 非常 
简单 的 示例 。 假 设 我 们 已 经 设计 了 一 个 简单 类 Car 来 模拟 汽车 的 基本 细节 : 


// 简单 的 基 类 
class Car 


{ 
public readonly int maxSpeed; 
private int currSpeed; 
public Car(int max) 
maxSpeed = max; 


public Car() 
1 


maxSpeed = 55; 


public int Speed 


get { return currSpeed; } 
set 


{ 
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currSpeed = value; 
if (currSpeed > maxSpeed) 


currSpeed = maxSpeed; 


} 
} 
} 


注意 ，Car 类 利用 了 封装 服务 ， 使 用 公共 属性 Speed 来 控制 对 currSpeed 私 有 字段 的 访问 。 现 在 可 以 
编写 Car 类 型 ， 如 下 所 示 : 
static void Main(string[] args) 
Console.WritelLine("***** Basic Inheritance *****\n"); 


// 创建 一 个 Car 对 象 并 设置 最 大 速度 
Car myCar = new Car(80); 


// 设置 当前 速度 并 输出 
myCar.Speed = 50; 


Console.WritelLine("My car is going {0} MPH", myCar.Speed); 
Console.ReadLine(); 


6.1.1 指定 既 有 类 的 父 类 


现在 假设 要 构建 一 个 新 类 Minivan。 和 基本 的 Car 相 似 ， 我 们 希望 定义 Minivan 类 支持 最 大 速度 、 当 
前 速度 以 及 允许 对 象 用 户 修改 对 象 状 态 的 Speed 属性 。 显 然 ，Car 和 Minivan 类 是 关联 的 ， 其 实 我 们 可 以 
说 Minivan “is-a”( 是 一 个 ) Car。“is-a” 关 系 (正式 的 术语 是 经 典 继承 ) 允许 我 们 构建 新 的 类 定义 ， 
扩展 既 有 类 的 功能 。 

作为 新 类 基础 的 既 有 类 叫做 基 类 或 父 类 。 基 类 的 作用 是 为 扩展 它 的 类 定义 所 有 公共 数据 以 及 成 
员 。 扩 展 类 叫做 派生 类 或 子 类 。 在 C# 中 ,我 们 在 类 定义 中 利用 冒号 操作 符 在 类 之 间 创 建 “is-a” 关 系 。 
假设 你 创建 了 下 面 的 MiniVan 类 : 


// MiniVan 是 一 个 Car 
class MiniVan : Car 


} 
但 该 新 类 当前 没有 定义 任何 成 员 。 那 么 ， 我 们 从 Car 基 类 扩展 出 的 Minivan 获 得 了 什么 呢 ? 简 而 言 
之 ，MiniVan 对 象 现在 拥有 定义 在 父 类 中 的 每 一 个 公共 成 员 的 访问 权限 。 


说 明 虽然 构造 函数 一 般 定 义 为 公共 的 ， 但 派生 类 从 来 没有 继承 父 类 的 构造 函数 。 构 造 函 数 仅仅 用 
于 在 内 部 定义 的 类 。 


有 了 两 个 类 类 型 之 间 的 这 种 关系 ， 我 们 现在 就 可 以 这 样 使 用 MiniVan 类 了 : 
static void Main(string[] args) 


Console.Writeline("***** Basic Inheritance *****\n"); 


170 第 6 章 继承 和 多 态 


// 创建 MiniVan 对 象 

MiniVan myVan = new MiniVan(); 

myVan.Speed = 10; 

Console.WriteLine("My van is going {0} MPH", 
myVan. Speed); 

Console.ReadLine(); 


} 

注意 ， 尽 管 我 们 没有 为 Minivan 类 增加 任何 成 员 ， 但 是 我 们 可 以 直接 访问 父 类 的 公共 属性 Speed， 
因此 就 重用 了 代码 。 相 比 创建 一 个 与 car 有 同样 成 员 ( 如 Speed 属性 ) 的 MiniVan 类 来 说 ,这 种 方法 要 好 
得 多 。 如 果 两 个 类 的 代码 完全 一 样 ， 就 需要 维护 两 个 代码 体 ， 这 当然 浪费 时 间 。 

一 定 要 记 住 ,继承 保护 了 封装 。 因 此 下 面 的 代码 将 导致 编译 器 错误 ， 不 能 通过 对 象 引用 来 访问 私 
有 成 员 。 


static void Main(string[] args) 
Console.WritelLine("***** Basic Inheritance *****\n"); 


// 生成 一 个 MiniVan 对 象 

MiniVan myVan = new MiniVan(); 

myVan.Speed = 10; 

Console.WriteLine("My van is going {0} MPH", 
myVan. Speed); 


// 错误 | 不 能 访问 私有 成 员 
myVan.currSpeed = 55; 
Console.ReadLine(); 


} 
还 有 ， 如 果 MiniVan 定 义 了 自己 的 成 员 ， 它 就 不 能 访问 car 基 类 的 任何 私有 成 员 。 此 外 ， 私有 成 员 
只 能 被 定义 它 的 类 访问 。 例 如 ， 下 面 的 MiniVan 中 的 方法 会 导致 编译 器 错误 : 


// MiniVan 类 派生 自 Car 类 
class MiniVan : Car 


public void TestMethod() 


// 正确 ! 可 以 在 派生 类 型 中 访问 父 类 的 公共 成 员 
Speed = 10; 


// 错误 ! 不 能 在 派生 类 型 中 访问 父 类 的 私有 成 员 
currSpeed = 10; 


} 


6.1.2 多 个 基 类 


说 到 基 类 , 要 记 住 很 重要 的 一 点 : C# 要 求 一 个 类 只 能 有 一 个 直接 基 类 。 我 们 不 能 创建 直接 派生 自 两 
个 或 两 个 以 上 基 类 的 类 类 型 [ 这 项 技术 (诸如 非 托 管 C++ 等 其 他 C 系 列 的 语言 所 支持 的 ) 叫做 多 重 继 承 ， 
简写 为 MI ]。 如 果 你 打算 创建 一 个 能 够 指定 两 个 直接 父 类 的 类 , 你 就 会 收 到 编译 器 错误 。 如 下 代码 所 示 : 


// 非法 ! C# 不 允许 类 的 多 重 继承 
class WontWork 
: BaseClassOne, BaseClassTwo 


{} 
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在 第 8 章 中 我 们 会 看 到 ，.NET 平 台 确实 允许 某 一 个 类 ( 或 结构 ) 类 型 实现 许多 独立 的 接口 。 这 样 ， 
C# 类 型 可 以 实现 很 多 行为 ,同时 又 避免 了 多 重 继承 引起 的 复杂 性 。 还 有 ,虽然 一 个 类 只 能 有 一 个 直接 
基 类 , 但 是 一 个 接口 可 以 直接 从 多 个 接口 派生 。 使 用 这 个 技巧 ， 可 以 构建 灵活 的 接口 层次 来 建 模 复杂 
的 行为 (同样 ， 见 第 8 章 )。 


6.1.3 sealed 关键 字 


C# 提 供 了 另外 一 个 关键 字 sealed 来 防止 发 生 继承 。 如 果 我 们 将 类 标记 为 sealed， 编 译 器 将 不 会 允 
许 我 们 从 这 个 类 型 派生 。 例 如 ,假设 我 们 认为 进一步 扩展 MiniVan 类 是 无 意义 的 : 

// MiniVan 类 不 会 被 扩展 

sealed class MiniVan : Car 

} 

如 果 尝 试 从 这 个 类 派生 的 话 ， 就 会 收 到 一 个 编译 时 错误 : 


// 错误 ! 不 能 扩展 用 sealed 关 键 字 标 记 的 类 
class DeluxeMiniVan 
: MiniVan 
{} 
通常 ， 设 计 一 个 工具 类 时 对 类 进行 密封 很 有 意义 。 例 如 ，System 命 名 空间 定义 了 很 多 密封 类 。 可 
以 打开 Visual Studio 的 对 象 浏览 器 ( 通过 View 菜 单 ) 并 且 选 择 定 义 在 mscorlib.d11 程 序 集中 的 System 
命名 空间 的 String 类 来 亲自 验证 。 注 意图 6-1 里 Summary 窗 口中 突出 显示 的 sealed 关 键 字 的 用 法 。 
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图 6-1 基础 类 库 定 义 了 许多 密封 类 型 
因此 ， 和 Minivan 相 似 ， 如 果 尝 试 构建 新 的 类 来 扩展 System.String， 将 会 收 到 一 个 编译 时 错误 : 
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// 另 一 个 错误 | 不 能 扩展 已 经 被 标注 为 Sealed 的 类 
class MyString 

: String 
{} 


说 明 ”在 第 4 章 中 我 们 已 经 知道 ，C# 结 构 总 是 隐 式 密封 的 ( 见 表 4-3 )。 因 此 ， 我们 永远 不 可 以 从 结构 
继承 结构 ， 从 类 继承 结构 或 从 结构 继承 类 。 结 构 只 能 用 于 建 模 独立 的 、 用 户 定义 的 数据 类 型 。 
如 果 希 望 使 用 is-a 关 系 ， 必 须 使 用 类 。 


你 可 能 已 经 猜 到 了 ， 在 本 章 余下 部 分 中 还 会 介绍 更 多 有 关 继 承 的 细节 。 至 此 ， 只 需 记 住 冒 号 操作 
符 用 来 创建 基 类 和 派生 类 的 关系 ， 而 sealed 关 键 字 防止 继承 的 发 生 。 


6.2 回顾 Visual Studio 类 关系 图 


第 2 章 简 单 介绍 过 ，Visual Studio 允许 我 们 在 设计 时 可 视 地 创建 基 类 /派生 类 关系 。 为 了 利用 IDE 的 
这 个 功能 ， 第 一 步 是 在 当前 项 目 中 包含 新 的 类 关系 文件 。 通 过 访问 Project 一 Add New Item 菜 单项 ， 然 
后 选择 Class Diagram 图 标 来 实现 (如 图 6-2 所 示 ， 将 文件 名 ClassDiagraml.cd 重 命名 为 Cars.cd )。 
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图 6-2 ”插入 新 的 类 关系 图 
只 要 单 击 Add 按 钮 ， 就 会 出 现 一 个 空 的 设计 界面 。 要 向 类 设计 器 增加 类 型 ， 只 需要 从 Solution 
Explorer 窗 口 将 每 个 文件 拖 到 界面 上 即 可 。 要 知道 ， 从 可 视 化 设计 器 上 删除 一 个 项 时 ( 选中 它 并 按 
Del 键 ), 不 会 同时 删除 关联 的 源 代 码 , 而 只 是 将 它 从 设计 器 界面 上 移 除 。 当 前 类 的 层次 结构 如 图 6-3 
所 示 。 
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图 6-3 ”Visual Studio 的 可 视 化 设计 器 


说 明 ”作为 一 种 快捷 方式 ,如 果 希 望 将 项 目 中 所 有 当前 类 型 都 添加 到 设计 器 界面 ,只 需要 选择 Solution 
关系 图 ) 按钮 。 


除了 显示 当前 应 用 程序 中 类 型 的 关系 之 外 , 第 2 章 中 我 们 还 使 用 Class Designer Toolbox 和 Class Details 
窗口 创建 过 全 新 的 类 型 并 填充 它们 的 成 员 。 

如 果 你 希望 在 本 书 其 他 部 分 使 用 这 些 可 视 化 工具 , 请 尽管 用 。 然而 , 请 务必 分 析 生 成 的 这 些 代码 ， 
以 便 对 这 些 工具 帮 我 们 做 的 事情 有 足够 的 了 解 。 


源 代码 ”BasicInheritance 项 目的 源 代码 位 于 Chapter 6 子 目录 下 。 


6.3 OOP 的 第 二 个 支柱 : 继承 


既然 已 经 知道 了 继承 的 基本 语法 ， 就 让 我 们 创建 更 复杂 的 示例 来 了 解构 建 类 继承 的 更 多 细节 吧 。 
我 们 会 重用 第 5 章 中 设计 的 Employee 类 。 首 先 ， 创 建 一 个 全 新 的 C# 控 制 台 应 用 程序 Employees。 

然后 ， 单 击 Project 一 Add Existing Item 菜 单项 ， 再 转 到 Employee.cs 和 Employee.Internals.cs 文 件 的 位 置 。 
选择 每 一 个 项 ( 按 住 Ctrl 键 单 击 )， 然 后 单 击 Add 按 钮 。Visual Studio 会 将 每 一 个 文件 复制 到 当前 项 目 。 

在 构建 派生 类 之 前 ， 还 有 一 个 细节 需要 注意 。 由 于 Employee 在 EmployeeApp 项 目 中 被 创建 ， 这 个 
类 就 被 同名 的 .NET 命 名 空间 包装 了 。 第 14 章 会 研究 命名 空间 的 细节 ， 然 而 为 了 简单 ， 我 们 将 当前 命名 
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空间 重 命名 为 Employees ( 两 个 文件 ) 来 匹配 新 的 项 目 名 : 
// 确保 改变 两 个 C# 文 件 中 的 命名 空间 名 
namespace Employees 


partial class Employee 


{sae 
} 


说 明 为 了 全 面 地 检查 程序 ， 需 要 编译 程序 并 按 Ctrl+F5 组 合 键 运行 项 目 。 尽 管 这 时 该 程序 不 会 做 任 
何事 情 ， 但 这 可 以 验证 是 否 会 产生 编译 器 错误 。 


我 们 的 目标 是 创建 一 组 类 来 建 模 公 司 中 的 各 种 员工 类 型 。 假 设 我 们 希望 利用 Employee 类 的 功能 创 
， 建 两 个 新 类 ( SalesPerson 和 Manager )。 我 们 可 以 看 到 SalesPerson 是 一 个 Employee ( Manager 也 一 样 )。 
在 经 典 的 继承 模型 中 , 基 类 ( 如 Employee ) 用 于 定义 所 有 派生 类 型 共有 的 一 般 特 征 。 子 类 ( 如 SalesPerson 
和 Manager ) 通过 增加 特定 的 行为 来 扩展 这 些 一 般 功能 。 

对 于 我 们 的 示例 , 假设 Manager 类 通过 记录 股票 期 权 的 数量 来 扩展 Employee, 而 salesPerson 类 提供 
了 销售 量 。 使 用 下 面 的 自动 属性 插入 定义 了 Manager 类 的 新 的 类 文件 ( Manager.cs ): 

// 经 理 需要 知道 它们 的 股票 期 权 数 量 

class Manager : Employee 


public int StockOptions { get; set; } 


然后 ， 使 用 一 个 合适 的 自动 属性 增加 一 个 新 的 类 文件 ( SalesPerson.cs ) 来 定义 SalesPerson 类 : 


// 销售 人 员 需 要 知道 它们 的 销售 量 
class SalesPerson : Employee 


public int SalesNumber { get; set; } 


现在 已 经 建立 了 一 种 “is-a” 关 系 ，SalesPerson 和 Manager 自 动 继 承 了 Employee 基 类 的 所 有 公共 成 
例如 ， 按 如 下 所 示 更 新 Main() 方 法 : 


// 创建 子 类 对 象 并 访问 基 类 的 功能 
static void Main(string[] args) 
Console.Writeline("***** The Employee Class Hierarchy *****\n"); 
SalesPerson danny = new SalesPerson(); 
danny.Age = 31; 
danny.Name = "Danny"; 
danny.SalesNumber = 50; 
Console.ReadLine(); 


} 


6.3.1 ”使 用 base 关 键 字 控制 基 类 的 创建 


现在 ， 只 能 使 用 免费 的 默认 构造 函数 来 创建 salesPerson 和 Manager ( 见 第 5 章 )。 因 此 ， 假 设 为 
Manager 类 型 新 增 了 有 6 个 参数 的 构造 函数 ， 按 如 下 所 示 进 行 调用 : 


河 
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static void Main(string[] args) 


// 假设 Manager 有 匹配 这 种 签名 的 构造 函数 

// (string fullName, int age, int empID， 

// float currpay, string ssn, int numbOfOpts) 

Manager chucky = new Manager("Chucky", 50, 92, 100000, "333-23-2322", 9000); 
Console.ReadLine(); 


} 
从 参数 列表 可 以 发 现 , 大 多 数 参 数 应 该 保存 在 由 Employee 基 类 定义 的 成 员 变 量 中 。 如 果 要 这 样 做 ， 
就 需要 实现 Manager 类 的 自 定义 构造 函数 : 
public Manager(string fullName, int age, int empID, 
float currpay, string ssn, int numbOfOpts) 


// 这 个 属性 由 Manager 类 来 定义 
StockOptions = numbOfOpts; 


// 使 用 从 父 类 继承 的 属性 来 为 传 入 参数 赋值 
ID = empID; 

Age = age; 

Name = fullName; 

Pay = currPpay; 


// 噢 | 这 会 导致 编译 器 错误 ， 因 为 SSN 属 性 是 只 读 的 
SocialSecurityNumber = ssn; 


这 种 方法 的 第 一 个 问题 是 ， 如 果 在 父 类 中 定义 的 属性 ( 如 SocialSecurityNumber 属 性 ) 是 只 读 的 ， 
就 不 能 将 传人 的 string 参 数 赋 给 这 个 字段 ， 正 如 这 个 自 定义 构造 函数 最 后 的 代码 语句 所 示 。 

第 二 个 问题 是 , 我 们 间接 地 创建 了 一 个 非常 低 效 的 构造 函数 。 在 C# 下 ， 一般 基 类 的 默认 构造 函数 
会 在 派生 类 构造 函数 执行 之 前 被 自动 调用 。 之 后 ， 当 前 的 实现 会 访问 Employee 基 类 的 许多 公共 属性 来 
创建 其 状态 。 因 此 ， 我 们 实际 上 在 创建 Manager 对 象 时 访问 了 公共 属性 7 次 (5 个 继承 的 属性 以 及 两 个 
构造 函数 调用 )。 

为 了 帮助 优化 派生 类 的 创建 , 最 好 实现 子 类 构造 函数 来 显 式 调用 合适 的 自 定义 基 类 构造 函数 而 不 
是 默认 构造 函数 。 这 样 ， 我 们 就 可 以 减少 对 继承 的 初始 化 成 员 的 调用 次 数 ( 也 就 节省 了 处 理 时 间 )。 
现在 使 用 base 关 键 字 来 改进 Manager 类 型 的 自 定义 构造 函数 : 


public Manager(string fullName, int age, int empID， 
float currpay, string ssn, int numbOfOpts) 
: base(fullName, age, empID, currPay, ssn) 


// 这 个 属性 由 Manager 类 定义 
StockOptions = numbOfOpts; 


在 这 里 , base 关 键 字 挂 接 构 造 郴 数 签名 ( 和 使 用 this 关 键 字 在 单个 类 中 串 连 构造 函数 的 语法 相似 ， 
见 第 5 章 ), 这 代表 派生 构造 函数 将 数据 传递 到 最 近 的 父 构造 函数 中 ,在 这 里 ,我 们 显 式 调用 由 Employee 
定义 的 5 个 参数 的 构造 函数 ， 从 而 节省 子 类 创建 过 程 中 不 必要 的 调用 。 自 定义 的 SalesPerson 构 造 函 数 
应 该 如 下 : 


// 一 般 来 说 ， 所 有 子 类 应 该 显 式 调用 合适 的 基 类 构造 函数 
public SalesPerson(string fullName, int age，int empID， 
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float currPpay, string ssn, int numbOfSales) 
: base(fullName, age, empID, currPay, ssn) 


// 这 个 由 自己 处 理 
SalesNumber = numbOfSales; 


说 明 只 要 子 类 想 访问 由 父 类 定义 的 公共 或 受 保护 的 成 员 , 我 们 就 可 以 使 用 base 关 键 字 。 不 是 只 有 构 
造 函 数 逻 辑 才 能 使 用 这 个 关键 字 。 在 本 章 之 后 研究 多 态 的 时 候 , 我 们 会 看 到 这 样 用 base 关 键 字 
的 很 多 示例 。 


最 后 , 还 记得 吗 ， 只 要 我 们 为 类 定义 增加 了 自 定义 构造 函数 , 默认 构造 函数 就 自动 移 除了 。 因 此 ， 
要 确保 为 SalesPerson 和 Manager 类 型 重新 定义 默认 构造 郴 数 ， 例 如 : 


// 也 在 Manager 类 中 添加 上 默认 构造 水 数 
public SalesPerson() {} 


6.3.2 ”家 族 的 秘密 : protected 关 键 字 


我 们 已 经 知道 ， 公 共 项 可 以 在 任何 地 方 直接 访问 ,而 私有 项 除了 定义 它 的 类 之 外 ,不 能 从 其 他 对 
象 进行 访问 。 第 5 章 介绍 过 ， 作 为 主流 的 面向 对 象 语言 ，C# 提 供 了 另外 一 个 定义 成 员 可 访问 性 的 关键 
字 : protected。 

当 基 类 定义 了 受 保护 数据 或 受 保护 成 员 时 ， 它 就 创建 了 一 组 可 以 直接 被 任何 后 代 访 问 的 项 。 如 果 
希望 SalesPerson 和 Manager 子 类 可 以 直接 访问 由 Employee 定 义 的 数据 区 ， 可 以 按 如 下 代码 更 新 原来 的 
Employee 类 定义 : 

// 受 保护 的 状态 数据 

partial class Employee 


// 派生 类 现在 可 以 直接 访问 这 些 信息 了 
protected string empName; 
protected int empID; 
protected float currPpay; 
protected int empAge; 
protected string empSSN; 
protected static string companyName; 
人 
在 基 类 中 定义 受 保护 成 员 的 好 处 在 于 : 派生 类 型 不 再 需要 使 用 公共 方法 或 属性 来 间接 访问 数据 
了 。 当然 ， 可 能 的 坏处 在 于 : 如 果 派 生 类 型 有 权 直 接 访问 其 父 类 内 部 数据 ， 有 可 能 会 偶然 绕 过 公共 属 
性 内 设置 的 既 有 业务 规则 。 当 定义 受 保护 成 员 时 ， 也 就 创建 了 一 种 父 类 和 子 类 之 间 的 信任 级 别 ， 编 译 
需 不 会 捕获 任何 违背 类 型 业务 规则 的 异常 。 
最 后 要 理解 ， 对 对 象 用 户 来 说 ， 受 保护 数据 可 以 认为 是 私有 的 ( 因为 用 户 处 于 家 族 “ 之 外 ”)。 因 
此 ， 下 面 的 语句 是 不 合法 的 : 


static void Main(string[] args) 


// 错误 ! 不 能 从 对 象 实例 中 直接 访问 受 保护 数据 
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Employee emp = new Employee(); 
emp.empName = "Fred"; 


说 明 尽管 protected 字 段 数据 会 打破 封装 ， 但 是 定义 protected 方 法 是 非常 安全 (和 有 用 ) 的 。 在 构 
建 类 层次 结构 时 ， 我 们 通常 会 定义 一 组 只 能 被 派生 类 型 使 用 的 方法 。 


6.3.3 ”增加 密封 类 


回忆 一 下 ， 密 封 类 是 不 能 被 其 他 类 扩展 的 。 我 们 提 到 过 ， 这 项 技术 通常 用 于 设计 工具 类 。 然 而 ， 
在 构建 类 层次 结构 的 时 候 ， 我 们 可 能 会 发 现 某 个 分 支 应 该 被 阻 断 ， 因 为 再 进一步 扩展 ， 这 个 体系 就 会 
没有 意义 。 例 如 ， 假 设 为 程序 增加 了 另 一 个 类 (PTSalesPerson ) 来 扩展 既 有 的 SalesPerson 类 型 。 图 
6-4 显 示 了 当前 的 更 新 。 





区 , 
| 
MW a 

















Manager 2 SalesPerson > | 
3» Employee + Employse | 











图 6-4 PTSalesPerson 类 


PTSalesPerson 类 ( 当然 ) 表示 兼职 销售 员 。 为 了 说 明 清 楚 ， 假 设 希望 确保 没有 其 他 开发 人 员 可 以 
从 PTSalesPerson 创 建 子 类 。( 毕 竞 ， 兼职 还 能 怎么 分 呢 ? ) 同样 ， 为 了 防止 其 他 人 扩展 类 ， 可 以 使 用 
sealed 关 键 字 : 


sealed class PTSalesPerson : SalesPerson 
public PTSalesPerson(string fullName, int age, int empID， 


float currPpay, string ssn, int numbOfSales) 
:base (fullName, age, empID, currPay, ssn, numbOfSales) 


// 假设 其 他 成 员 …… 
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本 章 前 面 说 过 , 代码 重用 分 两 类 。 我 们 刚 研究 过 经 典 的 “is-a” 关 系 。 在 讨论 OOP 的 第 3 个 支柱 (多 
态 ) 之 前 ， 让 我 们 先 学 习 “has-a” 关 系 (也 叫做 包含 /委托 模型 或 聚合 )。 首 先 新 建 一 个 类 来 建 模 员工 
的 保险 金 。 


// 这 个 类 型 会 作为 包含 类 
class BenefitpPackage 


{ 
// 假设 还 有 其 他 成 员 来 表示 和 牙齿、 健康 保险 金 等 
public double ComputePayDeduction() 
{ 


return 125.0; 
} 
} 
很 显然 ， 在 BenefitpPackage 类 和 员工 类 型 之 间 建 立 “is-a” 关 系 有 点 古怪 。( Employee 是 一 个 
BenefitPackage? 我 可 不 这 么 认为 。) 然而 ,很 明显 二 者 之 间 有 某 种 关系 。 简 单 来 说 ， 我 们 硕 望 表达 每 
一 个 员工 有 〈 “has-a”) BenefitpPackage 这 样 的 概念 。 为 此 ， 按 如 下 所 示 更 新 Employee 类 的 定义 : 


// 员工 现在 有 保险 金 
partial class Employee 


// 包含 BenefitPackage 对 象 
protected BenefitPackage empBenefits = new BenefitPackage(); 


} 

至 此 ， 我 们 已 经 成 功 地 包含 了 另外 一 个 对 象 。 然 而 ， 如 果 要 公开 被 包含 对 象 的 功能 给 外 部 世界 ， 
就 需要 委托 。 简 单 地 说 ， 委 托 就 是 增加 公共 成 员 到 包含 类 ， 以 便 使 用 被 包含 对 象 的 功能 。 

例如 ,我 们 可 以 通过 更 新 Employee 类 使 用 一 个 自 定义 属性 来 公开 包含 的 empBenefits 对 象 ， 并 使 用 
一 个 新 方法 GetBenefitCost() 来 使 用 它 的 内 部 功能 : 


public partial class Employee 
{ 


// 包含 一 个 BenefitPackage 对 象 
protected BenefitPackage empBenefits = new BenefitPackage(); 


// 公开 对 象 的 保险 金 行为 
public double GetBenefitCost() 
{ return empBenefits.ComputePayDeduction(); } 


// 通过 自 定义 属性 公开 对 象 
public BenefitPackage Benefits 


get { return empBenefits; } 
set { empBenefits = value; } 


在 如 下 更 新 过 的 Main() 方 法 中 ,注意 如 何 和 Employee 类 型 定义 的 内 部 Benefitpackage 类 型 进行 
交互 : 
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static void Main(string[] args) 
Console.WritelLine("***** The Employee Class Hierarchy *****\n"); 


Manager chucky = new Manager("Chucky", 50, 92, 100000, "333-23-2322", 9000); 
double cost = chucky.GetBenefitCost(); 
Console.ReadLine(); 


伐 套 类 型 定义 


第 5 章 简单 提 到 了 藤 套 类 型 的 概念 , 这 是 刚才 提 到 的 “has-a” 关 系 的 男 一 种 说 法 ,在 C#f 以 及 其 他 .NET 
语言 ) 中 ， 我 们 可 以 直接 在 类 或 结构 作用 域 中 定义 类 型 ( 枚 举 、 类 、 接 口 、 结 构 或 委托 )。 如 果 这 么 做 
的 话 ， 被 骨 套 (或 内 部 ) 的 类 型 被 认为 是 柑 套 (或 外 部 ) 类 的 成 员 ， 并 且 从 运行 时 角度 来 说 ， 可 以 像 操 
作 其 他 成 员 (〈 字 段 、 属 性 、 方 法 和 事件 等 ) 一 样 来 操作 舱 套 类 型 。 冬 套 类 型 的 语法 非常 简单 明了 : 


public class OuterClass 
// 公共 嵌 套 类 型 可 以 被 任何 人 使 用 
public class PublicInnerClass {} 


// 私有 谈 宕 类 型 只 可 以 被 包含 类 的 成 员 使 用 
private class PrivateInnerClass {} 


} 

尽管 语法 很 简洁 ,但 是 要 理解 为 什么 这 么 做 却 不 那么 简单 。 要 理解 这 项 技术 ,考虑 如 下 内 套 类 型 
的 特征 。 

口 通过 髋 套 类 型 可 以 完全 控制 内 部 类 型 的 访问 级 别 ， 也 就 是 可 以 声明 为 私有 的 ( 回忆 一 下 , 非 

嵌 套 类 不 能 使 用 private 关 键 字 来 声明 )。 

口 由 于 藤 套 类 型 是 包含 类 的 成 员 ， 所 以 它 可 以 访问 包含 类 的 私有 成 员 。 

口 通常 ， 藤 套 类 型 只 用 做 外 部 类 的 辅助 方法 ， 而 不 是 为 外 部 世界 所 准备 的 。 

如 果 类 型 蔡 套 了 另 一 个 类 类 型 , 它 就 可 以 创建 这 个 类 型 的 成 员 变 量 , 就 好 像 是 数据 点 一 样 。 然而 ， 
如 果 要 从 包含 类 型 的 外 部 使 用 谋 套 类 型 ， 就 必须 限定 嵌 套 类 型 的 作用 域 。 考 虑 如 下 代码 : 


static void Main(string[] args) 


// 创建 并 使 用 公共 的 内 部 类 
OuterClass.PublicInnerClass inner; 
inner = new OuterClass.PublicInnerClass(); 


// 编译 器 错误 ! 不 能 访问 私有 类 
QuterClass.PrivateInnerClass inner2; 
inner2 = new OuterClass.PrivateInnerClass(); 


} 
要 在 我 们 的 Employee 示 例 中 使 用 这 个 概念 ， 可 以 假设 现在 在 Employee 类 类 型 中 直接 栓 套 类 
BenefitpPackage: 


partial class Employee 
public class BenefitPackage 


{ 
// 假设 有 其 他 成 员 表 示 和 牙齿 、 健 康 保险 金 等 
public double ComputePayDeduction() 


return 125.0; 


. 
柑 套 的 “深度 ”可 以 按 需 设 定 。 例 如 ， 假 设 希 望 创建 一 个 名 为 BenefitPackageLevel 的 枚 举 ， 它 列 
举 了 员工 可 以 选择 的 各 种 保险 金 级 别 。 为 了 通过 编程 强制 Employee 、BenefitPackage 和 Benefit 
PackageLevel 之 间 的 紧密 联系 ， 我 们 可 以 按 如 下 所 示 嵌 套 枚 举 : 


// Employee 谈 套 BenefitpPackage 
public partial class Employee 


// BenefitpPackage 谈 套 BenefitPackageLevel 
public class BenefitPackage 


public enum BenefitpPackageLevel 


Standard, Gold, Platinum 


public double ComputepPayDeduction() 


return 125.0; 


在 这 种 嵌 套 关系 里 需要 注意 如 何 使 用 枚 举 : 
static void Main(string[] args) 
// 定义 福利 等 级 
Employee.BenefitPpackage.BenefitPackageLevel myBenefitLevel = 
Employee.BenefitPackage.BenefitPpackageLevel .Platinum; 
Console.ReadLine(); 


} 
太 好 了 ! 至 此 我 们 已 经 研究 了 允许 使 用 经 典 继承 、 包 含 和 栋 套 类 型 构建 相关 类 型 层次 关系 的 许多 


关键 字 。 如 果 还 有 一 些 细节 不 是 很 清楚 ， 不要紧。 我 们 会 在 本 书 其 他 部 分 构建 许多 其 他 层次 关系 。 接 
着 ， 让 我 们 研究 OOP 的 最 后 一 个 支柱 : 多 态 。 


6.5 OOP 的 第 三 个 支柱 : C# 的 多 态 支持 
还 记得 吗 ，Employee 基 类 定义 了 一 个 叫 GiveBonus() 的 方法 ， 它 的 原始 实现 如 下 : 


public partial class Employee 
public void GiveBonus(float amount) 


CurrPay += amount; 
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因为 这 个 方法 使 用 public 关 键 字 来 定义 ,我 们 现在 可 以 给 销售 人 员 和 经 理 ( 以 及 兼职 销售 人 员 ) 
奖金 了 : 
static void Main(string[] args) 


Console.WritelLine("***** The Employee Class Hierarchy *****\n"); 


// 给 每 一 个 员工 奖金 

Manager chucky = new Manager("Chucky", 50, 92, 100000,，"333-23-2322", 9000); 
chucky.GiveBonus(300); 

chucky.Displaystats(); 

Console.WriteLine(); 


SalesPerson fran = new SalesPerson("Fran", 43, 93, 3000, "932-32-3232", 31); 
fran.GiveBonus(200); 
fran.DisplayStats(); 
Console.ReadLine(); 


当前 设计 中 的 问题 是 , 继承 的 GiveBonus() 方 法 对 所 有 子 类 都 进行 相同 的 操作 。 理 想 情况 下 ,销售 
人 员 或 兼职 销售 员 的 奖金 应 该 和 销售 情况 有 关 。 可 能 经 理应 该 得 到 额外 的 股票 期 权 和 加 薪 。 因 此 ， 我 
们 现在 面临 一 个 有 趣 的 问题 : 相关 类 型 如 何 对 相同 的 请 求 做 出 不 同 的 响应 ? 


6.5.1 virtual 和 override 关 键 字 


多 态 为 子 类 提供 了 一 种 方式 , 使 其 可 以 定义 由 其 基 类 定义 的 方法 ,这 种 过 程 叫做 方法 重 写 。 为 了 
修改 当前 的 设计 , 我 们 需要 理解 virtual 和 override 关 键 字 的 作用 。 如 果 基 类 希望 定义 可 以 (不 是 必需 
的 ) 由 子 类 重 写 的 方法 ， 就 必须 用 virtual 关 键 字 标志 方法 : 


partial class Employee 


{ 
// 这 个 方法 现在 可 以 由 派生 类 “ 重 写 ” 
public virtual void GiveBonus(float amount) 


Pay += amount; 


说 明 用 virtual 关 键 字 标 记 的 方法 ( 理所当然 ) 称 为 虚 方 法 。 


如 果子 类 布 望 改变 虚 方 法 的 实现 细节 ,就 必须 使 用 override 关 键 字 。 例 如 ,SalesPerson 和 Manager 
可 以 按 如 下 所 示 重 写 6iveBonus() ( 假设 PTSalesPerson 不 会 重 写 GiveBonus() ， 因 此 也 就 只 会 继承 由 
SalesPerson 定 义 的 版 本 ): 
class SalesPerson : Employee 
1/ 销售 人 员 的 奖金 受 销售 量 的 影响 
public override void GiveBonus(float amount) 


int salesBonus = 0; 
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if (number0fSales >= 0 && numberOfSales <= 100) 
salesBonus = 10; 
else 


if (number0fSales >= 101 && numberOfSales “= 200) 
salesBonus = 15; 

else 
salesBonus = 20; 


base.GiveBonus(amount * salesBonus); 


} 


class Manager : Employee 


public override void GiveBonus(float amount) 


base.GiveBonus(amount); 
Random r = new Random(); 
numberOfOptions += r.Next(500); 
} 
注意 ， 重 写 方法 完全 可 以 通过 base 关 键 字 来 自由 地 使 用 默认 行为 。 这 样 ， 我 们 就 不 需要 完全 重新 
实现 GiveBonus() 的 逻辑 ， 而 是 可 以 重用 (或 扩展 ) 父 类 的 默认 行为 。 
假设 Employee 类 当前 的 Displaystats() 方 法 被 声明 为 虚 的 。 这 样 ， 每 一 个 子 类 都 可 以 重 写 这 个 方 
法 来 说 明 销售 量 〈 对 销售 人 员 ) 或 当前 股票 期 权 数 量 ( 对 经 理 )。 例 如 ， 如 下 所 示 的 Manager 版 本 的 
DisplayStats() 方 法 ( SalesPerson 类 也 会 以 相似 方式 实现 DisplayStats() ): 


public override void DisplayStats() 


base.DisplayStats(); 
Console.WriteLine("Number of Stock Options: {0}", StockOptions); 


现在 每 一 个 子 类 都 可 以 说 明 这 些 虚 方法 对 自己 意味 着 什么 ， 每 一 个 对 象 实例 表现 为 更 独立 的 
实体 : 
static void Main(string[] args) 


Console.WriteLine("***** The Employee Class Hierarchy *****\n"); 


// 更 好 的 奖金 系统 

Manager chucky = new Manager("Chucky", 50, 92, 100000，,，"333-23-2322", 9000); 
chucky .GiveBonus (300); 

chucky.DisplayStats(); 

Console.WriteLine(); 


SalespPerson fran = new SalesPerson("Fran", 43, 93, 3000, "932-32-3232", 31); 
fran.GiveBonus(200); 
fran.DisplayStats(); 
Console.ReadLine(); 


} 
下 面 给 出 了 到 目前 为 止 应 用 程序 可 能 的 测试 运行 结果 : 
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沙沙 炒 冰 水 The Employee Class Hierarchy ***** 


Name: Chucky 

ID: 92 

Age: 50 

Pay: 100300 

SSN: 333-23-2322 

Number of Stock Options: 9337 


Name: Fran 

ID: 93 

Age: 43 

Pay: 5000 

SSN: 932-32-3232 
Number of Sales: 31 








6.5.2 ”使 用 Visual Studio IDE 重 写 虚 方法 


你 可 能 已 经 知道 ， 重 写 一 个 成 员 时 必须 记得 每 一 个 参数 的 类 型 ， 更 不 要 说 方法 名 和 参数 传递 规则 
(ref、out 和 params 等 )。Visual Studio 有 一 个 非常 有 用 的 、 可 以 在 重 写 虚 成 员 时 使 用 的 特性 。 如 果 在 类 
类 型 作用 域 中 输入 “override” 单 词 (然后 按 空格 键 )， 智 能 感知 会 自动 显示 定义 在 父 类 中 的 所 有 可 重 
写成 员 的 列表 ， 如 图 6-5 所 示 。 


SalesPerson.cs” 忆 兴 ec 1 
人 Employees, SalesPerson - © DispiayStatsd 
Susing System; 中 
using System,Collections.Generic; 
Using System.Ling; 
Using System.Text; 
using System.Threading,Tasks; 





"amespace Employees 
{ 


jf Sulespeople need to knew their rumber of sales, 
Chass Salwsrwrso: : # yy 


{ 


public int SalesNumber { Bet; set; } 


override 


外 Equalstobject obj 





@ GetHashCedeD a 半 
o tring objectToseino0 
Returns a string that represents the current object,| 
i00 % 


图 6-5 在 Visual Studio 中 快速 查看 可 重 写 方 法 


如 果 我 们 选择 一 个 成 员 并 且 按 Enter，IDE 会 自动 为 我 们 填写 方法 存根 。 注 意 ， 我 们 还 获得 了 一 个 
调用 父 类 版 本 虚 成 员 的 语句 ( 如 果 不 需 要 ， 完 全 可 以 删除 这 行 )。 例 如 ， 如 果 在 重 写 DisplayStats() 
方法 时 使 用 这 一 技术 ， 可 能 会 看 到 下 面 自动 生成 的 代码 : 


public override void DisplayStats() 


base.DisplayStats(); 
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6.5.3 ”密封 虚 成 员 


回忆 一 下 sealed 关 键 字 , 它 可 以 用 于 类 类 型 来 防止 其 他 类 型 通过 继承 扩展 其 行为 。 你 可 能 还 记得 ， 
我 们 密封 了 PTSalesPerson， 因 为 我 们 认为 其 他 开发 人 员 扩 展 这 条 继承 线 是 无 意义 的 。 

补充 一 下 ， 有 时 我 们 不 希望 密封 整个 类 ， 而 只 希望 防止 派生 类 型 来 重 写 某 个 虚 方 法 。 例 如 ,假设 
我 们 不 希望 兼职 销售 人 员 获 得 自 定义 的 奖金 ， 就 要 防 目 PTSalesPerson 类 重 写 6iveBonus() 虚 方法 ,我 
们 只 需要 密封 SalesPerson 中 的 这 个 方法 : 


// SalespPerson 密 封 了 GiveBonus() 方 法 
class SalesPerson : Employee 


public override sealed void GiveBonus(float amount) 


ee 
} 


在 这 里 ，SalesPerson 确 实 重 写 了 定义 在 Employee 类 中 的 GiveBonus() 虚 方法 ， 然 而 它 显 式 标记 
为 密封 的 。 因 此 ， 如 果 按 如 下 所 示 的 代码 尝试 在 PTSalesPerson 类 中 重 写 这 个 方法 ,你 就 会 收 到 编译 
时 错误 : 

sealed class PTSalesPerson : SalesPerson 


public PTSalesPerson(string fullName, int age, int empID, 
float currPay, string ssn, int numbOfSales) 
:base (fullName, age, empID, currPay, ssn, numbOfSales) 


} 


// 编译 器 错误 | 不 能 在 PTSalesPerson 类 中 重 写 这 个 方法 ， 因 为 它 是 被 密封 的 
public override void GiveBonus(float amount) 


} 
} 


6.5.4 抽象 类 


现在 ，Employee 基 类 已 经 为 它 的 后 代 提 供 了 受 保 护 的 成 员 变量 和 两 个 可 以 被 某 个 后 代 重 写 的 虚 方 
法 (GiveBonus() 和 DisplayStats() )。 虽 然 这 不 错 , 但 是 当前 设计 还 有 一 个 古怪 的 地 方 , 我 们 可 以 直接 
创建 Employee 基 类 的 实例 : 


// 这 算 什么 意思 
Employee X = new Employee(); 


在 这 个 示例 中 ，Employee 基 类 的 作用 是 为 所 有 子 类 定义 公共 成 员 。 在 任何 情况 下 ， 我 们 都 不 希望 
任何 人 直接 创建 这 个 类 的 实例 ， 因 为 Employee 类 型 本 身 是 一 个 非常 普通 的 概念 。 例 如 ， 如 果 我 向 你 走 
过 来 ， 然 后 说 :“ 我 是 一 个 员工 !1” 你 可 能 非常 想 问 我 :“ 你 是 什么 样 的 员工 ?” ”顾问 、 培 训 师 、 行 政 
助理 、 文 字 编 辑 或 白宫 助手 等 ? 

由 于 很 多 基 类 都 是 比较 模糊 的 实体 ， 好 的 设计 师 会 防止 在 代码 中 直接 创建 新 的 Employee 对 象 。 在 
C# 中 ， 我 们 可 以 使 用 abstract 关 键 字 来 强制 这 种 编程 方式 ， 因 此 创建 一 个 抽象 基 类 : 
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// 将 Employee 类 更 新 为 抽象 类 来 防止 直接 实例 化 
abstract partial class Employee 


这 样 ， 如 果 现 在 尝试 创建 Employee 类 的 实例 ， 就 会 收 到 一 个 编译 时 错误 : 


// 错误 ! 不 能 创建 抽象 类 的 实例 
Employee X = new Employee(); 


定义 了 类 却 不 能 直接 创建 它 ， 这 乍 看 上 去 似乎 很 怪异 。 但 要 记 住 基 类 ( 抽象 或 非 抽象 ) 是 非常 有 
用 的 ,它们 包含 了 派生 类 型 中 所 有 的 通用 数据 和 功能 。 使 用 这 种 抽象 ,我 们 完全 可 以 为 那些 不 是 具体 
实体 的 东西 进行 建 模 ， 如 员工 的 “想法 ”( idea )。 同 样 要 了 解 的 是 ， 尽 管 我 们 不 能 直接 创建 抽象 类 ， 
但 在 创建 其 派生 类 时 ,仍然 会 在 内 存 中 对 其 进行 组 装 。 因 此 对 抽象 类 来 说 ,定义 若干 在 分 配 派生 类 时 
间接 调用 的 构造 函数 是 很 正常 ( 且 常 见 ) 的 。 

至 此 , 我 们 已 经 构建 了 一 个 相当 有 趣 的 员工 层次 结构 。 本 章 后 面 讨论 C# 强 制 转 换 规则 时 ,我 们 会 
增加 更 多 功能 到 这 个 应 用 程序 中 。 图 6-6 显 示 了 当前 类 型 的 核心 设计 。 





‘ Employee 1 
| 抽象 类 
i 国字 自 
| 田 属 性 
| 田 方 法 
| 日 嵌 套 类 型 
: | 类 | 
| | 9 力 法 
| @ “ComputepayDeduction 有 
| | 号 做 套 类 型 | : 
| | Berd EE | | 
| | | 古 学 | 
Standard | 
| Gold | | 
Platinum | : 
: bE 和 i 
PC 
Manager ¥ SalesPerson 会 
类 
3 Emplioyee » Employee 
A 3 属性 
宣 方 法 


3 SalesPerson 


图 6-6 雇员 层次 结构 
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源 代码 ”Employees 项 目的 源 代 码 位 于 Chapter 6 子 目 录 下 。 


6.5.5 构建 多 态 接口 


如 果 类 被 定义 为 抽象 基 类 ( 通过 abstract 关 键 字 ), 它 就 可 以 定义 许多 抽象 成 员 。 当 你 希望 定义 没 
有 提供 默认 实现 而 必须 在 每 个 派生 类 中 实现 的 成 员 时 ， 可 以 使 用 抽象 成 员 。 这 样 做 就 强制 了 每 一 个 后 
代 具 有 多 态 接口 ， 它 们 需要 自己 处 理 抽象 方法 的 细节 。 

简 而 言 之 ， 抽 象 基 类 的 多 态 接口 只 是 指 一 组 虚 的 或 者 抽象 的 方法 。 其 有 趣 之 处 不 是 一 眼 就 可 以 看 
出 的 ， 因 为 OOP 的 这 个 特性 可 用 来 构建 可 高 度 扩展 的 灵活 的 应 用 程序 。 为 了 演示 ， 我 们 会 实现 (以 及 
一 点 小 修改 ) 第 5 章 概览 DOP 支柱 时 粗略 研究 过 的 图 形 层次 结构 。 首 先 ， 新 建 一 个 名 为 Shapes 的 C# 控 
制 台 应 用 程序 。 

在 图 6-7 中 ,注意 Hexagon 和 Circle 类 型 都 扩展 了 Shape 基 类 。 和 任何 其 他 基 类 相似 ，Shape 定 义 了 许 
多 所 有 后 代 都 共有 的 成 员 ( 这 里 是 PetName 属 性 和 Draw() 方 法 )。 
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图 6-7 图 形 层次 结构 


和 员工 层次 结构 相似 我们 应 该 不 希望 允许 对 象 用户 直 接 创 建 shape 的 实例 ， 因 为 这 个 概念 过 于 
抽象 。 同 样 ， 为 了 防止 直接 创建 shape 类 型 ， 可 以 把 它 定义 为 抽象 类 。 同 样 ， 由 于 我 们 希望 派生 类 型 
有 自己 独特 的 Draw() 方 法 ， 那 么 我 们 就 把 它 标 记 为 virtual， 并 定义 一 个 默认 的 实现 。 


// 层次 结构 中 的 抽象 基 类 
abstract class Shape 


public Shape(string name = "NoName") 
{ PetName = name; } 
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public string PetName { get; set; } 


// 一 个 虚 方 法 
public virtual void Draw() 


Console.WriteLine("Inside Shape.Draw()"); 
} 
} 
注意 Draw() 虚 方法 提供 了 默认 实现 , 仅仅 是 输出 一 个 消息 , 通知 我 们 调用 的 是 Shape 基 类 中 的 Draw() 
方法 。 现在 回忆 一 下 ， 如果 一 个 方法 标记 为 virtual, 这 个 方法 提供 的 默认 实现 会 被 所 有 派生 类 型 自动 
继承 。 如 果子 类 愿意 这 样 继承 , 可 以 重 写 这 个 方法 , 但 这 不 是 必需 的 。 因此 , 考虑 如 下 Circle 和 Hexagon 
类 型 的 实现 : 
// Circle 没 有 重 写 Draw() 
class Circle : Shape 
t public Circle() {} je 
public Circle(string name) : base(name){} 


// Hexagon 重 写 了 Draw() 
class Hexagon : Shape 


public Hexagon() {} 
public Hexagon(string name) : base(name){} 
public override void Draw() 


Console.WriteLine("Drawing {0} the Hexagon", PetName); 

} 

还 记得 吧 ， 子 类 重 写 虚 方 法 不 是 必需 的 (正如 Circle 的 例子 )， 这 样 抽象 方法 的 作用 就 很 明显 了 。 
因此 ， 如 果 我 们 创建 Hexagon 和 Circle 类 型 的 实例 ， 会 发 现 Hexagon 知 道 如 何 正确 地 “绘制 ”自身 (至 
少将 正确 的 消息 输出 到 控制 台 )。 而 Circle 就 有 一 点 令 人 困惑 : 

static void Main(string[] args) 

Console.WritelLine("***** Fun with Polymorphism *****\n"); 


Hexagon hex = new Hexagon("Beth"); 
hex.Draw(); 


Circle cir = new Circle("Cindy"); 
// 调用 基 类 实现 

cir.Draw(); 

Console.ReadLine(); 


现在 看 一 下 前 面 的 Main() 方 法 的 输出 结果 : 





六 六 水 于 六 Fun with Polymorphism 灶 半 沙 半 


Drawing Beth the Hexagon 
Inside Shape.Draw() 
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很 明显 , 对 于 当前 的 层次 结构 而 言 , 这 不 是 非常 明智 的 设置 。 要 强制 每 一 个 子 类 重 写 Draw() 方 法 ， 
我 们 可 以 把 Draw() 定 义 为 shape 类 的 一 个 抽象 方法 ， 也 就 是 说 我 们 没有 提供 默认 的 实现 。 在 C# 中 可 以 
使 用 abstract 关 键 字 将 方法 标记 为 抽象 的 。 注 意 ，abstract 成 员 没 有 提供 任何 实现 : 


abstract class Shape 


{ 
// 强制 所 有 子 类 来 定义 如 何 被 呈现 
public abstract void Draw(); 


} 


说 明 ”抽象 方法 只 可 以 定义 在 抽象 类 中 。 如 果 不 是 这 样 的 话 ， 就 会 收 到 编译 器 错误 。 





标记 为 abstract 的 方法 是 纯粹 的 协议 。 它 们 只 是 定义 了 名 字 、 返 回 值 ( 如 果 需 要 的 话 ) 和 参数 集 
合 (如 果 需 要 的 话 )。 在 这 里 ,抽象 的 Shape 类 通知 了 派生 类 型 :“ 我 有 一 个 无 参 方法 Draw()。 如 果 要 从 
我 派生 的 话 ， 请 填充 细节 。” 

因此 ,我们 就 必须 在 Circle 类 中 重 写 Draw() 方 法 。 如 果 不 这 样 的 话 ，Circle 就 应 该 是 不 可 创建 
的 抽象 类 型 ， 必 须 使 用 abstract 关 键 字 来 修饰 ( 对 于 这 个 示例 ， 很 明显 不 适合 )。 这 里 是 更 新 后 的 
代码 : 


// 如 果 不 实现 抽象 的 Draw() 方 法 ，Circle 也 ,必须 是 抽象 的 ， 我 们 必须 将 其 标记 为 abstract 
class Circle : Shape 


public Circle() {} y 
public Circle(string name) : base(name) {} 
public override void Draw() 


Console.WriteLine("Drawing {0} the Circle", PetName); 
} 
现在 我 们 就 能 认为 任何 从 shape 派 生 的 类 型 都 会 有 自己 版 本 的 Draw() 方 法 。 为 了 了 人 解 完整 的 多 态 ， 
考虑 如 下 的 代码 : 

static void Main(string[] args) 

Console.Writeline("***** Fun with Polymorphism *****\n"); 

// 创建 一 个 图 形 对 象 数组 

Shape[] myShapes = {new Hexagon(), new Circle(), new Hexagon("Mick"), 


new Circle("Beth"), new Hexagon("Linda")}; 


// 循环 每 一 个 项 来 和 多 态 接口 进行 交互 
foreach (Shape s in myShapes) 


s.Draw(); 


Console.ReadLine(); 


下 面 显示 了 修改 的 Main() 方 法 的 输出 结果 
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Main() 方 法 说 明了 多 态 的 作用 。 尽 管 不 能 直接 创建 抽象 基 类 的 实例 (shape )， 我 们 完全 可 以 使 用 
抽象 基 类 变量 来 保存 指向 任何 子 类 的 引用 。 因 此 ， 创 建 mySshapes 数 组 时 ， 数 组 可 以 保存 任何 从 Shape 
基 类 派生 的 对 象 (如 果 试 图 把 非 Shape 兼 容 的 对 象 放 入 数组 ， 就 会 收 到 编译 需 错 误 )。 

因为 myShapes 数 组 中 的 所 有 项 都 派生 自 shape, 我 们 知道 它们 都 支持 相同 的 多 态 接口 (或 者 更 直接 
地 说 , 它们 都 有 Draw() 方 法 ), 当 我 们 在 运行 时 迭代 Shapes 引 用 数组 的 时 候 , 就 已 经 决定 了 其 实际 类 型 。 
这 样 的 话 ， 就 会 调用 正确 版 本 的 Draw() 方 法 。 

这 个 技术 使 得 我 们 扩展 当前 的 层次 结构 很 安全 。 例 如 ， 假 设 我 们 从 Shape 抽 象 基 类 派生 5 个 类 
( Triangle、Square 等 )。 由 于 多 态 接口 的 使 用 ，foreach 循 环 中 的 代码 不 需要 任何 改动 ， 因 为 编译 器 会 
强制 只 有 Shape 兼 容 的 类 型 才能 放 到 myShapes 数 组 中 。 


6.5.6 ”成员 投影 


C# 提 供 了 逻辑 上 和 方法 重 写 相 对 的 功能 ， 叫 做 投影 (shadowing )。 正 式 地 说 ， 如 果 派 生 类 定义 的 
成 员 和 定义 在 基 类 中 的 成 员 一 致 ， 派 生 类 就 投影 了 父 类 的 版 本 。 在 真实 情况 下 ， 如 果 我 们 (或 者 我 们 
的 团队 ) 从 一 个 不 是 自己 创建 的 类 来 创建 子 类 就 很 可 能 会 发 生 这 样 的 情况 ( 例如 ， 如 果 你 购买 第 三 
方 .NET 软 件 包 )。 

举例 说 明 ， 假 设 我 们 的 同事 或 同学 定义 了 一 个 叫 ThreeDCircle 的 类 ， 它 有 一 个 叫 Draw() 的 无 参 方法 : 


class ThreeDCircle 








wo 





public void Draw() 


Console.WritelLine("Drawing a 3D Circle"); 


} 
我 们 发 现 ThreeDCircle 是 (“is-a”) Circle， 因 此 我 们 从 既 有 的 Circle 类 型 进行 派生 : 
class ThreeDCircle : Circle 
public void Draw() 
Console.WriteLine("Drawing a 3D Circle"); 
1 
重 编译 之 后 ， 我 们 发 现 如 下 警告 信息 


TO 


'Shapes.ThreeDCircle.Draw()' hides inherited member 'Shapes.Circle.Draw()'. 
To make the current member override that implementation, add the override keyword. 
Otherwise add the new keyword. 


OOO ORTON SE eH GE EOE CHOSE EEO PAs DEH 
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问题 在 于 派生 类 ( ThreeDCircle ) 包含 了 与 继承 的 方法 同名 的 方法 。 为 了 解决 这 个 问题 ， 我 们 有 
两 个 选择 。 第 一 种 ， 我 们 可 以 只 使 用 override 关 键 字 更 新 父 版 本 的 Draw() ( 就 如 编译 器 建议 的 那样 )。 
这 样 ，ThreeDCircle 类 型 就 可 以 按 需 扩展 父 类 的 默认 行为 。 然 而 ， 如 果 我 们 对 定义 基 类 的 代码 没有 访 
问 权限 ( 同样 ， 比 如 在 很 多 第 三 方 类 库 中 ), 我 们 就 不 能 将 Draw() 方 法 修改 为 虚 方 法 ， 因 为 我 们 不 能 访 
问 代码 文件 ! 

第 二 种 选择 是 ， 我 们 可 以 为 派生 类 型 ( 这 里 是 ThreeDCircle ) 的 Draw() 成 员 添 加 new 关 键 字 。 这 样 
就 将 显 式 声明 派生 类 型 的 实现 故意 设计 为 隐藏 父 类 的 版 本 ( 同样 ,在 真实 世界 中 ， 当 外 部 .NET 软 件 和 
我 们 当前 软件 有 冲突 时 ， 这 会 很 有 用 )。 

// 这 个 类 扩展 了 (Circle 并 隐藏 了 继承 的 Draw( ) 方 法 


class ThreeDCircle : Circle 


{ 
// 隐藏 任何 在 我 之 上 的 Draw() 实 现 
public new void Draw() 


Console.WriteLine("Drawing a 3D Circle"); 


} 
我 们 还 可 以 把 new 关 键 字 应 用 到 任何 从 基 类 继承 的 成 员 类 型 中 ( 字段、 常量 、 静 态 方法 、 属 性 等 )。 
作为 进 阶 的 示例 ， 假 设 ThreeDCircle 希 望 隐 藏 继承 的 PetName 属 性 : 


class ThreeDCircle : Circle 


// 隐藏 任何 在 我 之 上 的 PetName 属 性 
public new string PetName { get; set; } 


// 隐藏 任何 在 我 之 上 的 Draw() 实 现 
public new void Draw() 


Console.WriteLine("Drawing a 3D Circle"); 


} 
最 后 ,需要 知道 ,我 们 仍然 可 以 使 用 显 式 强制 转换 来 触发 阴影 成 员 在 基 类 中 的 实现 (在 下 一 小 节 
中 会 介绍 )。 例 如 : 


static void Main(string[] args) 


// 调用 了 ThreeDCircle 的 Draw() 方 法 
ThreeDCircle o = new ThreeDCircle(); 
0.Draw(); 


// 调用 了 父 类 的 Draw() 方 法 


((Circle)o).Draw(); 
Console.ReadLine(); 


源 代 码 ”Shapes 项 目的 源 代码 位 于 Chapter 6 子 目录 下 。 
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6.6 ” 基 类 /派生 类 的 转换 规则 


现在 可 以 构建 一 组 相关 的 类 类 型 ， 但 需要 学 习 类 类 型 强制 转换 操作 的 规则 。 那 么 ， 让 我 们 返回 
本 章 之 前 创建 的 雇员 层次 结构 。 在 .NET 平 台 下 ， 系 统 中 的 最 高 基 类 是 System.0bject。 因 此 ， 所 有 
东西 都 是 (“is-a”)object, 并 且 可 以 照 此 进行 处 理 。 因此 , 在 对 象 变量 中 保存 任何 类 型 的 实例 都 是 
合法 的 : 

static void CastingExamples() 


// Manager 是 (is-a) System.0bject， 因 此 我 们 刚好 可 以 在 对 象 变量 中 存储 Manager 引 用 
// 用 object 变 量 保存 Manager 引 用 也 是 可 以 的 
object frank = new Manager("Frank Zappa", 9, 3000, 40000, "111-11-1111", 5); 


在 Employees 系 统 中 ，Manager 、SalesPerson 和 PTSalesPerson 类 型 都 扩展 了 Employee， 因 此 我 们 可 
以 在 有 效 的 基 类 引用 中 保存 任何 对 象 。 因 此 ， 如 下 语句 也 是 合法 的 : 


static void CastingExamples() 


// Manager 是 (is-a) System.object， 因 此 我 们 刚好 可 以 在 对 象 变量 中 存储 Manger 引 用 
object frank = new Manager("Frank Zappa", 9, 3000, 40000, "111-11-1111", 5); 


// Manager 同 样 是 Employee 
Employee moonUnit = new Manager("MoonUnit Zappa", 2, 3001, 20000, "101-11-1321",1); 


// PTSalesPerson 是 SalesPerson 
SalesPerson jill = new PTSalesPerson("Jill", 834, 3002, 100000, "111-12-1119", 90); 


} 

类 类 型 之 间 强 制 转换 的 第 一 条 准则 就 是 如 果 两 个 类 通过 “is-a” 关 系 关联 ， 在 基 类 引用 中 保存 派 
生 类 型 总 是 安全 的 。 正 式 地 说 ,这 叫做 隐 式 转换 ， 因 为 它 基 于 继承 的 规则 。 这 就 产生 了 很 多 强大 的 编 
程 结 构 。 例 如 ,假设 我 们 在 当前 Program 类 中 定义 了 新 的 方法 : 

static void GivePromotion(Employee emp) 


// 增加 工资 
// 在 公司 车 库 新 增 停车 位 


Console.WriteLine("{0} was promoted!", emp.Name); 


因为 这 个 方法 接受 单个 Employee 类 型 的 参数 ， 而 且 这 是 “is-a” 关 系 ， 所 以 实际 上 可 以 将 任何 
Employee 类 的 后 代 直 接 传递 到 这 个 方法 中 : 
static void CastingExamples() 


// Manager 是 (is-a) System.0bject， 因 此 我 们 刚好 可 以 在 对 象 变量 中 存储 Manger 引 用 
object frank = new Manager("Frank Zappa", 9, 3000, 40000, "111-11-1111", 5); 


// Manager 同 样 是 Employee 
Employee moonUnit = new Manager("MoonUnit Zappa", 2, 3001, 20000, "101-11-1321", 1); 
GivePromotion(moonUnit); 


// PTSalesPerson 是 SalesPerson 
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SalespPerson jill = new PTSalesPerson("Jill", 834, 3002, 100000, "111-12-1119", 90); 
GivepPromotion(jill); 


之 前 的 代码 示例 从 基 类 类 型 ( Employee ) 隐 式 转换 为 派生 类 型 。 然 而 , 如 果 想 解雇 Frank Zappa( 当 
前 保存 在 泛 型 System.0bject 引 用 中 )， 该 怎么 办 呢 ? 如 果 按 如 下 所 示 把 frank 对 象 直接 传人 
GivePromotion() ， 我 们 会 收 到 一 个 编译 器 错误 : 


// 错误 
object frank = new Manager("Frank Zappa", 9, 3000, 40000, "111-11-1111", 5); 
GivePpromotion(frank); 


问题 在 于 你 传递 的 不 是 一 个 Employee， 而 是 更 普遍 的 System.0bject。 由 于 object 在 继承 链 中 的 位 
置 比 Employee 更 高 ， 因 此 编译 器 不 允许 隐 式 转换 ， 这 可 以 尽 可 能 地 保证 代码 安全 。 

尽管 你 能 够 指出 这 个 object 引 用 指向 的 是 一 个 内 存 中 与 Employee 兼 容 的 类 ， 但 编译 器 无 法 这 么 
做 ， 它 直到 运行 时 才能 知道 这 些 信息 。 你 可 以 执行 一 个 显 式 转换 来 满足 编译 器 的 要 求 。 这 就 是 转换 
的 第 二 条 规则 : 使 用 C# 强 制 转换 操作 符 进 行 显 式 的 向 下 转换 。 执 行 显 式 转换 时 所 遵循 的 基本 模板 如 
下 所 示 : 

(ClassIWantToCastTo)referenceIHave 

因此 ， 要 将 object 变 量 传 递 给 GivePromotion() 方 法 ， 必 须 使 用 如 下 的 代码 : 


//OK]! 
Givepromotion( (Manager)frank); 


6.6.1 ”CC# 的 as 关 键 字 


要 知道 ， 显 式 强制 转换 在 运行 时 而 不 是 编译 时 进行 运算 。 因 此 ， 如 果 写 如 下 的 C# 代 码 : 


// 我 们 不 能 强制 转换 frank 为 Hexagon， 但 编译 没 问 题 
Hexagon hex = (Hexagon)frank; 


可 以 正确 编译 ， 但 我 们 会 收 到 一 个 运行 时 错误 ， 或 者 更 正式 地 说 是 运行 时 异常 。 第 7 章 会 研究 结 
构 化 异常 处 理 的 完整 细节 , 然而 , 现在 值得 指出 的 是 如 果 正 在 进行 显 式 转换 , 可 以 通过 使 用 try 和 catch 
关键 字 来 捕获 可 能 的 无 效 转 换 〈 详细 内 容 参 见 第 7 章 ): 

// 捕捉 可 能 的 无 效 转换 

try 

' Hexagon hex = (Hexagon)frank; 


catch (InvalidCastException ex) 


Console.Writeline(ex.Message); 


虽然 这 是 容错 编程 的 一 个 好 例子 , 但 是 C# 提 供 了 as 关键 字 在 运行 时 快速 检测 某 个 类 型 是 否 和 另外 
一 个 兼容 。 如 果 我 们 使 用 as 关键 字 ， 就 可 以 通过 检查 nul1 返 回 值 来 检测 兼容 性 。 考 虑 如 下 代码 : 
// 使 用 “as” 来 测试 兼容 性 
Hexagon hex2 = frank as Hexagon; 
if (hex2 == null) 
Console.Writeline("Sorry, frank is not a Hexagon..."); 
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6.6.2”C# 的 is 关 键 字 


由 于 GivePromotion() 方 法 被 设计 为 接受 任何 从 Employee 派 生 的 类 型 ， 你 可 能 会 想 ， 这 个 方法 怎么 
检测 传 到 方法 内 的 是 哪个 派生 类 型 呢 ? 还 有 ， 由 于 传人 参数 是 Employee 类 型 的 ， 我 们 怎么 能 访问 到 
SalesPerson 和 Manager 类 型 的 特殊 成 员 呢 ? 

除了 as 关 键 字 ，C# 语 言 还 提供 了 is 关 键 字 来 检测 两 个 项 是 否 兼 容 。 然 而 ， 和 as 关 键 字 不 同 的 是 ， 
如 果 类 型 不 兼容 ，is 关 键 字 就 返回 false 而 不 是 nul1 引 用 。 考 虑 如 下 GivepPromotion () 方 法 的 实现 : 


static void GivePromotion(Employee emp) 
Console.WritelLine("{0} was promoted!", emp.Name); 
if (emp is SalesPerson) 


Console.WriteLine("{o} made {1} sale(s)!", emp.Name, 
((SalesPerson)emp).SalesNumber); 
Console.WritelLine(); 


if (emp is Manager) 


Console.WriteLine("{0} had {1} stock options...", emp.Name, 
((Manager)emp).StockOptions); 
Console.WritelLine(); 
} 
} 


在 这 里 ,我 们 进行 了 一 个 运行 时 的 检查 来 检测 传人 的 基 类 引用 究 竞 指向 内 存 中 的 什么 。 在 检测 了 
是 否 收 到 SalesPerson 或 Manager 类 型 之 后 , 我 们 就 可 以 进行 显 式 强 制 转 换 来 获取 对 类 特有 成 员 的 访问 。 
还 要 注意 , 我 们 不 需要 使 用 try/catch 结 构 来 包装 我 们 的 强制 转换 操作 , 因为 我 们 知道 有 了 这 样 的 条 件 
检测 ， 代 码 在 if 区 域 中 的 强制 转换 一 定 是 安全 的 。 
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在 结束 本 章 之 前 ， 我 想 研 究 一 下 .NET 平 台中 超级 父 类 的 细节 : 0bject。 如 果 读 过 前 几 节 的 话 ， 你 
可 能 会 注意 到 ， 在 我 们 的 层次 结构 ( Car 、Shape 、Employee ) 中 从 来 就 没有 显 式 指定 过 它们 的 父 类 : 


// 谁 是 Car 的 父 类 
class Car 


We ; 

在 .NET 世 界 中 , 每 一 个 类 型 最 终 都 会 从 一 个 叫 system.0bject ( 可 以 用 C# 关 键 字 object 表 示 ) 的 基 
类 派生 。0bject 类 定义 了 一 组 框架 中 所 有 类 型 公共 的 成 员 。 其 实 ， 如 果 我 们 构建 的 类 没有 显 式 定义 其 
父 类 ， 编 译 器 会 自动 从 0bject 派 生 我 们 的 类 型 。 如 果 我 们 想 很 明确 地 表述 自己 的 意图 ， 完 全 可 以 如 下 
定义 类 来 从 0bject 派 生 : 

// 从 System.0bject 显 式 派生 

class Car : object 

{...} 

和 其 他 类 一 样 , System.0bject 定 义 了 一 组 成 员 。 在 如 下 所 示 的 C# 定 义 中 , 某 些 项 被 声明 为 virtual ， 
它 指定 了 某 个 成 员 可 以 被 子 类 重 写 ， 而 其 他 项 标记 为 static ( 因此 只 能 在 类 级 别 进行 调用 ): 





194 第 6 章 继承 和 多 态 


public class Object 
{ 


// 虚 成 员 

public virtual bool Equals(object obj); 
protected virtual void Finalize(); 
public virtual int GetHashCode(); 
public virtual string ToString(); 


// 实例 级 别 ， 非 虚 成 员 
public Type GetType(); 
protected object MemberwiseClone(); 


// 静态 成 员 
public static bool Equals(object objA, object objB); 
public static bool ReferenceEquals(object objA, object objB); 


表 6-1 提 供 了 每 一 个 方法 功能 的 提纲 。 
表 6-1 System.Object 的 核心 成 员 


对 象 类 的 实例 方法 作 用 

Equals() 默认 情况 下 ， 如 果 被 比较 的 项 指向 内 存 中 同一 个 项 ， 则 方法 会 返回 true。 因 此 ，Equals() 
用 于 比较 对 象 引 用 ， 而 不 是 对 象 的 状态 。 一 般 情况 下 ， 这 个 方法 会 被 重 写 为 : 如 果 被 比 
较 的 对 象 有 相同 的 内 部 状态 值 ( 也 就 是 基于 值 的 语义 )， 则 返回 true 
要 知道 ， 如 果 重 写 Equals() ， 则 还 需要 重 写 GetHashCode() ， 因 为 这 些 方法 在 内 部 用 于 
Hashtable 类 型 从 容器 获取 子 对 象 
回忆 在 第 4 章 中 所 介绍 的 ，ValueType 类 为 所 有 结构 重 写 了 该 方法 ， 它 们 进行 的 比较 是 基 





于 值 的 

Finalize() 这 个 方法 (在 重 写 后 ) 在 对 象 销毁 之 前 被 调用 来 释放 所 有 分 配 的 资源 。 第 9 章 会 讨论 更 多 
有 关 CLR 的 垃圾 回收 服务 

GetHashCode() 这 个 方法 返回 int 来 标识 指定 的 对 象 实例 

ToString() 这 个 方法 使 用 cnamespace>.<type name> 格 式 ( 叫做 完全 限定 名 ) 返回 对 象 的 字符 串 表 示 。 
这 个 方法 可 以 被 子 类 重 写 来 返回 名 称 / 值 对 的 标识 字符 串 以 表示 对 象 的 内 部 状态 ,而 不 是 
它 的 完全 限定 名 

GetType() 这 个 方法 返回 Type 对 象 ， 它 完整 描述 当前 指向 的 对 象 。 简 而 言 之 ,这 是 所 有 对 象 都 可 用 


的 运行 时 类 型 标识 方法 ( RTTI， 在 第 15 章 中 会 讨论 更 多 细节 ) 
MemberwiseClone() 这 个 方法 的 作用 是 逐个 成 员 地 返回 当前 对 象 的 副本 ， 通 常用 于 克隆 对 象 ( 见 第 8 章 ) 


为 了 演示 0bject 基 类 提供 的 一 些 默认 行为 ， 新 建 一 个 叫 ObjectOverrides 的 控制 台 应 用 程序 。 插 入 
一 个 新 的 C# 类 文件 ， 其 中 包含 如 下 叫 Person 的 空 类 定义 : 


// 记 住 ! Person 扩 展 0bject 
class Person {} 


现在 ， 更 新 我 们 的 Main() 方 法 来 和 从 System.0bject 继 承 的 成 员 进 行 交互 ， 具 体 如 下 所 示 : 
class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with System.Object *****\n"); 
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Person p1 = new Person(); 


// 使 用 System.0bject 的 继承 成 员 
Console.WriteLine("ToString: {0}", p1.ToString()); 
Console.WriteLine("Hash code: {0}", p1.GetHashCode()); 
Console.WritelLine("Type: {0}", p1.GetType()); 


// 让 其 他 引用 指向 p1 
Person p2 = p1; 
object o = p2; 


// 引用 指向 内 存 中 的 相同 对 象 吗 
if (o.Equals(p1) && p2.Equals(o)) 


Console.WritelLine("Same instance!"); 


Console.ReadLine(); 
} 
} 


当前 Main() 方 法 的 输出 结果 如 下 所 示 : 





沙沙 冰冰 炒 Fun With System.0Object 冰冰 冰冰 


ToString: ObjectOverrides.Person 
Hash code: 46104728 

Type: ObjectOverrides.Person 
Same instance! 





首先 ， 注 意 ToString() 的 默认 实现 如 何 返回 当前 类 型 的 完全 限定 名 ( 0bjectOverrides.Person )。 
在 之 后 对 构建 自 定义 命名 空间 的 研究 中 我 们 会 看 到 ( 见 第 14 章 )， 每 一 个 C# 项 目 都 定义 了 “ 根 命 名 空 
间 ”， 它 和 项 目 本 身 同名 。 在 这 里 ， 我 们 创建 了 一 个 叫 ObjectOverrides 的 项 目 ， 因 此 person 类 型 ( 以 及 
Program 类 ) 都 在 0bjectOverrides 命 名 空间 内 。 

Equals() 的 默认 行为 用 来 测试 两 个 变量 是 不 是 指向 内 存 中 的 同一 对 象 。 创建 一 个 新 的 Person 变 量 ， 
名 为 pl1。 至 此 ， 在 托管 堆 中 就 有 了 一 个 新 的 Person 对 象 。p2 也 是 Person 类 型 的 。 然 而 ， 我 们 创建 的 不 
是 新 实例 ， 而 是 将 变量 赋值 为 p1 的 引用 。 因 此 ，p1 和 p2 都 指向 内 存 中 的 相同 对 象 ， 就 像 变 量 o ( object 
类 型 ， 用 来 做 测试 ) 一 样 。 由 于 p1、p2 和 o 都 指向 相同 的 内 存 位置 ， 所 以 相等 性 测试 成 功 了 。 

尽管 System.0bject 内 置 的 行为 能 满足 很 多 需要 , 但 是 对 我 们 的 自 定义 类 型 来 说 , 重 写 一 些 继承 方 
法 很 常见 。 为 了 举例 说 明 ， 更 新 Person 类 来 支持 一 些 表 示 个 体 姓 、 名 字 和 年 龄 的 状态 数据 ， 并 且 每 一 
个 都 可 以 通过 自 定义 构造 函数 来 设置 。 


// 记 住 ，Person 扩 展 了 0bject 
class Person 


public string FirstName { get; set; } 
public string LastName { get; set; } 
public int Age { get; set; } 


public Person(string fName, string lName, int personAge) 


FirstName = fName; 
LastName = lName; 
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Age = personAge; 


public Person(){} 


6.7.1 重 写 System.0bject.ToString() 


我 们 创建 的 许多 类 ( 和 结构 ) 都 可 以 通过 重 写 TosString() 返 回 类 型 当前 状态 的 字符 串 表 示 形 式 来 
受益 。 这 对 于 调试 ( 由 于 其 他 原因 ) 来 说 很 有 用 。 至 于 如 何 构 建 这 个 字符 串 , 就 看 个 人 喜好 了 ， 然而， 
推荐 的 方式 是 使 用 分 号 来 分 割 每 一 个 名 称 / 值 对 并 且 在 方 括号 中 包装 整个 字符 串 ( .NET 基 础 类 库 中 的 
很 多 类 型 都 遵循 这 个 方式 )。 下 面 是 Person 类 重 写 ToString() 的 代码 : 


public override string ToString() 


string myState; 

myState = string.Format("[First Name: {0}; Last Name: {1}; Age: {2}]", 
FirstName, LastName, Age); 

return myState; 


因为 person 类 只 有 3 个 状态 数据 ， 所 以 Tostring() 的 实现 非常 直接 。 然 而 ， 始 终 记 住 ， 正 确 的 
ToString() 重 写 应 该 还 说 明 继 承 链 上 定义 的 任何 数据 。 

如 果 重 写 Tostring() 让 某 个 类 来 扩展 自 定 义 基 类 ， 第 一 件 事情 就 是 使 用 base 关 键 字 从 基 类 获取 
ToString() 值 。 获 取 了 父 类 的 字符 串 数据 之 后 ， 就 可 以 追加 派生 类 的 自 定义 信息 。 


6.7.2 重 写 System.0bject.Equals() 


让 我 们 也 重 写 0bject.Equals() 的 行为 来 使 用 基于 值 的 语义 。 回 忆 一 下 , 在 默认 情况 下 ， 只 有 当 被 
比较 的 两 个 对 象 引用 内 存 中 相同 的 对 象 实例 时 才 会 返回 true。 对 于 Person 类 ， 两 个 要 比较 的 变量 包含 
相同 状态 值 时 ， 实 现 Equals() 返 回 true 可 能 会 很 有 用 (例如 ， 姓 、 名 和 年 龄 )。 

首先 ， 注 意 Equals() 方 法 的 传人 参数 是 普通 System.0bject。 因 此 ， 第 一 件 事 就 是 要 确保 调用 者 确 
实 传 人 了 Person 对 象 ， 并 且 作 为 额外 的 安全 措施 ， 还 要 确保 传人 参数 不 是 空 引用 。 

只 要 确定 调用 者 传人 的 是 已 分 配 的 Person， 实 现 Equals() 的 方法 就 是 对 传人 对 象 的 数据 和 当前 对 
象 的 数据 进行 逐 字段 的 比较 。 

public override bool Equals(object obj) 

rT (obj is Person && obj != null) 


Person temp; 

temp = (Person)obj; 

if (temp.FirstName == this.FirstName 
&& temp.LastName == this.LastName 
&& temp.Age == this.Age) 


return true; 
else 


return false; 
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} 


return false; 


在 这 里 ， 我 们 检查 传人 对 象 和 内 部 值 (使 用 this 关 键 字 ) 的 值 。 如 果 两 者 的 名 字 和 年 龄 相同 ,我 
们 就 认为 这 两 个 对 象 状 态 相同 并 因此 返回 true。 任 何其 他 可 能 性 都 会 返回 false。 

虽然 这 个 方法 确实 可 行 ， 但 是 我 们 想 一 下 ， 对 于 一 个 包含 几 十 个 数据 字段 的 类 型 来 说 ， 我 们 要 花 多 
少 功夫 来 实现 自 定义 的 Equals() 方 法 啊 。 一 个 公共 的 快捷 方式 就 是 利用 我 们 自己 的 Tostring() 实 现 。 如 果 
类 的 Tostring() 方 法 正确 实现 ， 解 释 继承 链 中 所 有 字段 数据 的 话 ， 就 只 需要 比较 对 象 的 字符 串 数 据 即 可 : 

public override bool Equals(object obj) 


{ 
// 不 需要 将 obj 强 制 转 换 为 Person， 因 为 它们 都 有 ToString() 方 法 
return obj.ToString() == this.ToString(); 


注意 ， 在 这 种 情况 下 我 们 没有 必要 检查 传人 参数 的 类 型 是 否 正确 (本 例 中 为 Person )， 因 为 .NET 
中 任何 类 型 都 支持 Tostring() 方 法 。 更 棒 的 是 ， 我 们 没有 必要 逐个 检查 属性 是 否 相 等 ， 因 为 我 们 并 不 
是 简单 地 比较 Tostring() 的 返回 值 。 


6.7.3” 重 写 System.0bject.GetHashCode() 


如 果 一 个 类 重 写 了 Equals() 方 法 ， 我 们 还 需要 重 写 默 认 的 GetHashCode() 实 现 。 简 单 来 说 ， 散 列 码 
是 表示 对 象 某 个 状态 的 数字 值 。 例 如 ， 如 果 创 建 两 个 字符 串 对 象 来 保存 Hello 值 ， 应 该 得 到 同样 的 散 
列 码 。 然 而 ， 如 果 一 个 string 全 是 小 写 〈hello )， 就 会 得 到 不 同 的 散 列 码 。 

默认 情况 下 ，System.0bject.GetHashCode() 使 用 对 象 在 内 存 中 的 当前 位 置 来 产生 散 列 值 。 然 而 ， 
如 果 我 们 构建 要 保存 在 Hashtable 类 型 ( 在 System.Collections 命 名 空间 内 ) 中 的 自 定义 类 型 ， 就 应 该 重 
写 这 个 成 员 ， 因 为 Hashtable 会 在 内 部 调用 Equals() 和 GetHashCode() 来 获取 正确 的 对 象 。 


说 明 有 具体 来 说 ，System.Collections.Hashtable 类 在 内 部 调用 GetHashCode() 来 获取 对 象 的 位 置 ， 然 
后 (内 部 ) 调用 Equals() 进 行 精确 的 匹配 。 


尽管 我 们 不 打算 把 Person 放 到 System.Collections.Hashtable 中 ， 但 为 了 完整 性 ， 还 是 重 写 一 下 
GetHashCode()。 有 很 多 算法 可 以 用 来 创建 散 列 码 ， 一 些 很 复杂 ， 一 些 不 是 那么 复杂 。 大 多 数 情况 下 ， 
我 们 可 以 利用 System.String 的 GetHashCode() 实 现 来 生成 散 列 码 的 值 。 

由 于 String 类 已 经 有 完善 的 散 列 码 算法 来 使 用 string 的 字符 数据 计算 散 列 值 ， 因 此 如 果 类 的 某 个 
字段 数据 与 其 他 所 有 实例 都 不 相同 ( 如 社会 保险 号 码 )， 就 只 需要 对 这 些 字 段 数据 点 调用 
GetHashCode()。 这 样 ， 如 果 Person 类 定义 了 SSN 属 性 ， 可 以 编写 如 下 代码 : 


// 假 设 有 一 个 这 样 的 SSN 属 性 
class Person 





public string SSN {get; set;} 


// 基 于 唯一 字符 事 数 据点 返回 散 列 代码 
public override int GetHashCode() 
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return SSN.GetHashCode(); 
| 
如 果 不 能 找到 唯一 的 字符 串 数据 点 ， 而 你 已 经 重 写 了 ToString()， 可 以 在 自己 的 字符 串 表 示 上 调 
用 GetHashcode(): 
// 根据 person 的 ToString() 值 返回 散 列 码 
public override int GetHashCode() 


return this.ToString().GetHashCode(); 


6.7.4 测试 修改 后 的 Person 类 
我 们 已 重 写 了 object 的 虚 成 员 ， 现 在 更 新 Main() 方 法 来 测试 我 们 的 更 新 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with System.Object *****\n"); 


// 说 明 : 我 们 希望 这 些 都 一 致 ， 以 便 测试 Equals() 和 GetHashCode() 方 法 
Person p1 = new Person("Homer", "Simpson", 50); 
Person p2 = new Person("Homer", "Simpson", 50); 


// 获取 对 象 的 事 行 版 本 
Console.WritelLine("p1.ToString() = {0 
Console.WriteLine("p2.ToString() = {0 


// 测试 重 写 的 Equals() 
Console.WriteLine("p1 = p2?: {0}", p1.Equals(p2)); 


// 测试 散 列 码 
Console.WriteLine("Same hash codes?: {0}", pi1.GetHashCode() == p2.GetHashCode()); 
Console.WriteLine(); 


// 修改 p2 的 年 龄 并 再 次 测试 

p2.Age = 45; 

Console.WriteLine("p1.ToString() = {0}", pi1.ToString()); 
Console.WritelLine("p2.ToString() = {0}", p2.ToString()); 

Console.WritelLine("p1 = p2?: {0}", p1.Equals(p2)); 

Console.WriteLine("Same hash codes?: {0}", p1.GetHashCode() == p2.GetHashCode()); 
Console.ReadLine(); 


】 
输出 结果 如 下 所 示 : 


}", pi1.ToString()); 
}", p2.ToString()); 





半 本 冰 水 来 FU with System.0Object 水 站 本 本 水 


p1.ToString() = [First Name: Homer; Last Name: Simpson; Age: 50] 
p2.ToString() = [First Name: Homer; Last Name: Simpson; Age: 50] 
p1 = p2?: True 

Same hash codes?: True 


p1.Tostring() = [First Name: Homer; Last Name: Simpson; Age: 50] 
p2.ToString() = [First Name: Homer; Last Name: Simpson; Age: 45] 
p1 = p2?: False 

Same hash codes?: False 
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6.7.5 ”System.0bject 的 静态 成 员 

除了 刚才 研究 的 实例 级 别 的 成 员 之 外 ，System.0bject 还 定义 了 两 个 (非常 有 用 的 ) 静态 成 员 来 测 
试 基于 值 或 基于 引用 的 相等 性 。 考 虑 如 下 代码 : 

static void StaticMembersOfObject() 


// System.0bject 的 静态 成 员 

Person p3 = new Person("Sally", "Jones", 4); 

Person p4 = new Person(" Sally", "jones", 4f)’ 

Console.WritelLine("P3 and P4 have same state: {0}", object. Equals(p3, p4)); 

Console.WritelLine("P3 and P4 are pointing to same object: {0}", 
object.ReferenceEquals(p3, p4)); 


在 这 里 ， 我 们 只 需要 传人 两 个 对 象 ( 任何 类 型 ) 并 允许 System.0bject 类 自动 检测 细节 。 


源 代码 ”ObjectOverrides 项 目的 源 代码 位 于 Chapter 6 子 目录 下 。 


6.8 小结 

本 章 研 究 了 继承 和 多 态 的 作用 和 细节 。 通 过 这 些 内 容 , 我 们 学 习 了 许多 支持 这 些 技术 的 新 关键 字 
和 标记 。 例 如 ， 冒 号 用 于 创建 某 个 类 型 的 父 类 。 父 类 型 可 以 定义 许多 虚 的 或 抽象 的 成 员 来 创建 多 态 接 
口 。 派 生 类 型 使 用 override 关 键 字 重 写 这 些 成 员 。 

除了 构建 许多 类 继承 之 外 ， 本 章 还 研究 了 如 何在 基 类 类 型 和 派生 类 型 之 间 显 式 转换 ， 最 后 我 们 
以 .NET 基 础 类 库 中 超级 父 类 System.0bject 的 细节 来 结束 本 章 的 内 容 。 
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章 主要 讲解 使 用 结构 化 异常 处 理 ( SEH，Structured Exception Handling ) 来 处 理 C# 代 码 中 的 

运行 时 异常 。 读 者 不 仅 要 学 习 try、catch、throw、finally 等 处 理 异常 的 C# 关 键 字 ， 还 要 了 
解 应 用 程序 级 异常 与 系统 级 异常 的 区 别 以 及 System.Exception 基 类 ， 其 中 还 将 介绍 创建 自 定义 异常 和 
如 何 利用 Visual Studio 异常 调试 工具 等 主题 。 


7.1 错误 、bug 与 异常 


尽管 有 时 候 有 点 自负 ., 但 我 们 还 是 清楚 , 没有 一 个 程序 员 是 完美 的 。 编写 软件 是 一 项 复杂 的 工作 ， 
正 是 由 于 这 种 复杂 性 ， 即 使 是 最 好 的 软件 也 经 常 伴随 着 各 种 各 样 的 问题 。 有 时 候 问题 是 由 糟糕 的 代码 
引起 的 〈 比如 溢出 数组 的 范围 )， 有 时 候 问 题 又 是 由 应 用 程序 代码 库 未 考虑 到 的 用 户 错误 输入 引起 的 
(比如 说 ， 将 一 个 电话 号 码 字段 赋值 为 “Chucky”)。 不 管 是 何 种 原因 ， 最 终 都 会 导致 应 用 程序 无 法 按 
照 预 期 正常 运行 。 为 了 给 下 面 讲述 的 结构 化 异常 处 理 做 个 铺垫 ， 我 们 首先 为 3 种 常用 来 表述 异常 的 术 
语 下 定义 。 
口 bug: 简单 来 说 ,这 是 由 程序 员 一 方 引 起 的 错误 。 举 例 来 说 ， 假 定 我 们 在 进行 非 托 管 C++ 编 程 ， 
如 果 删 除 已 分 配 的 内 存 失败 ( 从 而 导致 内 存 泄漏 )， 就 会 产生 一 个 bug。 
口 用 户 错误 : 与 bug 不 同 ， 用 户 错误 往往 不 是 由 应 用 程序 作者 而 是 由 运行 程序 的 用 户 引起 的 。 例 
如 ， 如 果 你 在 代码 中 没有 处 理 错误 输入 ， 当 最 终 用 户 在 文本 框 中 输入 格式 非法 的 字符 串 时 ， 
很 可 能 会 产生 用 户 错误 。 
口 异常 : 异常 往往 是 运行 时 的 非 正 常情 况 ， 在 编程 时 很 难 被 估计 到 。 异 常 可 能 包括 试图 连接 一 
个 已 经 不 存在 的 数据 库 ， 打 开 已 被 破坏 的 XML 文件 ， 连 接 当前 处 于 离线 状态 的 机 器 等 。 在 上 
述 各 种 情况 下 ， 程 序 员 和 最 终 用 户 都 无 法 完全 控制 这 些 异 常情 况 。 
通过 上 面 的 定义 ， 可 以 很 清楚 地 看 到 .NET 结 构 化 异常 处 理 是 一 项 很 适合 处 理 运行 时 异常 的 技术 。 
然而 至 于 我 们 难以 预料 的 bug 和 用 户 错误 ，CLR 常 常会 引发 相应 的 异常 来 识别 相应 的 问题 。.NET 基 础 
类 库 定 义 了 诸如 FormatException 、IndexOutOfRangeException、FileNotFoundException 、ArgumentOutOf- 
RangeException 等 数量 众多 的 异常 。 
在 .NET 术 语 命名 法 中 ,“ 蜡 常 ”解释 为 bug、 用 户 错 误 输 入 和 运行 时 错误 , 尽管 程序 员 认为 这 是 
3 个 各 不 相同 的 问题 。 在 大 步 前 进 之 前 ， 需 要 先 明 确 结构 化 异常 处 理 的 作用 ， 同 时 对 比 一 下 它 和 传统 
错误 处 理 技术 有 什么 不 同 之 处 。 
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说 明 为 了 使 本 书 中 代码 示例 尽 可 能 简洁 ， 我 将 不 会 捕获 每 种 基础 类 库 中 指定 方法 可 能 引发 的 异常 。 
在 你 的 产品 级 项 目 中 ， 当 然 需要 灵活 使 用 本 章 中 提 到 的 各 种 技术 。 





7.2 .NET 异常 处 理 的 作用 


在 .NET 之 前 ，Windows 操 作 系 统 下 的 错误 处 理 技 术 是 比较 混乱 的 。 很 多 程序 员 都 自己 开发 错误 处 
理 逻 辑 ， 只 适用 于 给 定 的 应 用 程序 上 下 文 。 例 如 ,一 个 开发 团队 可 能 定义 一 系列 数字 常量 来 表示 已 知 
的 错误 情况 ， 并 利用 它们 作为 方法 的 返回 值 。 我 们 以 下 面 这 段 C 程 序 代码 为 例 : 

/* 一 种 典型 的 C 语 言 风格 错误 捕获 机 制 */ 

#define E_FILENOTFOUND 1000 


int SomeFunction() 


// 假定 这 个 函数 中 进行 的 操作 导致 了 如 下 的 返回 值 
return E_FILENOTFOUND 
} 


void main() 


int retVal = SomeFunction(); 
if(retVal == E_FILENOTFOUND) 
printf("Cannot find file..."); 


由 于 E_FILENOTFOUND 常 量 比 数字 常量 好 不 到 哪里 去 ， 这 种 方案 并 不 理想 ， 离 有 效 处 理 这 个 问题 的 
目标 还 很 远 。 理 想 情 况 下 ， 我 们 可 能 希望 将 这 个 错误 的 名 称 、 消 息 和 其 他 的 有 用 信息 都 打 进 一 个 定义 
明确 的 包 内 ( 这 正 是 结构 化 异常 处 理 所 做 的 )。 

为 处 理 错 误 , 除了 开发 人 员 的 临时 方案 之 外 ，Windows API 通 过 #define 、HRESULT 等 还 定义 了 成 百 
上 千 的 错误 代码 和 基于 简单 布尔 变量 的 各 种 变形 ( boo1、B00L、VARIANT_B00L 等 ), 此 外 , 许多 C++ COM 
开发 人 员 利 用 一 小 组 标准 COM 接 口 ( 例如 ISupportErrorInfo、 IErrorInfo、ICreateErrorInfo ) 给 COM 
客户 端 返 回 有 意义 的 错误 信息 。 

这 些 早期 技术 有 个 明显 的 问题 : 极其 缺乏 对 称 性 。 每 种 方案 差不多 都 是 为 指定 技术 、 指 定语 言 甚 
至 指定 项 目 而 定制 的 。 为 了 打破 这 种 局 面 ,, NET 平台 提供 了 一 种 标准 的 技术 来 发 送 和 捕获 运行 时 错误 ， 
这 就 是 结构 化 异常 处 理 ( SEH )。 

结构 化 异常 处 理 方案 的 优点 在 于 , 开发 人 员 现 在 有 了 统一 的 而 且 对 .NET 领 域内 各 种 语言 都 通用 的 
方式 来 处 理 错误 。 因 此 ， 一 个 C# 程 序 员 处 理 错误 的 方法 和 VB 程序 员 、 使 用 C+HMCLI 的 C++ 程序 员 处 理 
错误 的 方法 在 语法 上 相似 。 

更 棒 的 是 ,用 以 引发 和 捕获 异常 的 语法 在 不 同 程序 集 间或 计算 机 间 都 是 一 致 的 。 例 如 ， 如 果 使 用 
C# 构 建 WCF 服 务 ， 可 以 向 远程 调用 者 抛 出 一 个 SOAP 错 误 ， 而 使 用 的 关键 字 与 在 同一 个 应 用 中 的 方法 
之 间 抛 出 异常 的 关键 字 完 全 相同 。 

:NET 异常 的 男 一 好 处 是 , 我 们 不 再 是 通过 接收 意义 模糊 的 数字 常量 来 确定 问题 , 而 是 可 以 通过 异 
常 ， 它 们 包含 容易 读 懂 的 问题 描述 信息 和 首次 触发 异常 时 调用 栈 的 详细 快照 。 此 外 ,我 们 还 能 够 为 最 
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终 用 户 提供 相应 的 帮助 链接 信息 ,将 他 们 引 向 一 个 URL， 其 中 包含 相应 错误 的 详细 信息 和 程序 员 自 定 
义 的 数据 。 


7.2.1 .NET 异 常 处 理 的 四 要 素 


结构 化 异常 处 理 编程 要 使 用 4 个 互相 关联 的 实体 : 

口 一 个 表示 异常 详细 信息 的 类 类 型 ; 

口 一 个 向 调用 者 抛 出 异常 类 实例 的 成 员 ; 

口 调用 者 的 一 段 调用 异常 成 员 的 代码 块 ; 

口 调用 者 的 一 段 处 理 (或 捕获 ) 将 要 发 生 异 常 的 代码 块 。 

C# 编 程 语言 提供 了 4 个 允许 我 们 引发 和 处 理 异 常 的 关键 字 : try、catch、throw 和 finally。 用 来 表 
示 问 题 的 类 型 是 一 个 继承 自 (或 派生 自 ) System.Exception 的 类 。 下 面 ， 了解 一 下 异常 处 理 基 类 的 作用 。 


7.2.2 ”System.Exception 基 类 


所 有 用 户 定 义 和 系 统 定义 的 异常 最 终 都 继承 自 Ssystem.Exception 基 类 ( 它 继承 自 System.0bject 基 
类 )。 这 个 类 的 代码 如 下 (请 注意 其 中 有 些 成 员 是 虚 的 ， 这 样 就 可 能 被 派生 类 型 重 写 ): 


public class Exception : ISerializable, Exception 


{ 
// 公有 的 构造 函数 
public Exception(string message, Exception innerException); 
public Exception(string message); 
public Exception(); 


// 方法 

public virtual Exception GetBaseException(); 

public virtual void GetObjectData(SerializationInfo info, 
StreamingContext context); 


// 属性 

public virtual IDictionary Data { get; } 
public virtual string HelpLink { get; set; } 
public Exception InnerException { get; } 
public virtual string Message { get; } 
public virtual string Source { get; set; } 
public virtual string StackTrace { get; } 
public MethodBase TargetSite { get; } 


可 见 ，System.Exception 定 义 的 很 多 属性 是 只 读 的 。 很 明显 ， 这 是 由 于 派生 类 型 将 给 每 个 属性 提 
供 默 认 的 值 。 例 如 ，Index0ut0fRangeException 类 型 的 默认 信息 就 是 “索引 超出 数组 范围 ”。 


说 明 ” ”Exception 类 实现 了 两 个 ,NET 接口 。 尽管 我 们 还 没有 研究 接口 ( 见 第 8 章 ), 只 是 理解 Exception 
接口 允许 非 托管 代码 库 ( 如 COM 应 用 程序 ) 处 理 .NET 异 常 ， 而 ISerializable 接 口 允许 异常 对 
象 跨 边界 ( 如 机 器 边界 ) 持久 化 。 
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表 7-1 详 细 描 述 了 System.Exception 最 重要 的 成 员 。 
表 7-1 System.Exception 类 型 的 核心 成 员 


System.Exception 属 性 作 用 
”Data ”此 属性 返回 一 个 键 / 值 对 集合 (表示 为 一 个 实现 IDictionary 接 口 的 对 象 ), 提供 有 关 该 异 
常 的 更 多 程序 员 定 义 信 息 。 该 集合 默认 情况 下 为 空 
HelpLink 此 属性 返回 一 个 URL， 指 向 包含 详细 错误 信息 描述 的 帮助 文件 或 网 站 
InnerException 此 属性 为 只 读 ， 可 用 来 获取 导致 当前 异常 发 生 的 上 一 个 (或 上 一 组 ) 异常 的 相关 信息 。 
上 一 个 (或 上 一 组 ) 异常 作为 参数 被 传人 当前 异常 的 构造 函数 而 被 记录 下 来 
Message 此 属性 为 只 读 ， 它 返回 指定 错误 的 文字 描述 。 错 误 信 息 本 身 就 是 构造 函数 的 一 个 参数 
Source 此 属性 返回 引发 该 异常 的 程序 集 或 对 象 的 名 称 
StackTrace 此 属性 为 只 读 , 它 包含 一 个 标识 触发 异常 调用 序列 的 字符 串 。 可 以 想象 , 在 调试 过 程 中 ， 
或 者 要 将 错误 转 储 到 外 部 错误 日 志 中 时 ， 这 个 属性 非常 有 用 
TargetSite 此 属性 为 只 读 ， 它 返回 一 个 MethodBase 对 象 ， 其 中 描述 了 引发 异常 的 方法 的 许多 细节 


(ToString() 方 法 将 通过 名 称 标识 该 方法 ) 
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为 了 阐述 结构 化 异常 处 理 的 用 处 , 需要 创建 一 个 在 适当 情况 下 可 能 引发 异常 的 类 。 假定 已 经 创建 
了 一 个 名 为 SimpleException 的 新 的 控制 台 应 用 程序 项 目 ， 其 中 定义 了 两 个 类 一 一 Car 和 Radio， 这 两 个 
类 之 间 是 拥有 (〈 has-a ) 关系 。Radio 类 定义 了 一 个 打开 或 关闭 Radio 的 方法 。 


class Radio 
public void TurnOn(bool on) 
{ 


if(on) 
Console.Writeline("Jamming..."); 
else 
Console.WriteLine("Quiet time..."); 
} 
} 
除了 通过 包含 /委托 来 使 用 Radio 类 之 外 ，Car 类 是 如 此 定义 的 : 如 果 用 户 加 速 一 个 Car 对象 超 过 预 
先 定义 的 最 大 速度 ( 通过 一 个 名 为 MaxSpeed 的 常量 成 员 来 指定 ), Car 的 引擎 会 爆炸 , 使 car 不 能 再 用 ( 通 
过 一 个 名 为 carIsDead 的 私有 布尔 变量 成 员 指 定 )。 
除 此 之 外 ，Car 类 型 还 拥有 几 个 成 员 变 量 ,分 别 表示 当前 速度 、 用 户 提供 的 昵称 以 及 不 同 的 构造 
函数 ， 用 来 设置 新 的 Car 对 象 的 状态 。 下 面 是 完整 的 定义 ， 其 中 包括 代码 注释 : 


class Car 


// 表示 最 大 速度 的 常量 
public const int MaxSpeed = 100; 


// Car 属 性 
public int CurrentSpeed {get; set;} 
public string PetName {get; set;} 
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// Car 是 否 仍 可 以 操纵 
private bool carIsDead; 


// 每 个 Car 拥 有 一 个 Radio 
private Radio theMusicBox = new Radio(); 


// 构造 函数 
public Car() {} 
public Car(string name, int speed) 
{ 
CurrentSpeed = speed; 
PetName = name; 


} 


public void CrankTunes(bool state) 


// 委托 请 求 到 内 部 对 象 
theMusicBox.TurnOn(state); 


} 


// 查看 Car 是 否 过 热 
public void Accelerate(int delta) 


if (carIsDead) 
Console.WritelLine("{0} is out of order...", PetName); 
else 


{ 


CurrentSpeed += delta; 
if (CurrentSpeed > MaxSpeed) 


Console.WritelLine("{0} has overheated!", PetName); 
CurrentSpeed = 0; 
carIsDead = true; 
} 
else 
Console.WritelLine("=> CurrentSpeed = {0}", CurrentSpeed); 


} 
} 


现在 ,如 果 要 实现 一 个 如 下 所 示 的 强制 car 对 象 超过 预定 义 最 高 速度 ( 在 car 类 中 , 设 为 100 ) 的 Main() 
方法 : 


static void Main(string[] args) 

{ 
Console.WriteLine("***** Simple Exception Example *****"); 
Console.WritelLine("=> Creating a car and stepping on it!"); 
Car myCar = new Car("Zippy", 20); 
myCar.CrankTunes (true); 


for (int 1 = 0; 1 < 10; i++) 
myCar.Accelerate(10); 
Console.ReadLine(); 


} 
将 会 看 到 如 下 所 示 的 输出 结果 : 
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洲 炒 玉米 阔 Simple Exception Example 于 于 沙洲 
=> Creating a car and stepping on it! 
Jamming... 

=> CurrentSpeed = 30 

=> CurrentSpeed = 40 

=> CurrentSpeed = 50 

=> CurrentSpeed = 60 

=> CurrentSpeed = 70 

=> CurrentSpeed = 80 

=> CurrentSpeed = 90 

=> CurrentSpeed = 100 

Zippy has overheated! 

Zippy is out of order... 


see roca eee Reeceti ee ch tr EAT rd 


7.3.1 引发 普通 的 异常 


现在 有 了 可 以 工作 的 car 类 ,下 面 阐述 引发 一 个 异常 的 最 简单 方法 。 当 前 实现 的 Accelerate() 方 法 
在 调用 者 试图 加 速 到 car 对 象 的 速度 上 限 以 上 时 ， 显 示 一 条 错误 信息 。 

对 此 方法 做 些 改动 ， 如 果 用 户 在 车 坏 了 后 还 试图 加 速 汽车 ， 就 会 引发 异常 ， 我 们 将 创建 并 设 定 一 
个 新 的 System.Exception 类 的 实例 ， 并 通过 类 的 构造 郴 数 为 只 读 属 性 Message 赋 值 。 如 果 将 异常 对 象 返 
回 被 调用 者 ， 可 以 使 用 C# 中 的 throw 关 键 字 。 下 面 是 新 Accelerate() 方 法 的 相关 代码 : 


// 这 次 如 果 用 户 加 速 到 超过 最 大 速度 ， 就 会 引发 异常 
public void Accelerate(int delta) 


if (carIsDead) 
Console.WriteLine("{0} is out of order...", PetName); 
else 


CurrentSpeed += delta; 
if (CurrentSpeed >= MaxSpeed) 


carIsDead = true; 
CurrentSpeed = 0; 


// 使 用 throw 关 键 字 引 发 异常 
throw new Exception(string.Format("{0} has overheated!", PetName)); 


else 
Console.Writeline("=> CurrentSpeed = {0}", CurrentSpeed); 


} 

在 检查 调用 者 如 何 捕获 这 个 异常 之 前 ， 有 很 多 有 意思 的 地 方 需要 注意 。 首 先 ， 如 果 我 们 引发 一 个 
异常 , 总 是 由 我 们 来 决定 所 引发 的 问题 和 何 时 引发 异常 。 这 里 , 假定 程序 试图 加 速 一 辆 已 失效 的 坏 车 ， 
就 要 引发 一 个 System.Exception 对 象 ， 以 表示 Accelerate() 方 法 无 法 继续 (事实 上 这 个 假定 可 能 是 无 效 
的 ,需要 根据 你 创建 的 应 用 程序 来 决定 )。 

另 一 种 可 供 选 择 的 方案 是 ， 可 以 在 Accelerate() 方 法 中 实现 自动 恢复 ， 而 无 需 立 即 引发 异常 。 一 
般 情况 下 ,异常 应 当 仅 仅 在 一 个 较为 致命 的 条 件 满足 后 引发 ( 比如 未 发 现 必 要 的 文件 ， 连 接 数据 库 失 
败 等 )。 决 定 什么 条 件 下 引发 异常 是 我 们 必须 应 对 的 一 个 设计 问题 。 当 前 假定 要 求 对 这 个 已 坏 的 汽车 
继续 加 速 ， 以 构成 一 个 引发 异常 的 条 件 。 
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7.3.2 ”捕获 异常 


因为 Accelerate() 方 法 现在 引发 了 异常 ， 调 用 者 需要 做 好 准备 来 处 理 可 能 发 生 的 异常 。 当 调用 一 
个 可 能 引发 异常 的 方法 时 , 应 当 使 用 try/catch 块 。 一 旦 捕获 到 异常 对 象 , 将 能 够 调用 异常 对 象 成 员 来 
释放 问题 的 详细 信息 。 

如 何 处 理 这 份 数据 取决 于 我 们 自己 。 你 可 能 希望 将 其 记录 到 报告 文件 里 ， 写 进 Windows 事 件 日 志 
里 ， 发 电子 邮件 给 系统 管理 员 或 者 将 问题 显示 给 最 终 用 户 。 这 里 ， 我 们 就 将 其 输出 到 控制 台 窗 口上 : 


// 处 理 引发 的 异常 
static void Main(string[] args) 


Console.Writeline("***** Simple Exception Example *****"); 
Console.WritelLine("=> Creating a car and stepping on it!"); 
Car myCar = new Car("Zippy", 20); 

myCar.CrankTunes (true); 


// 加 速 车 到 超过 最 大 速度 以 触发 异常 
try 


for(int i = 0; i < 10; i++) 
myCar. Accelerate(10); 


catch(Exception e) 
{ 


Console.WritelLine("\n*** Error! ***"); 

Console. WriteLine( Method: {0}" )e。 TargetSite); 
Console.WriteLine("Message: {0}", e.Message); 
Console.WriteLine("Source: {0}", e.Source); 


// 异常 被 处 理 了 ， 转 到 下 一 个 语 向 
Console.WritelLine("\n***** Out of exception logic *****"); 
Console.ReadLine(); 


} 

其 实 ，try 块 是 执行 过 程 中 可 能 引发 异常 的 语句 的 一 部 分 。 如 果 检 测 到 一 个 异常 ， 程 序 执行 流 进 
入 相应 的 catch 块 中 。 另 一 方面 ， 如 果 try 抉 内 包含 的 代码 没有 触发 异常 ， 相 应 的 catch 代 码 块 就 被 直接 
略 过 ， 说 明 一 切 正常 。 下 面 的 输出 结果 显示 了 运行 这 个 程序 的 一 个 测试 。 


**A*** Simple Exception Example 灶 半 冰冰 
=> Creating a car and stepping on it! 
Jamming... 











=> CurrentSpeed = 30 
=> CurrentSpeed = 40 
=> CurrentSpeed = 50 
=> CurrentSpeed = 60 
=> CurrentSpeed = 70 
=> CurrentSpeed = 80 
=> CurrentSpeed = 90 


i So 光 机 

Method: Void Accelerate(Int32) 
Message: Zippy has overheated! 
Source: SimpleException 


半 水 水 冰 水 :Out of exception logiC ***** 
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正如 你 所 见 ， 当 一 个 异常 经 过 处 理 后 ， 应 用 程序 将 继续 执行 catch 块 之 后 的 代码 。 在 有 些 情况 下 ， 
一 个 异常 可 能 严重 到 可 以 终止 程序 的 运行 。 然 而 大 多 数 情况 下 ， 蜡 常 处 理 包 含 的 逻辑 将 保证 应 用 程序 
顺畅 地 运行 ( 尽管 它 可 能 丧失 了 部 分 功能 ， 比 如 无 法 链接 到 远程 数据 源 )。 


7.4 配置 异常 的 状态 


现在 ,Accelerate() 方 法 内 配置 的 System.Exception 对 象 已 经 通过 构造 函数 参数 创建 了 一 个 公开 给 
Message 属 性 的 值 ,然而 , 如 前 面 的 表 7-1 所 示 , Exception 类 还 会 提供 其 他 成 员 ( TargetSite、 StackTrace、 
HelpLink 和 Data )， 这 些 成 员 在 需要 进一步 界定 问题 本 质 时 很 有 用 。 为 了 完善 当前 的 示例 ,让 我 们 逐一 
深入 查看 这 些 成 员 的 细节 。 


7.4.1 TargetSite 属 性 


System.Exception.TargetSite 属 性 帮助 我 们 了 解 引 发 某 个 异常 的 方法 的 各 种 信息 。 就 像 在 前 面 
Main() 方 法 中 呈现 的 那样 ， 输 出 TargetSite 的 值 将 显示 返回 值 类 型 、 名 称 、 引 发 异常 方法 的 参数 。 可 
是 ，TargetSite 不 是 只 返回 华而不实 的 字符 串 ， 而 是 返回 一 个 强 类 型 的 System.Reflection.MethodBase 
对 象 。 这 种 类 型 可 用 于 收集 引发 异常 的 方法 以 及 定义 引发 异常 的 方法 的 类 的 许多 信息 。 假 定 我 们 的 上 
一 个 catch 逻 辑 更 新 为 如 下 代码 : 


static void Main(string[] args) 


1 TargetSite 实 际 上 返回 一 个 MethodBase 对 象 
catch(Exception e) 


Console.WriteLine("\n*** Error! ***"); 

Console.WriteLine("Member name: {0}", e.TargetSite); 

Console.WriteLine("Class defining member: {0}", 
e.TargetSite.DeclaringType); 

Console.WriteLine("Member type: {0}", e.TargetSite.MemberType); 

Console.WritelLine("Message: {0}", e.Message); 

Console.WritelLine("Source: {0}", e.Source); 


Console.WriteLine("\n***** Out of exception logic *****"); 
Console.ReadLine(); 


在 这 里 ， 我 们 使 用 MethodBase.DeclaringType 属 性 值 来 指定 引发 异常 的 类 的 全 称 ( 这 个 例子 中 为 
SimpleException.Car )， 使 用 MethodBase 对 象 的 MemberType 属 性 来 确定 引发 异常 的 成 员 类 型 ( 比如 属性 
与 方法 )。 这 里 catch 逻 辑 块 的 输出 结果 如 下 : 





冰冰 六 Error! 六 冰冰 
Member name: Void Accelerate(Int32) 

Class defining member: SimpleException.Car 
Member type: Method 

Message: Zippy has overheated! 

Source: SimpleException 
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7.4.2 StackTrace 属 性 


System.Exception.StackTrace 属 性 帮助 我 们 标识 引发 异常 的 一 系列 调用 。 需 要 注意 的 是 ， 
stackTrace 的 值 是 异常 创建 时 自动 产生 的 ， 无 法 为 其 赋值 。 假 定 我 们 再 次 更 改 catch 逻 辑 ， 如 下 
所 示 : 


catch(Exception e) 


Console.WriteLine("Stack: {0}", e.StackTrace); 


如 果 运 行 这 个 程序 ， 你 将 发 现下 面 的 栈 跟踪 被 输出 到 控制 台 ( 当然 你 会 发 现 这 里 的 行 号 和 应 用 程 
序 文件 夹 路 径 可 能 与 你 的 有 所 不 同 ): 





Stack: at SimpleException.Car.Accelerate(Int32 delta) 
in c:\MyApps\SimpleException\car.cs:line 65 at SimpleException.Program.Main() 
in c:\MyApps\SimpleException\Program.cs:line 21 


StackTrace 返 回 的 字符 串 证 明 ， 正 是 这 个 调用 序列 引发 了 异常 。 请 注意 下 面 行 号 字符 串 标识 这 个 
序列 的 首次 调用 , 上 面 行 号 字符 串 标 识 出 错 成 员 的 具体 位 置 。 很 明显 , 在 调试 或 记录 指定 应 用 程序 时 ， 
这 些 信息 都 非常 有 用 ， 它 使 我 们 能 顺 其 自然 地 发 现 错误 的 根源 。 


7.4.3 ”HelpLink 属 性 


尽管 TargetSite 属 性 和 StackTrace 属 性 能 够 帮助 程序 员 了 解 指 定 的 异常 ， 它 们 对 最 终 用 户 而 言 却 
基本 上 没什么 用 。 你 已 经 看 到 ，System.Exception.Message 属 性 可 用 来 获取 呈现 给 当前 用 户 的 可 以 阅 
读 的 信息 。 除 此 之 外 , HelpLink 属 性 能 帮助 用 户 找 到 具体 的 URL 或 包含 更 详细 相关 信息 的 标准 Windows 
帮助 文件 。 

默认 情况 下 ,HelpLink 属 性 的 值 是 一 个 空 字符 串 。 如 果 读 者 需要 用 一 个 有 意义 的 值 填充 该 属性 ， 
就 要 在 引发 System.Exception 类 型 异常 之 前 赋值 。 下 面 是 对 Car.Accelerate() 方 法 所 做 的 相应 
更 改 : 


public void Accelerate(int delta) 


if (carIsDead) 
Console.WritelLine("{0} is out of order...", PetName); 
else 


CurrentSpeed += delta; 
if (CurrentSpeed >= MaxSpeed) 


carIlsDead = true; 
CurrentSpeed = 0; 


// 我 们 需要 调用 HelpLink 属 性 ， 因 此 需要 在 异常 对 象 引发 之 前 先 创建 一 个 本 地 变量 
Exception ex = 

new Exception(string.Format("{0} has overheated!", PetName)); 
ex.HelpLink = "http://www.CarsRUs.com"; 
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throw ex; 


else 
Console.WritelLine("=> CurrentSpeed = {0}", CurrentSpeed); 


} 
catch 逻 辑 块 将 被 更 新 ， 以 输出 如 下 的 帮助 链接 信息 : 


catch(Exception e) 


Console.WriteLine("Help Link: {0}", e.HelpLink); 


7.4.4 Data 属性 


System.Exception 中 的 Data 属 性 允许 我 们 使 用 用 户 提供 的 相应 信息 ( 如 时 间 戳 ) 来 填充 异常 对 象 。 
Data 属 性 返回 一 个 实现 了 定义 在 System.Collections 命 名 空间 下 的 IDictionary 接 口 的 对 象 。 第 8 章 将 讨 
论 基 于 接口 的 编程 和 System.Collections 命 名 空间 的 作用 , 现在 暂时 了 解 dictionary 集 合 允 许 创建 一 组 
使 用 指定 键 检索 的 值 即 可 。 请 观察 再 次 更 新 过 的 Car.Accelerate() 方 法 : 


public void Accelerate(int delta) 





if (carIsDead) 
Console.Writeline("{0} is out of order...", PetName); 
else 


{ 
CurrentSpeed += delta; 
if (CurrentSpeed >= MaxSpeed) 
{ 


CarISsDead = true; 
CurrentSpeed = 0; 


// 我 们 需要 调用 HelpLink 属 性 ， 因 此 需要 在 异常 对 象 引发 之 前 先 创建 一 个 本 地 变量 
Exception ex = 

new Exception(string.Format("{0} has overheated!", PetName)); 
ex.HelpLink = "http://www.CarsRUs.com"; 


// 填充 关于 错误 的 自 定义 数据 
ex.Data.Add("TimeStamp", 
string.Format("The car exploded at {0}", DateTime.Now)); 
ex.Data.Add("Cause", "You have a lead foot."); 
throw ex; 


else 
Console.WriteLine("=> CurrentSpeed = {0}", CurrentSpeed); 


} 

为 了 成 功 列举 键 / 值 对 , 需要 在 包含 实现 Main() 方 法 的 类 的 文件 中 使 用 DictionaryEntry 类 型 , 不 过 
首先 必须 确保 为 System.Collections 命 名 空间 指定 了 using 指 令 ; 

using System.Collections; 


下 一 步 ， 需 要 更 新 catch 块 的 逻辑 来 测试 Data 属 性 的 返回 值 不 为 nul1 ( 默认 值 )。 在 此 之 后 ， 利 用 
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DictionaryEntry 类 型 的 Key 和 Value 属性 输出 自 定 义 数据 到 控制 台 : 
catch (Exception e) 
“7/ 默认 情况 下 ，data 字 段 是 空 的 ， 需 要 检查 它 是 否 为 空 
Console.WriteLine("\n-> Custom Data:"); 


if (e.Data != null) 


foreach (DictionaryEntry de in e.Data) 
Console.WriteLine("-> {0}: {1}", de.Key, de.Value); 
} 


} 
完成 这 些 之 后 ， 可 以 看 到 如 下 所 示 的 输出 结果 : 





***** Simple Exception Example ***** 
=> Creating a car and stepping on it! 
Jamming... 


=> CurrentSpeed = 30 
=> CurrentSpeed = 40 
=> CurrentSpeed = 50 
=> CurrentSpeed = 60 
=> CurrentSpeed = 70 
=> CurrentSpeed = 80 
=> CurrentSpeed = 90 


炒米 米 ETTOT | 六 

Member name: Void Accelerate(Int32) 

Class defining member: SimpleException.Car 

Membe type: Method 

Message: Zippy has overheated! 

Source: SimpleException 

Stack: at SimpleException.Car.Accelerate(Int32 delta) 
at SimpleException.Program.Main(String[] args) 

Help Link: http://www.CarsRUs.com 


-> Custom Data: 
-> TimeStamp: The car exploded at 1/12/2010 8:02:12 PM 
-> Cause: You have a lead foot. 


冰冰 站 本 米 OU 七 of exception logiC ***** 





Data 属 性 非常 有 用 ， 因 为 它 允 许 我 们 打包 关于 “错误 ”的 自 定义 信息 ， 无 需 构 建 全 新 的 类 类 型 来 
扩展 Exception 基 类 。 然而 和 Data 属 性 一 样 有 用 的 是 构建 强 类 型 的 异常 类 , 因为 .NET 开 发 人 员 可 以 通过 
强 类 型 属性 来 使 用 自 定 义 数 据 。 

这 个 方法 允许 调用 者 捕获 Exception 派 生 的 类 型 ,而 无 需 深 入 数据 集合 来 获取 其 他 细节 。 要 理解 为 
什么 这 么 做 ,我 们 还 需要 研究 系统 级 别 异常 和 应 用 级 别 异常 的 区 别 。 


源 代码 ”SimpleException 项 目的 源 代码 位 于 Chapter 7 子 目 录 下 。 
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7.5 ”系统 级 异常 


.NET 基 础 类 库 定义 了 许多 派生 自 System.Exception 的 类 。 例 如 ， 在 System 命 名 空间 下 定义 的 核心 
错误 对 象 有 ArgumentOutOfRangeException 、IndexOutOfRangeException 、StackOverflowException 等 。 
其 他 命名 空间 下 定义 了 反映 该 命名 空间 行为 的 异常 ， 比 如 说 System.Drawing.Printing 定 义 了 输出 异 
常 ，System.I0 定 义 了 基于 输入 输出 的 异常 ，System.Data 定 义 了 数据 库 异 常 及 数据 库 相 关 异 常 ， 等 等 。 

准确 地 说 ，.NET 平 台 引 发 的 异常 应 被 称 为 系统 异常 。 这 些 异 常 被 认为 是 无 法 修复 的 致命 错误 。 系 
统 异常 直接 派生 自 名 为 System.SystemException 的 基 类 ， 该 基 类 派生 自 System.Exception， 而 后 者 又 派 
生 自 System.0bject: 


public class SystemException : Exception 


{ 
人 


既然 System.SystemException 类 型 除了 一 组 自 定 义 构造 郴 数 外 不 添加 任何 功能 ， 读 者 首先 想到 的 
可 能 是 ， 系 统 异 常 的 存在 有 什么 必要 性 呢 ? 很 简单 ， 当 一 个 异常 类 型 派生 自 System.SystemException 
时 , 我 们 就 能 够 判断 引发 该 异常 的 实体 是 .NET 运 行 库 而 不 是 正在 执行 的 应 用 程序 代码 库 。 可 以 通过 is 
关键 字 来 验证 这 个 结论 : 


// NullReferenceException 是 系统 异常 

NullReferenceException nullRefEx = new NullReferenceException(); 

Console.Writeline("NullReferenceException is-a SystemException? : {0}", 
nullRefEx is SystemException); 


7.6 ”应 用 程序 级 异常 


既然 所 有 的 .NET 异 常 都 是 类 类 型 ,我们 就 可 以 随意 创建 应 用 程序 特定 的 异常 了 。 由 于 Systenm. 
SystemException 基 类 表示 从 CLR 引 发 的 所 有 异常 ， 读 者 可 能 很 自然 地 准备 将 所 有 自 定义 异常 派生 自 
System.Exception 类 型 。 事 实 上 最 佳 实践 表明 ， 自 定义 异常 应 当 派 生 自 System.ApplicationException 
类 型 : 


public class ApplicationException : Exception 


{ 
a 


就 像 系 统 异 常 一 样 ， 应 用 程序 异常 并 不 在 一 组 构造 函数 外 再 定义 其 他 任何 成 员 。 从 功能 上 来 讲 ， 
System.ApplicationException 的 唯一 目的 就 是 标识 出 错误 的 来 源 。 当 读者 处 理 一 个 派生 自 System. 
ApplicationException 的 异常 时 ,可 以 设想 异常 是 由 正在 执行 的 应 用 程序 代码 库 引发 的 , 而 不 是 由 .NET 
基础 类 库 或 ,NET 运行 时 引擎 引发 的 。 





说 明 事实 上 ,很 少 有 .NET 开 发 人 员 会 创建 扩展 ApplicationException 的 自 定义 异常 。 而 更 常见 的 情 
况 则 是 将 其 简单 地 归 入 System.Exception 类 ， 不 过 这 两 种 方法 在 技术 上 都 是 合法 的 。 
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7.6.1 构建 自 定义 异常 ， 第 一 部 分 


正如 第 一 个 例子 中 所 示 ， 读 者 可 以 一 直 引 发 System.Exception 的 实例 来 标识 运行 时 错误 ， 但 有 时 
候 构 建 一 个 强 类 型 异常 来 表示 当前 问题 的 独特 细节 更 好 。 举 个 例子 ， 假 定 要 构建 一 个 名 为 
CarIsDeadException 的 自 定义 异常 来 表示 加 速 注定 要 损坏 的 汽车 的 错误 。 第 一 步 就 是 创建 一 个 派生 自 
System.Exception/System.ApplicationException 的 新 类 ( 按照 约定 , 所 有 的 异常 类 均 应 以 “Exception” 
后 缀 结束 ， 这 是 .NET 的 最 佳 实践 )。 





说 明 ”作为 一 个 规则 ， 所 有 自 定义 异常 类 都 应 该 定义 为 公共 类 ( 回忆 一 下 ， 非 谋 套 类 型 的 默认 访问 
修饰 符 是 内 部 的 )。 这 是 因为 异常 通常 都 会 跨 程序 集 边 界 进行 传递 ， 也 应 该 可 以 被 调用 代码 库 
所 访问 。 


新 建 一 个 控制 台 应 用 程序 CustomException， 使 用 Project 一 Add Existing Item 菜 单项 将 之 前 的 Car.cs 
和 Radio.cs 复 制 到 新 项 目 中 ( 请 确保 将 定义 Car 和 Radio 类 型 的 命名 空间 由 SimpleException 改 为 
CustomException )。 然 后 ， 增 加 如 下 的 类 定义 : 


// 这 个 自 定义 异常 描述 了 car-is-dead 条 件 下 的 详细 信息 ( 记 住 ， 也 可 以 只 是 扩展 异常 ) 
public class CarIsDeadException : ApplicationException 


{} 

和 其 他 类 一 样 ， 我 们 可 以 自由 包含 能 在 调用 逻辑 catch 块 中 调用 的 任意 数量 的 自 定义 成 员 ， 也 可 
以 自由 重 写 任何 父 类 定义 的 虚拟 成 员 。 例 如 ， 可 以 通过 重 写 虚 拟 Message 属 性 来 实现 CarIsDead- 
Exception。 

同样 ， 构 造 函 数 没 有 在 抛 出 异常 时 填充 数据 字典 ( 通过 Data 属 性 )， 而 是 允许 调用 者 传人 时 间 戳 
和 错误 原因 。 最 后 ， 我 们 可 以 通过 使 用 强 类 型 属性 来 获取 时 间 戳 和 错误 原因 : 


public class CarIsDeadException : ApplicationException 


private string messageDetails = String.Empty; 
public DateTime ErrorTimeStamp {get; set;} 
public string CauseOfError {get; set;} 


public CarIsDeadException(){} 

public CarIsDeadException(string message, 
string cause, DateTime time) 
messageDetails = message; 


CauseOfError = cause; 
ErrorTimeStamp = time; 


// 重 写 Exception.Message 属 性 
public override string Message 
get 


return string.Format("Car Error Message: {0}", messageDetails); 
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这 里 ，CarIsDeadException 类 包含 一 个 表示 当前 异常 的 私有 数据 成 员 ( messageDetails )， 可 以 
通过 自 定义 构造 函数 来 设 定 其 值 。 从 Accelerate() 引 发 异常 很 直接 ， 只 需 分 配 、 配 置 和 引发 一 个 
CarIsDeadException 类 型 ， 而 不 是 通用 的 System.Exception 异 常 (在 本 例 中 ， 不 需要 手工 填充 数据 
集合 ): 


// 抛 出 自 定义 CarISsDeadException 
public void Accelerate(int delta) 


CarISsDeadException ex = 
new CarIsDeadException (string.Format("{0} has overheated!", PetName), 
"You have a lead foot", DateTime.Now); 
ex.HelpLink = "http://www.CarsRUs.com"; 
throw ex; 


为 了 捕获 到 传人 的 异常 ， 我 们 调整 catch 的 范围 为 特定 的 CarIsDeadException 类 型 ( 由 于 
System.Exception 包 含 CarIsDeadException， 所 以 仍然 可 以 在 System.Exception 中 捕获 到 该 异常 ): 


static void Main(string[] args) 


Console.WriteLine("***** Fun with Custom Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 


try 


{ 
// 行程 异常 
myCar.Accelerate(50); 

上 

catch (CarIsDeadException e) 
Console.WriteLine(e.Message); 
Console.Writeline(e.ErrorTimeStamp); 


Console.WritelLine(e.CauseOfError); 


Console.ReadLine(); 


既然 读者 理解 了 构建 自 定义 异常 的 基本 过 程 ， 可 能 想 知道 什么 时 候 需 要 构建 自 定义 异常 。 通 常情 
况 下 ,读者 仅 需 在 出 现 错 误 的 类 与 该 错误 关系 紧密 时 才 需 要 创建 自 定义 异常 (例如 ,一 个 自 定义 文件 
类 引发 许多 文件 相关 的 错误 ， 一 个 Car 类 引发 许多 汽车 相关 的 错误 ， 一 个 数据 访问 对 象 引发 关于 特定 
数据 库 表 的 错误 ， 等 等 )。 这 样 我 们 就 能 使 调用 者 逐个 地 处 理 众多 的 异常 。 


7.6.2 ”构建 自 定义 异常 ， 第 二 部 分 


为 了 配置 自 定义 错误 信息 ， 当 前 的 CarIsDeadException 类 型 重 写 了 System.Exception.Message 属 
性 ,并 提供 两 个 自 定义 属性 来 说 明 其 他 数据 。 事 实 上 ,不 用 重 写 Message 虚 属性 ， 而 只 需要 将 传人 的 信 
息 按 以 下 方式 传递 给 父 对 象 的 构造 函数 : 

public class CarIsDeadException : ApplicationException 


public DateTime ErrorTimeStamp { get; set; } 
public string CauseOfError { get; set; } 
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public CarIsDeadException() { } 


// 将 信息 传递 给 父 对 象 构 造 函 数 
public CarIsDeadException(string message, string cause，DateTime time) 
:base(message) 


CauseOfError = cause; 
ErrorTimeStamp = time; 


} 

请 注意 , 这 次 我 们 并 没有 定义 一 个 字符 串 变量 来 呈现 信息 , 也 没有 重 写 Message 属 性 , 仅 是 将 参数 
传递 到 基 类 构造 函数 而 已 。 通 过 这 样 的 设计 ， 一 个 自 定义 异常 类 就 没有 任何 基 类 重 写 ， 和 一 个 派生 自 
System.ApplicationException 的 特定 命名 的 类 没有 任何 差别 了 。 

要 知道 大 多 数 ( 甚至 全 部 ) 的 自 定 义 异 常 类 都 遵循 这 个 简单 的 模式 ， 请 不 要 感到 惊讶 。 很 多 情况 
下 ， 自 定义 异常 类 的 作用 并 不 是 提供 继承 基 类 之 外 附加 的 功能 ， 而 是 提供 明确 标识 错误 种 类 的 强 命名 
类 型 ， 因 此 客户 会 为 不 同类 型 的 异常 提供 不 同 的 处 理 程序 逻辑 。 


7.6.3 构建 自 定 义 异 常 ， 第 三 部 分 


如 果 读 者 想 构 造 一 个 真正 意义 上 严谨 规范 的 自 定义 异常 类 , 需要 确保 类 遵守 .NET 异 常 处 理 的 最 佳 
实践 。 具 体 来 讲 ， 自 定义 异常 需要 : 

口 继承 自 Exception/ApplicationException 类 ; 

口 有 [System.Serializable] 特 性 标记 ; 

口 定义 一 个 默认 的 构造 函数 ，; 

口 定义 一 个 设 定 继承 的 Message 属 性 的 构造 函数 ; 

口 定义 一 个 处 理 “内 部 异常 ”的 构造 函数 ; 

口 定义 一 个 处 理 类 型 序列 化 的 构造 函数 。 

基于 读者 当前 对 .NET 的 了 解 ， 可 能 完全 不 知道 特性 标记 或 对 象 序列 化 的 作用 ,不 过 没关系 ,我 将 
在 本 书 稍 后 介绍 这 些 主题 (第 15 章 讨论 特性 ， 第 20 章 讨论 序列 化 服务 )。 为 了 完成 我 们 自 定义 异常 的 
构建 ， 下 面 是 CarIsDeadException 最 终 的 完整 代码 ， 它 说 明了 每 个 特殊 的 构造 函数 ( 其 他 自 定 义 属 性 
和 构造 函数 详 见 7.6.2 节 ): 


[Serializable] 
public class CarIsDeadException : ApplicationException 


public CarIsDeadException() { } 
public CarIsDeadException(string message) : base( message ) { } 
public CarIsDeadException(string message, 
System.Exception inner) 
: base( message, inner ) { } 
protected CarIsDeadException( 
System.Runtime.Serialization.SerializationInfo info， 
System.Runtime.Serialization.SstreamingContext context) 
: base( info，context ) { } 


) // 其 他 自 定义 属性 、 构 造 函 数 、 数 据 成 员 …… 
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既然 遵循 .NET 最 佳 实践 构建 的 自 定 义 异 常 只 在 名 称 上 有 区 别 ， 你 一 定 乐意 知道 Visual Studio 提 供 
了 一 个 叫做 “Exception” 的 代码 片段 模板 ( 如 图 7-1 所 示 )， 它 能 自动 生成 一 个 新 的 遵循 .NET 最 佳 实践 
的 异常 类 [ 在 第 2 章 中 我 们 介绍 过 ， 可 以 通过 输入 名 称 ( 本 例 中 为 exception ) 并 连 按 两 次 Tab 键 来 激活 


代码 块 ]。 





CarlsDeadException.cs” + X Obj ) 
Wy CustomException.CarlsDeadExcef > @, CafsBeadExceptionfSysterm Runti ~ 
using System.Linq; 村 
using System.Text; < 
using System.Threading.Tasks; 


| 
Jnamespace CustomException | "| 
| 
| 
| 


OO 








} 而 exception 


Code snippet for exception 





| 
| 
| i exd| 
1 
| 


(UO [en 有 ss | 


图 7-1 Exception 代码 片段 模板 


源 代 码 CustomException 项 目的 源 代码 位 于 Chapter 7 子 目 录 下 。 
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在 最 简单 的 情形 下 ,一 个 try 块 有 一 个 catch 块 。 但 在 现实 中 , 你 常常 会 遇 到 包含 try 块 的 语句 能 够 
触发 许多 可 能 发 生 的 异常 的 情形 。 创 建 一 个 名 为 ProcessMultipleExceptions 的 新 控制 台 应 用 程序 项 目 ， 
通过 Project 一 Add Existing Item 将 已 有 的 Carcs、Radio.cs 和 CarIsDeadException.cs 文 件 添加 到 新 项 目 中 ， 
同时 相应 地 修改 命名 空间 的 名 字 。 

例如 ， 假 定 在 读者 传递 了 一 个 无 效 参 数 ( 比如 小 于 0 的 任何 值 ) 的 情况 下 ， 修 改 Car 的 Accelerate() 方 
法 还 会 引发 一 个 基础 类 库 预 定义 的 异常 ArgumentOutOfRangeException。 注 意 ， 该 异常 类 的 构造 函数 所 
接收 的 第 一 个 字符 串 为 错误 参数 的 名 称 ， 然 后 是 描述 该 错误 的 消息 。 

// 在 处 理 之 前 传 入 无 效 参 数 的 测试 
public void Accelerate(int delta) 


if(delta < 0) 
throw new 
ArgumentOutOfRangeException("delta", "Speed must be greater than zero!"); 
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catch 逻 辑 现 在 可 以 为 每 种 异常 分 别 做 出 回应 : 

static void Main(string[] args) 
Console.WritelLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 
try 


{ 
// 触发 超出 范围 的 异常 
myCar.Accelerate(-10); 


catch (CarIsDeadException e) 
Console.WriteLine(e.Message); 

Eh (ArgumentOutOfRangeException e) 
Console.WritelLine(e.Message); 


Console.ReadLine(); 


当 读 者 创建 多 个 catch 块 的 时 候 ， 必 须 注意 一 个 异常 引发 后 都 将 被 第 一 个 可 用 的 catch 处 理 。 为 了 
阐明 什么 是 第 一 个 可 用 的 catch 块 ， 假 定 我 们 修改 之 前 的 逻辑 来 增加 另外 一 个 catch 块 ， 如 下 所 示 ， 它 
试图 处 理 通过 捕获 普通 的 System.Exception 来 处 理 包括 CarIsDeadException 和 ArgumentOutOfRange- 
Exception 在 内 的 所 有 异常 : 


// 这 段 代码 将 不 会 编译 
static void Main(string[] args) 


Console.WritelLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 


try 


// 触发 超出 范围 的 异常 
myCar.Accelerate(-10); 


catch(Exception e) 


// 处 理 其 他 的 所 有 异常 
Console.Writeline(e.Message); 


catch (CarIsDeadException e) 
Console.Writeline(e.Message); 

eh (ArgumentOutOfRangeException e) 
Console.Writeline(e.Message); 


Console.ReadLine(); 


} 

这 段 异常 处 理 逻 辑 产 生 了 编译 时 错误 。 问 题 出 在 ( 由 于 “is-a” 关 系 ) 第 一 个 catch 块 可 以 处 理 任 
何 派生 自 System.Exception 的 异常 ， 其 中 包括 CarIsDeadException 与 ArgumentOutOfRangeException， 故 
而 最 终 导致 无 法 到 达 另 外 两 个 catch 块 ! 
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读者 要 牢记 的 首要 原则 就 是 ， 要 保证 将 catch 块 按照 下 面 的 原则 结构 化 : 最 前 面 的 catch 捕 获 最 特 
定 的 异常 (也 就 是 一 个 异常 类 型 派生 关系 链 中 排 在 最 上 面 的 派生 类 型 )， 最 后 面 的 catch 捕 获 最 普通 的 
异常 (也 就 是 指定 异常 继承 关系 链 中 的 基 类 ， 在 本 例 中 是 System.Exception )。 

这 样 , 如 果 读 者 想 定义 一 个 在 CarIsDeadException 与 ArgumentOut0OfRangeException 之 后 能 捕获 任何 
错误 的 catch 语 句 ， 应 当 这 样 写 : 

// 这 段 代码 编译 正常 

static void Main(string[] args) 


Console.WritelLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 
try 


// 触发 超出 范围 的 异常 
myCar.Accelerate(-10); 


catch (CarIsDeadException e) 


Console.WritelLine(e.Message); 





} 
catch (ArgumentOutOfRangeException e) 
Console.WritelLine(e.Message); 


// 捕获 CarIsDeadException 和 ArgumentOutOfRangeException 之 后 的 所 有 异常 
catch (Exception e) 


Console.WriteLine(e.Message); 


Console.ReadLine(); 


说 明 人 们 通常 尽 可 能 地 捕获 特定 的 异常 类 ， 而 不 是 一 般 的 System.Exception。 这 表面 上 看 起 来 很 省 
事 (你 可 能 会 想 “ 啊 ， 它 可 以 捕获 所 有 我 不 关心 的 事情 ”" )， 但 从 长 期 来 看 ， 很 可 能 导致 莫名 
其 妙 的 运行 时 和 前 演 ， 因 为 有 一 个 更 严重 的 错误 你 没有 在 代码 中 处 理 。 记 住 ， 往 往 在 最 后 一 个 
catch 块 中 才 处 理 System.Exception。 





7.7.1 通用 的 catch 语 句 


C# 也 支持 通用 catch 块 ， 它 不 显 式 接收 由 指定 成 员 引 发 的 异常 对 象 : 


// 通用 的 catch 
static void Main(string[] args) 


{ 
Console.WritelLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 
try 


myCar.Accelerate(90); 


catch 
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Console.WritelLine("Something bad happened..."); 


Console.ReadLine(); 


很 明显 ,这 不 是 处 理 异 常 的 最 佳 途径 ， 因 为 我 们 无 法 获取 关于 发 生 错 误 的 有 意义 的 资料 ( 比如 说 
方法 名 、 调 用 栈 或 自 定义 信息 )。 不 过 ， 在 C# 中 这 样 的 构造 确实 是 允许 的 ， 通 过 它 可 以 用 通用 模式 来 
处 理 所 有 错误 。 


7.7.2 再 次 引发 异常 


请 注意 ， 可 以 在 try 块 逻辑 中 向 之 前 的 调用 者 再 次 引发 一 个 调用 栈 异常 。 要 想 这 样 ， 仅 仅 在 catch 
块 中 使 用 throw 关 键 字 就 行 了 ， 它 通过 调用 逻辑 链 传递 异常 。 在 catch 块 只 能 处 理 即将 发 生 的 部 分 错误 
时 这 样 做 很 有 用 : 

// 传递 异常 


static void Main(string[] args) 


{ 
try 
{ 
// 给 汽车 加 速 的 逻辑 
catch(CarIsDeadException e) 


// 执行 一 些 处 理 此 错误 的 操作 并 传递 异常 


throw; 


} 

注意 , 在 这 段 示 例 代码 中 ，CarIsDeadException 传 给 了 CLR, 该 异常 由 Main() 方 法 再 次 引发 。 这 样 
的 话 ， 最 终 用 户 将 看 到 一 个 系统 提供 的 错误 对 话 框 。 通 常情 况 下 ， 只 需要 向 调用 者 再 次 引发 部 分 处 理 
过 的 异常 ， 使 之 能 够 恰当 地 处 理 即 将 发 生 的 异常 。 

还 要 注意 , 我 们 没有 显 式 重 新 抛 出 CarIsDeadException 对 象 , 而 是 使 用 了 不 带 参 数 的 throw 关 键 字 。 
我 们 并 没有 创建 新 的 异常 对 象 ， 只 是 重新 抛 出 了 原始 的 异常 对 象 ( 及 其 原始 信息 )。 这 样 做 保护 了 原 
台 目 标的 上 下 文 。 


7.7.3 内 部 异常 


我 们 完全 可 以 在 处 理 其 他 异常 的 时 候 触发 一 个 异常 。 例 如 ， 假 定 我 们 在 一 个 特定 的 catch 块 中 处 
理 CarIsDeadException， 在 这 个 过 程 中 试图 将 栈 跟踪 记录 到 C 盘 下 名 为 carErrortxt 的 文件 中 ( 必须 明确 
指定 通过 System.I0 命 名 空间 来 使 用 这 些 UO 类 型 ): 


catch(CarIsDeadException e) 


// 试图 打开 C 盘 下 名 为 carErrors.txt 的 文件 
FileStream fs = File.Open(@"C:\carErrors.txt", FileMode.Open); 


} 
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如 果 指 定 的 文件 并 不 位 于 C 盘 中 ， 调 用 File.0pen() 将 导致 一 个 FileNotFoundException! 本 书 稍 后 
会 介绍 关于 System.I0 命 名 空间 的 一 切 , 并 介绍 在 首次 试图 打开 文件 之 前 如 何 通 过 编程 判断 硬盘 上 该 文 
件 存在 与 否 (总 而 言 之 这 个 异常 可 以 避免 ) 为 了 将 注意 力 集中 到 关于 异常 的 主题 上 来 ， 我 们 假定 这 
个 异常 已 经 产生 。 

如 果 在 处 理 一 个 异常 的 时 候 遇 到 男 一 个 异常 , 最 好 的 习惯 是 将 这 个 新 异常 对 象 标识 为 与 第 一 个 异 
常 类 型 相同 的 新 对 象 中 的 “内 部 错误 ”， 这 个 建议 比较 抛 口 。 我 们 之 所 以 需要 创建 一 个 异常 的 新 对 象 
来 等 待 处 理 ， 是 因为 声明 一 个 内 部 错误 的 唯一 途径 就 是 将 其 作为 一 个 构造 函数 参数 。 考 虑 以 下 代码 : 

catch (CarIsDeadException e) 

try 


FileStream fs = File.Open(@"C:\carErrors.txt", FileMode.Open); 


} 
catch (Exception e2) 


// 引发 记录 新 异常 的 异常 ， 还 有 第 一 个 异常 的 相关 信息 
throw new CarIsDeadException(e.Message, e2); 
} 
注意 在 本 例 中 ， 我 们 将 FileNotFoundException 对 象 作为 CarIsDeadException 的 第 二 个 参数 传递 进来 。 
一 旦 确定 了 这 个 新 对 象 , 我 们 就 向 下 一 个 调用 者 的 调用 栈 引发 异常 , 本 例 中 下 一 个 调用 者 是 Main() 方 法 。 
既然 Main() 方 法 没有 下 一 个 调用 者 来 捕获 异常 ， 我 们 需要 通过 错误 对 话 框 将 其 再 次 呈现 出 来 。 就 
像 再 次 引发 异常 一 样 , 记录 内 部 异常 通常 仅仅 在 调用 者 能 够 在 首次 发 生 异 常 时 将 其 更 恰当 地 捕获 处 理 
的 情况 下 才 有 用 。 例 如 ， 在 本 例 中 如 果 调 用 者 的 catch 块 逻辑 能 够 利用 InnerException 属 性 来 获取 内 部 
异常 对 象 的 详细 信息 的 话 ， 记 录 内 部 异常 才 有 用 。 
7.7.4 finally 块 
一 个 try/catch 块 后 面 可 能 接着 会 定义 一 个 finally 块 。finally 块 并 不 是 必须 要 有 的 ， 它 是 为 了 保 
证 不 管 是 否 有 异常 (或 其 他 任何 类 型 )， 一 组 代码 语句 始终 都 能 被 执行 。 假 定 在 退出 Main() 方 法 前 , 不 
论 任 何 异 常 处 理发 生 与 否 ， 读 者 总 是 要 先 关 掉 车 上 面 广播 的 电源 : 
static void Main(string[] args) 
Console.WritelLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 
myCar.CrankTunes (true); 
try 
{ 
// 车 的 加 速 逻 辑 
catch(CarIsDeadException e) 
// 处 理 CarISDeadException 


} 
catch(ArgumentOutOfRangeException e) 





220 第 7 章 结构 化 异常 处 理 


// 处 理 ArgumentOutOfRangeException 
catch(Exception e) 

// 处 理 其 他 任何 异常 
finally 


{ 
// 不 论 异 常 发 生 与 否 ， 以 下 语 揣 总 是 被 执行 
myCar.CrankTunes(false); 


人 

如 果 读 者 不 加 入 一 个 finally 块 ， 当 异常 发 生 时 (很 可 能 ) 广播 将 不 会 被 关闭 。 在 更 加 现实 的 场景 
中 ,， 当 读者 准备 进行 销毁 对 象 、 关 闭 文件 、 断 开 数据 库 连 接 等 操作 时 , 将 资源 清理 加 入 到 finally 块 来 
确保 操作 正确 执行 。 


7.8 谁 在 引发 什么 异常 


既然 .NET Framework 中 的 方法 在 各 种 情况 下 可 以 引发 任意 数量 的 异常 ， 很 自然 会 产生 一 个 疑问 : 
“我 怎么 知道 指定 的 基础 类 库 中 的 方法 可 能 引发 哪个 异常 呢 ? “最终 的 答案 就 是 : 参阅 .NET Framework 
4.5 SDK 文 档 。 帮 助 系统 文档 中 的 每 个 方法 都 有 指定 成 员 可 能 引发 的 异常 。 另 外 一 个 可 供 选 择 的 办 法 
是 : 在 Visual Studio 中 可 以 通过 悬 停 鼠标 光标 在 代码 窗口 的 成 员 名 称 上 ， 来 浏览 该 基础 类 库 成 员 可 能 
引发 的 所 有 异常 ( 如 果 有 的 话 ) 的 列表 ， 如 图 7-2 所 示 。 


Progam cs © x haopes Object sd 
人 Exception .prcgrzam ~ @@ Mintsinnogil argo 区 
myCar ,Accelerate: {58); 二 
} 
ch nt ne 


-WriteLine(e.Message); 
-Nriteline(e.ErrorTimeStamp); 
soie.NriteLine(e.CauseOfError); 


se.Readiine(); _ 
} string Console ReadLineO0 
Reads the nedt line of characters from the standard input stream. 


Exceptions: 
SystemJOJOException 
System.OutOfMemoryException 
System.ArgumentOutOfRangeException 


100% - 时 


图 7-2 ”确定 一 个 指定 方法 中 可 能 引发 的 所 有 异常 
说 明 对 于 由 Java 转 向 .NET 的 程序 员 来 说 ， 要 理解 类 型 成 员 不 是 一 系列 可 能 引发 异常 的 原型 ( 换 句 
话说 ，.NET 不 支持 检查 异常 ), 不管 怎样 , 读者 不 需要 逐个 处 理 指 定 成 员 可 能 引发 的 所 有 异常 。 


7.9 未 处 理 异 常 的 后 果 
在 这 里 ， 读 者 可 能 会 思考 ， 如 果 一 个 直接 被 引发 的 异常 未 被 处 理 ， 会 发 生 什么 。 假 定 Main() 逻 辑 
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中 我 们 将 Car 对 象 增 速 到 超过 速度 上 限 而 不 使 用 try/catch 逻 辑 : 


static void Main(string[] args) 


Console.WriteLine("***** Handling Multiple Exceptions *****\n"); 
Car myCar = new Car("Rusty", 90); 

myCar.Accelerate(500); 

Console.ReadLine(); 


} 
忽视 这 个 异常 将 呈现 一 个 “未 处 理 的 异常 ”对 话 框 , 非常 妨碍 最 终 用 户 使 用 我 们 的 程序 ， 如 图 7-3 
所 示 。 
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1 图 
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图 7-3 ”不 处 理 异 常 的 后 果 


7.10 使 用 Visual Studio 调试 未 处 理 的 异常 


请 注意 ， 为 了 解决 这 些 问题 ，Visual Studio 提 供 了 大 量 工具 来 帮助 我 们 调试 未 处 理 自 定义 异常 。 
再 次 假定 将 Car 对 象 加 速 超过 了 速度 上 限 。 如 果 启 动 了 调试 会 话 ( 选择 Debug 一 Start Debugging 菜 单 )， 
Visual Studio 会 在 未 处 理 异 常 引发 时 自动 中 断 。 现 在 好 了 ， 一 个 显示 Message 属 性 值 的 窗口 呈现 在 我 们 
面前 ， 如 图 7-4 所 示 。 


Carc 二 x Ph CarisDeadException cs 局 
,CurtomErception Car 了 © Acceleratelint dena) 
.Da 本 add(™ TieeStenp”, 村 
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ex .Data Add( Cause , “You haeve 3 3ead Fook > 
hrow 
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图 7-4 使 用 Visual Studio 调 试 未 处 理 的 自 定义 异常 
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说 明 ”如果 没 有 成 功 处 理由 ,NET 基础 类 库 中 方法 引发 的 异常 ，Visual Studio 调 试 工具 将 在 调用 该 出 错 


方法 的 语句 处 中 断 。 





单 击 View Detail 链 接 ， 能 够 看 到 该 对 象 状 态 的 详细 信息 ， 如 图 7-5 所 示 。 


Pe 





上 Exception snapshot: 


CauseOftiror 
Data 
4 ErorTimeStamp 
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Source 
StackTrace 
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| 4 CustomException.CarlsDeadException 
[CustomException.CarisDeadException] ["Rusty has overheated!")} 
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{System.Collections.ListDictionaryinternal} 
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27 

System.DayOf Week.Sunday 
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16 

System.DateTimeKind.Local 
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对 

5 

37 

634737336974614260 

{16:41:37 .4614260} 

2012 

http://Wwww.CarsRUs.com 

-2146232832 

null 

Rusty has overheated! 

CustomException lL 
at CustomException.Car.Accelerate(Int32 delta) in € | 

{Void Accelerate(int32)} 





图 7-5 查看 异常 详细 信息 


源 代码 ”ProcessMultipleExceptions 项 目的 源 代 码 位 于 Chapter 7 子 目 录 下 。 


7.11 小 结 


本 章 介绍 了 结构 化 异常 处 理 的 作用 。 当 一 个 方法 需要 发 送 错 误 对 象 给 调用 者 时 ,通过 C# 中 的 throw 
关键 字 来 分 配 、 设 置 并 引发 一 个 特定 的 System.Exception 派 生 类 型 。 通过 使 用 C# 中 catch 关 键 字 和 可 选 
的 finally 块 ， 调 用 者 能 够 处 理 任何 可 能 发 生 的 错误 。 

当 读 者 自己 创建 一 个 自 定义 异常 时 ， 最 终 创建 了 一 个 派生 自 System.ApplicationException 的 类 ， 
由 它 来 表示 一 个 异常 从 当前 执行 程序 中 引发 。 相 反 ， 派 生 自 System.SystemException 的 错误 对 象 呈现 
CLR5 引 | 发 的 重要 ( 和 致命 的 ) 错误 。 最 后 ， 本 章 介 绍 了 各 种 可 用 于 依据 .NET 最 佳 实践 创建 自 定义 异常 


和 调试 异常 的 Visual Studio 工 具 。 
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章 讨论 基于 接口 的 编程 ， 进 一 步 加 深 我 们 对 面向 对 象 开 发 的 理解 。 我 们 将 会 学 习 如 何 定义 

和 实现 接口 ， 进 而 理解 构建 支持 多 种 行为 的 类 型 有 哪些 优势 。 而 后 ， 会 讨论 一 系列 相关 主 
题 ,， 如 获取 接口 引用 、 显 式 接口 实现 以 及 接口 层次 结构 的 构建 。 我们 还 会 学 习 许 多 定义 在 .NET 基 础 类 
库 中 的 标准 接口 。 我 们 会 看 到 ， 自 定义 类 和 结构 完全 可 以 实现 这 些 预定 义 的 接口 ， 以 支持 对 象 克 隆 、 
对 象 枚 举 和 对 象 排序 等 高 级 行为 。 


8.1 接口 类 型 


首先 给 出 接口 类 型 的 正式 定义 。 接 口 就 是 一 组 抽象 成 员 的 命名 集合 。 回 忆 一 下 第 6 章 ， 抽 象 方法 
是 纯粹 的 协议 , 在 其 中 没有 提供 默认 的 实现 。 由 接口 定义 的 某 个 特定 成 员 依赖 于 它 所 模拟 的 确切 行为 。 
是 的 ， 接 口 表 示 某 个 类 或 结构 可 以 选择 去 实现 的 行为 。 此 外 ， 在 本 章 中 我 们 会 看 到 ， 一 个 类 (或 者 一 
个 结构 ) 可 以 支持 任意 数量 的 接口 ， 因 此 本 质 上 也 就 支持 了 多 种 行为 。 

.NET 基 础 类 库 提 供 了 几 百 个 预定 义 的 接口 类 型 , 由 各 种 类 和 结构 实现 。 例 如 , 在 第 21 章 中 我 们 会 
看 到 ，ADO.NET 附 带 了 多 个 数据 提供 程序 ， 允 许 我 们 和 某 个 数据 库 管理 系统 进行 交互 。 因 此 ,在 
ADO.NET 下 ， 我 们 有 很 多 连接 对 象 可 以 选择 ( SqlConnection、0leDBConnection、0dbcConnection 等 )。 

尽管 每 一 个 连接 对 象 都 有 唯一 的 名 字 ,， 也 定义 在 不 同 的 命名 空间 中 , 某 些 可 能 还 在 不 同 的 程序 集 
中 ,但 是 所 有 连接 对 象 都 实现 了 一 个 叫 IDbConnection 的 公共 接口 : 

// IDbConnection 接 口 定义 了 一 组 所 有 连接 对 象 都 支持 的 公共 成 员 


public interface IDbConnection : IDisposable 


// 方法 

IDbTransaction BeginTransaction(); 

IDbTransaction BeginTransaction(IsolationLevel il); 
void ChangeDatabase(string databaseName); 

void Close(); 

IDbCommand CreateCommand(); 

void Open(); 


// 属性 

string ConnectionString { get; set;} 
int ConnectionTimeout { get; } 
string Database { get; } 
ConnectionState State { get; } 





说 明 根据 惯例 ，.NET 接 口 多 以 大 写字 母 “I” 作 为 前 缓 。 如 果 我 们 创建 自 定义 接口 ， 可 依照 此 最 佳 
实践 如 法 炮制 。? 


现在 不 要 太 过 关注 这 些 成 员 是 做 什么 的 。 只 需要 理解 IDbConnection 接 口 定义 了 一 组 所 有 ADO. 
NET 连 接 对 象 都 共有 的 成 员 。 因 此 ， 也 就 保证 了 每 一 个 连接 对 象 都 支持 诸如 0pen() 、Close() 、Create- 
Command() 等 的 成 员 。 此 外 , 由 于 接口 成 员 总 是 抽象 的 , 每 一 个 连接 对 象 完 全 可 以 以 自己 的 方式 来 实现 
这 些 方法 。 

继续 看 本 书 的 话 , 你 会 找到 许多 .NET 基 础 类 库 提供 的 接口 。 我 们 自 定义 的 类 和 结构 中 可 以 实现 这 
些 接口 ， 以 定义 各 种 类 型 ， 与 整个 框架 紧密 融合 起 来 。 


对 比 接口 类 型 和 抽象 基 类 


如 果 你 看 过 第 6 章 的 话 , 就 会 发 现 接口 类 型 和 抽象 基 类 很 相似 。 回忆 一 下 , 如 果 类 被 标记 为 抽象 的 ， 
它 可 以 定义 许多 抽象 成 员 来 为 所 有 派生 类 型 提供 多 态 接口 。 然 而 ， 虽 然 类 定义 了 一 组 抽象 成 员 ， 它 完 
全 可 以 再 定义 许多 构造 函数 、 字 段 数据 、 非 抽象 成 员 ( 具有 实现 ) 等 。 而 接口 ， 只 能 包含 抽象 成 员 。 

由 抽象 父 类 创建 的 多 态 接口 有 一 个 主要 的 限制 , 那 就 是 只 有 派生 类 型 才 支 持 由 抽象 父 类 定义 的 成 
员 。 然 而 ， 在 大 型 软件 系统 中 ， 开 发 除了 System.0bject 之 外 没有 公共 父 类 的 多 个 类 层次 结构 很 普遍 。 
由 于 抽象 基 类 中 的 抽象 成 员 只 应 用 到 派生 类 型 ,我 们 就 不 能 以 多 个 层次 结构 配置 类 型 来 支持 相同 的 多 
态 接口 。 作 为 示例 ， 假 设 我 们 已 经 定义 了 如 下 的 抽象 类 : 

Public abstract class CloneableType 


// 只 有 派生 类 型 才能 支持 “多 态 接口 ”。 在 其 他 层次 结构 中 的 类 不 能 访问 这 个 抽象 成 员 
public abstract object Clone(); 


按照 这 个 定义 ， 只 有 扩展 了 CloneableType 的 成 员 才 能 支持 Clone() 方 法 。 如 果 我 们 创建 的 新 的 集 
合 类 没有 扩展 这 个 基 类 ， 就 不 能 获取 这 个 多 态 接口 。 你 可 能 还 记得 C# 不 支持 类 的 多 重 继承 。 因 此 ， 如 
果 想 创建 既是 Car 又 是 CloneableType 的 Minivan， 下 面 的 代码 是 行 不 通 的 : 


// 不 行 ! C# 不 允许 类 的 多 重 继承 
public class MiniVan : Car, CloneableType 


{ 
4 


你 可 能 也 想到 了 ， 接 口 类 型 就 是 来 解决 这 个 问题 的 。 在 定义 了 接口 之 后 ， 它 就 可 以 被 任何 层次 结 
构 、 任 何 命名 空间 或 任何 程序 集 ( 由 任何 .NET 编 程 语言 写 的 ) 中 的 任何 类 或 结构 来 实现 。 这 样 的 话 ， 
接口 就 有 较 高 的 多 态 性 。 考 虑 定义 在 System 命名 空间 中 名 为 ICloneable 的 标准 .NET 接 口 ， 它 定义 了 一 
个 名 为 Clone() 的 方法 : 


public interface ICloneable 


object Clone(); 
} 





QD Robert Martin 在 《敏捷 软件 开发 ( C# 版 )》( 人 民 邮 电 出 版 社 ，2008 ) 一 书 中 指出 ， 因 为 在 重 构 时 接口 和 类 常常 相 
互 转换 ， 所 以 这 一 命名 约定 在 系统 框架 之 外 普通 程序 的 开发 中 并 不 合理 。 请 读者 注意 。 一 一 编者 注 
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如 果 研 究 .NET Framework 4.5 SDK 文 档 的 话 ， 就 会 发 现 非常 多 看 似 无 关 的 类 型 ( System.Array、 
System.Data.SqlClient.SqlConnection、System.0peratingSystem、System.String 等 ) 都 实现 了 这 个 接 
口 。 尽 管 这 些 类 型 不 具有 相同 的 父 类 (除了 System.0bject 之 外 )， 我 们 可 以 通过 ICloneable 接 口 类 型 
把 它们 当成 多 态 处 理 。 

例如 ， 如 果 我 们 有 一 个 含 ICloneabjle 接 口 参数 的 方法 CloneMe() ， 我 们 就 可 以 把 任何 实现 这 个 接口 
的 对 象 传 给 这 个 方法 。 考 虑 如 下 定义 在 ICloneExample 控 制 台 应 用 程序 中 的 简单 Program 类 : 

class Program 

static void Main(string[] args) 
Console.Writeline("***** A First Look at Interfaces *****\n"); 


// 所 有 这 些 类 都 支持 ICloneable 接 口 
string myStr = "Hello"; 
OperatingSystem unix0S = new OperatingSystem(PlatformID.Unix, new Version()); 
System.Data.SqlClient.SqlConnection sqlCnn = 
new System.Data.SqlClient.SqlConnection(); 


// 因此 ， 它 们 就 可 以 传 入 接口 ICloneable 的 方法 
CloneMe(myStr); 

CloneMe(unix0S); 

CloneMe(sqlCnn); 

Console.ReadLine(); 


} 


private static void CloneMe(ICloneable c) 


// 克隆 我 们 获得 的 并 输出 名 字 

object theClone = c.Clone(); 

Console.WriteLine("Your clone is a: {0}", 
theClone.GetType() .Name); 


} 
} 
如 果 我 们 运行 这 个 应 用 程序 ， 就 会 发 现 每 一 个 类 的 完整 名 都 被 输出 到 了 控制 台 。 这 是 通过 从 
System.0bject 中 继承 的 GetType() 方 法 来 实现 的 。 第 15 章 会 讲 到 , 这 个 方法 以 及 NET 反 射 服务 会 让 我 们 理 
解 运行 时 任何 类 型 的 组 成 。 任 何 情况 下 ， 前 一 个 项 目的 输出 都 如 下 所 示 : 





六 冰冰 冰冰 A First Look at Interfaces ***** 


Your clone is a: String 
Your clone is a: OperatingSystem 
Your clone is a: SqlConnection 





传统 抽象 基 类 的 另外 一 个 限制 就 是 每 一 个 派生 类 型 必须 处 理 这 一 组 抽象 成 员 并 且 提供 实现 。 为 了 
演示 这 个 问题 ， 回 忆 一 下 我 们 在 第 6 章 中 定义 的 图 形 层次 结构 。 假 设 我 们 在 Shape 基 类 中 新 定义 了 一 个 
叫 GetNumberOfPoints() 的 抽象 方法 ， 它 允许 派生 类 型 返回 演 染 图 形 所 需 的 顶点 数 : 


abstract class Shape 
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// 每 一 个 派生 类 型 都 必须 支持 这 个 方法 
public abstract byte GetNumberOfPoints(); 
显然 ， 只 有 Hexagon 类 型 才 拥有 项 点。 然而， 这 样 更 新 之 后 ， 所 有 派生 类 型 (Circle 、Hexagon 以 
及 ThreeDCircle ) 现在 都 必须 提供 这 个 方法 完整 的 实现 ， 即 使 这 么 做 没有 什么 意义 。 同 样 ， 接 口 类 型 
提供 了 解决 方案 。 如 果 我 们 定义 了 一 个 接口 来 表示 “有 顶点 ”这 个 行为 , 我们 就 可 以 把 它 插 到 Hexagon 
类 型 中 ，Circle 和 ThreeDCircle 则 不 受 影响 。 


源 代 码 ICloneableExample 项 目的 源 代 码 位 于 Chapter 8 子 目 录 下 。 


8.2 ”定义 自 定义 接口 

现在 我 们 较 好 地 理解 了 接口 类 型 的 总 体 作 用 , 那么 就 让 我 们 来 看 一 个 定义 和 实现 自 定义 接口 的 示 
例 。 首 先 ， 创建 一 个 全 新 的 控制 台 应 用 程序 CustomInterface。 使 用 Project 一 Add Existing Item 菜 单项 ， 
插入 在 第 6 章 Shapes 示 例 中 创建 的 包含 我 们 图 形 类 型 定义 的 文件 ( 本 书 解 决 方案 代码 中 的 Shape.cs )。 
然后 , 将 定义 图 形 相关 的 类 型 的 命名 空间 重 命名 为 CustomInterface ( 只 是 为 了 避免 将 命名 空间 定义 导 
入 到 我 们 的 新 项 目 中 ): 


namespace CustomInterface 


{ 
ap 


现在 ,使 用 Project 一 Add New Item 菜 单项 插入 一 个 新 接口 到 我 们 的 项 目 中 并 起 名 为 IPointy， 如 图 
8-1 所 示 。 


ome Search Installed Termplates 


Visual Cs [县 Type: Yisual Cr Rems 


SE] Windows Form Visual C# lems 
J User Control Vieual C# kems 
Component Class Visual Ce Rems 

User Control (WPAF) Visual C# Kems 


a AboutBox Visual Cs Rems 





图 8-1 和 类 相似 ， 接 口 可 以 定义 在 任何 *.cs 文 件 中 
从 语法 级 别 来 说 ， 接 口 使 用 C# interface 关 键 字 来 定义 。 和 类 不 一 样 的 是 ， 接 口 不 指定 基 类 ( 即使 
是 System.0bject; 然而 ， 正 如 你 在 本 章 将 看 到 的 那样 ， 接 口 可 以 指定 基 接 口 )。 而 且 接口 的 成 员 也 不 指 
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定 访问 修饰 符 ( 因为 所 有 接口 成 员 都 是 隐 式 公共 的 和 抽象 的 )。 这 里 是 一 个 使 用 C# 定 义 的 自 定义 接口 : 


// 这 个 接口 定义 了 “具有 顶点 ”的 行为 
public interface IPointy 


Dn 
byte GetNumberOfPoints(); 
记 住 ， 当 我 们 定义 接口 成 员 时 ， 不 需要 为 这 个 成 员 定义 实现 作用 域 。 接 口 是 纯 粹 的 协议 ， 因 此 也 
不 会 定义 实现 ( 留 给 支持 的 类 或 结构 )。 因 此 ， 如 下 版 本 的 IPointy 会 导致 各 种 编译 器 错误 : 
// 内 有 大 量 错误 


public interface IPointy 


{ 
// 错误 ! 接口 不 能 有 字段 
public int numbOfPoints; 


// 错误 | 接口 不 能 有 构造 函数 
public IPointy() { numbOfPoints = 0;}; 


// 错误 ! 接口 不 能 提供 实现 
byte GetNumberOfPoints() { return numbOfPoints; } 


不 管 怎 么 样 ， 原 始 的 IPointy 接 口 定义 了 一 个 方法 。 然 而 ，.NET 接 口 还 可 以 定义 许多 属性 协议 。 
例如 ， 我 们 可 以 使 用 只 读 属 性 而 不 是 其 他 的 访问 方法 来 创建 TPointy 接 口 : 


// 这 个 pointy 表 现 为 一 个 只 读 属性 
public interface IPointy 


// 在 接口 中 的 读 写 属性 差不多 是 retType PropName { get; set; } 
// 而 接口 中 的 只 写 属性 是 retType PropName { set; } 
byte Points { get; } 


说 明 接口 类 型 还 可 以 包含 事件 ( 见 第 10 章 ) 以 及 索引 器 ( 见 第 11 章 ) 定义 。 


接口 类 型 就 其 本 身 而 言 没 什么 用 ， 因 为 它们 只 是 抽象 成 员 的 集合 。 例 如 ， 我 们 不 能 像 类 和 结构 一 
样 分 配 接 口 类 型 : 


// 分 配 接 口 类 型 是 不 合法 的 
static void Main(string[] args) 


{ 
IPointy p = new IPointy(); // 编译 器 错误 


除非 被 类 或 结构 实现 ， 否 则 接口 没有 什么 用 。 在 这 里 ，IPointy 是 一 个 表示 “有 顶点 ”这 一 行为 的 
接口 。 原 因 很 简单 ,图 形 层次 结构 中 的 一 些 类 有 顶点 ( 如 Hexagon ), 而 其 他 一 些 则 没有 ( 比如 Circle )。 


8.3 ”实现 接口 


如 果 类 ( 或 结构 ) 选择 通过 支持 接口 来 扩展 功能 ， 就 需要 在 其 类 型 定义 中 使 用 逗号 分 隔 的 列表 。 
要 知道 直接 基 类 必须 是 冒号 操作 符 后 的 第 一 个 项 。 如 果 类 类 型 从 System.0bject 直 接 继承 , 我 们 完全 可 
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以 只 在 列表 中 提供 类 支持 的 接口 , 因为 如 果 没 有 特别 指明 ，C# 编 译 器 会 从 System.0bject 扩 展 我 们 的 类 
型 。 由 于 结构 总 是 从 System.ValueType 继 承 ( 完整 细节 见 第 4 章 )， 只 需要 在 结构 定义 后 直接 列 出 每 一 
个 接口 就 行 了 。 考 虑 如 下 的 示例 : 


// 这 个 类 派生 自 System.0bject 并 且 实 现 一 个 接口 
public class Pencil : IPointy 


aa 


// 这 个 类 也 派生 自 System.0bject 并 且 实 现 一 个 接口 
public class SwitchBlade : object, IPointy 
fae} 


// 这 个 类 派生 自 一 个 自 定 义 基 类 并 且 实 现 一 个 接口 
public class Fork : Utensil, IPointy 
ss} 


// 这 个 结构 隐 式 派生 自 System.ValueType 并 且 实 现 两 个 接口 
public struct Arrow : ICloneable, IPointy 
fe 


要 理解 ， 实 现 接口 是 一 个 “要 么 全 要 要 么 全 不 要 ”的 命题 ， 也 就 是 说 支持 类 型 无 法 选择 实现 哪些 
成 员 。 由 于 IPointy 接 口 定义 了 一 个 只 读 属 性 ， 因此 问题 不 大 。 然而， 如 果 我 们 要 实现 一 个 定义 10 个 成 
员 的 接口 〈 比如 前 面 说 的 IDbConnection 接 口 )， 这 个 类 型 就 需要 充实 10 个 抽象 实体 的 细节 。 

例如 , 插入 一 个 叫 Triangle 的 新 类 类 型 ， 它 是 一 个 Shape, 并 且 支 持 IPointy。 注意 只 读 属 性 Points 
的 实现 只 返回 正确 的 顶点 数 (3 ): 

// 名 为 Triangle (三 角形 ) 的 新 的 Shape 派 生 类 型 

Triangle : Shape, IPointy 


public Triangle() { } 

public Triangle(string name) : base(name) { } 

public override void Draw() 

{ Console.Writeline("Drawing {0} the Triangle", PetName); } 


// IPointy 实 现 
public byte Points 


get { return 3; } 


} 
现在 ， 更 新 既 有 的 Hexagon 类 型 来 支持 IPointy 接 口 类 型 ; 


// Hexagon 现 在 实现 IPointy 
class Hexagon : Shape, IPointy 


public Hexagon(){ } 

public Hexagon(string name) : base(name){ } 

public override void Draw() 

{ Console.WriteLine("Drawing {0} the Hexagon", PetName); } 


// IPointy 实 现 
public byte Points 


get { return 6; } 
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现在 来 总 结 一 下 ， 图 8-2 显 示 的 Visual Studio 类 结构 图 使 用 流行 的 “ 棒 棱 糖 ” 符 号 描述 了 与 TPointy 
兼容 的 类 。 注 意 ，Circle 和 ThreeDCircle 没 有 实现 IPointy， 因 为 这 个 行为 对 这 些 特殊 类 没有 意义 。 
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图 8-2 ”Shape 层 次 结构 ( 包含 接口 ) 


说 明 通过 右 击 接口 图 标 并 选择 Collapse 或 Expand， 可 以 分 别 显示 或 隐藏 类 设计 器 上 的 接口 名 称 。 


8.4 在 对 象 级 别 调用 接口 成 员 


现在 已 经 有 了 一 组 支持 IPointy 接 口 的 类 , 接 下 来 的 问题 就 是 如 何 使 用 这 些 新 功能 。 与 给 定 接口 功 
能 最 直接 的 交互 方式 就 是 直接 在 对 象 级 别 调用 方法 ( 所 提供 的 接口 成 员 不 是 显 式 实现 的 , 在 8.9 节 中 将 
有 详解 )。 例 如 ， 考 虑 下 面 的 Main() 方 法 : 


static void Main(string[] args) 
Console.Writeline("***** Fun with Interfaces 下 


// 调用 IPointy 定 义 的 Points 属 性 

Hexagon hex = new Hexagon(); 
Console.WriteLine("Points: {0}", hex.Points); 
Console.ReadLine(); 


由 于 读者 清楚 六 边 形 ( Hexagon ) 类 型 已 经 实现 了 该 接口 ， 有 了 points 属 性 ， 所 以 在 本 例 中 这 样 做 
没有 任何 问题 。 但 在 其 他 情况 下 ， 读 者 可 能 无 法 在 编译 时 判断 指定 类 型 支持 哪个 接口 。 例 如 ， 假 定 读 
者 有 一 个 包含 50 个 Shape 兼 容 类 型 的 数组 ， 其 中 仅 有 部 分 数组 支持 IPointy 接 口 。 很 明显 ， 如 果 试 图 在 
没有 实现 IPointy 接 口 的 类 型 中 调用 Points 属 性 , 将 收 到 编译 时 错误 。 接 下 来 的 问题 就 是 : 如 何 才能 动 
态 判 断 一 个 类 型 支持 哪些 接口 呢 ? 

在 运行 时 判断 一 个 类 型 是 否 支持 一 个 指定 接口 的 一 种 方式 是 使 用 显 式 强制 转换 。 如 果 这 个 类 型 不 
支持 被 请 求 的 接口 ， 将 收 到 一 个 无 效 转换 异常 ( InvalidCastException )。 使 用 结构 化 异常 处 理 妥善 处 
置 这 种 可 能 的 异常 ， 例 如 : 
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static void Main(string[] args) 


1 捕获 可 能 发 生 的 InvalidCastException 异 常 
Circle c = new Circle("Lisa"); 
IPointy itfPt = null; 
try 
itfpt = (IPointy)c; 
Console.Writeline(itfPt.Points); 
catch (InvalidCastException e) 


Console.WritelLine(e.Message); 


Console.ReadLine(); 


} 
使 用 try/catch 逻 辑 并 非 是 最 好 的 解决 方法 , 在 首次 调用 该 接口 成 员 之 前 判断 其 支持 哪个 接口 更 加 
理想 。 下 面 介绍 两 种 实现 方式 。 


8.4.1 获取 接口 引用 : as 关键 字 


判断 一 个 指定 类 型 是 否 支 持 一 个 接口 的 第 二 种 方式 就 是 使 用 第 6 章 介绍 的 as 关键 字 。 如 果 该 对 象 
可 被 视 为 一 个 指定 的 接口 ， 你 可 以 在 使 用 该 关键 字 的 语句 中 得 到 指向 该 对 象 接口 的 引用 ; 和 否则， 将 返 
回 一 个 值 为 nul1 的 空 引 用 。 因 此 ， 首 先 要 检查 nul1 值 : 


static void Main(string[] args) 


// 我 们 能 将 六 角形 hex2 视 为 实现 了 IPointy 接 口 吗 
Hexagon hex2 = new Hexagon("Peter"); 
IPointy itfpPt2 = hex2 as IPointy; 


if(itfpt2 != null) 

Console.WriteLine("Points: {0}", itfPt2.Points); 
else 

Console.WriteLine("00PS! Not pointy..."); 
Console.ReadLine(); 


} 
请 注意 ， 当 使 用 as 关键 字 的 时 候 ， 无 需 使 用 try/catch 罗 辑 。 如 果 引 用 非 空 ， 说 明 调 用 的 是 一 个 正 
确 的 接口 引用 。 


8.4.2 ”获取 接口 引用 : is 关键 字 


还 可 以 通过 使 用 is 关键 字 ( 第 6 章 介 绍 过 ) 来 检查 是 否 实 现 一 个 接口 。 如 果 要 考查 的 对 象 与 指定 
接口 不 符 , 将 返回 false 值 。 反 之 ， 如 果 该 类 型 与 指定 接口 相符 ， 就 可 以 安全 地 调用 这 些 成 员 ， 而 不 必 
使 用 try/catch 逻 辑 。 

假定 更 新 了 Shape 类 型 的 数组 ， 使 其 中 部 分 成 员 实 现 了 IPointy 接 口 。 注 意 ， 下 面 的 Main() 方 法 显 
示 了 如 何 使 用 is 关 键 字 判断 数组 中 哪些 项 支持 该 接口 : 
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static void Main(string[] args) 
Console.Writeline("***** Fun With Interfaces *****\n"); 
// 生 成 Shape 数 组 
Shape[] myShapes = { new Hexagon(), new Circle(), 
new Triangle("Joe"), new Circle("JoJjo")} ; 


for(int i = 0; i < myShapes.Length; i++) 


{ 
// 回调 Shape 基 类 定义 一 个 抽象 的 Draw() 成 员 ， 由 此 所 有 Shape 都 知道 如 何 绘 制 自己 
myShapes[i].Draw(); 
// 哪些 是 有 棱角 的 


if(myShapes[i] is IPointy) 

Console.WritelLine("-> Points: {0}", ((IPointy) myShapes[i]).Points); 
else 

Console.WritelLine("-> {0}\'s not pointy!", myShapes[i].PetName); 
Console.WriteLine(); 


Console.ReadLine(); 


输出 结果 如 下 所 示 : 
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Drawing NoName the Hexagon 
-> Points: 6 


Drawing NoName the Circle 
-> NoName's not pointy! 


Drawing Joe the Triangle 
-> Points: 3 


Drawing JoJo the Circle 
-> JoJo's not pointy! 
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8.5 ”接口 作为 参数 


既然 接口 是 有 效 的 .NET 类 型 ， 读 者 可 以 构造 将 接口 作为 参数 的 方法 ， 和 本 章 前 面 的 CloneMe() 一 
样 。 对 于 当前 的 示例 ， 假 定 已 经 定义 了 男 一 个 名 为 IDraw3D 的 接口 : 


// 模拟 能 以 绝 佳 3D 效 果 呈 现 一 个 类 型 的 能 力 
public interface IDraw3D 


void Draw3D(); 


接 下 来 ,假定 3 种 图 形 中 的 2 种 ( ThreeDCircle 与 Hexagon ) 已 经 被 设 定 为 支持 这 种 新 的 行为 : 


// Circle 支 持 IDraw3D 接 口 
class ThreeDCircle : Circle, IDraw3D 


{ 
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public void Draw3D() 
{ Console.WriteLine("Drawing Circle in 3D!"); } 


} 


// Hexagon 支 持 IPointy 与 TDraw3D 接 口 
class Hexagon : Shape, IPointy, IDraw3D 


{ 


public void Draw3D() 
{ Console.WritelLine("Drawing Hexagon in 3D!"); } 


图 8-3 所 示 为 新 的 Visual Studio 类 图 。 
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图 8-3 ”更 新 的 Shape 层 次 结构 


如 果 读 者 现在 定义 一 个 将 IDraw3D 接 口 作为 参数 的 方法 ， 将 能 有 效 传递 任何 实现 IDraw3D 接 口 的 对 
象 ( 如 果 读 者 试图 传 进 一 个 不 支持 该 接口 的 类 型 ， 将 收 到 编译 时 错误 )。 思 考 下 面 这 个 在 Program 类 中 
定义 的 方法 : 


// 绘制 任何 支持 IDraw3D 接 口 的 类 型 
static void DrawIn3D(IDraw3D itf3d) 


Console.WriteLine("-> Drawing IDraw3D compatible type"); 
itf3d.Draw3D(); 


可 以 测试 shape 数 组 中 的 项 是 否 支持 接口 ， 如 果 支 持 ， 就 将 其 传人 DrawIn3D() 方 法 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun With Interfaces *****\n"); 
Shape[] myShapes = { new Hexagon(), new Circle()， 
new Triangle(), new Circle("JoJo") } ; 
for(int i = 0; i < myShapes.Length; i++) 


// 支持 绘制 为 3D 吗 
if(myShapes[i] is IDraw3D) 
DrawIn3D( (IDraw3D)myShapes[i]); 
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下 面 是 修改 后 的 应 用 程序 的 输出 结果 。 注 意 只 有 Hexagon 对 象 以 3D 形 式 输出 ， Shape 数 组 的 其 他 
成 员 都 没有 实现 IDraw3D 接 口 : 
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Drawing NoName the Hexagon 

-> Points: 6 

-> Drawing IDraw3D compatible type 
Drawing Hexagon in 3D! 


Drawing NoName the Circle 
-> NoName's not pointy! 


Drawing Joe the Triangle 
-> Points: 3 


Drawing JoJo the Circle 
-> JoJo's not pointy! 





8.6 接口 作为 返回 值 


接口 也 可 以 被 用 来 作为 方法 的 返回 值 。 例如， 读者 可 以 写 一 个 接受 shape 对 象 数组 作为 参数 、 返 8 
回 支持 IPointy 的 第 一 项 的 引用 的 方法 : 


// 这 个 方法 返回 实现 IPointy 的 数组 中 的 第 一 个 对 象 
static IPointy FindFirstPointyShape(Shape[] shapes) 


foreach (Shape s in shapes) 


if (s is IPointy) 
return s as IPointy; 


return null; 


我 们 可 以 与 这 个 方法 按 如 下 代码 进行 交互 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Interfaces *****\n"); 
// 构建 Shape 数 组 
Shape[] myShapes = { new Hexagon(), new Circle(), 
new Triangle("Joe"), new Circle("]JoJo")}; 


// 获取 第 一 个 pointy 项 

// 安全 起 见 ， 在 使 用 前 最 好 检查 firstPointyItem 是 否 为 null 

IPointy firstPointyItem = FindFirstPointyShape(myShapes); 
Console.WritelLine("The item has {0} points", firstPointyItem.Points); 


8.7 ”接口 类 型 数组 
要 理解 的 是 ， 同 样 的 接口 即使 不 在 同一 个 类 层次 结构 ， 也 没有 除 System.0bject 以 外 的 公共 父 类 ， 
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也 可 以 由 多 个 类 型 实现 ， 这 可 以 派生 出 许多 非常 强大 的 编程 结构 。 例 如 ， 假 设 我 们 要 在 当前 项 目 中 开 
发 三 个 全 新 的 类 类 型 来 对 厨具 ( 通过 Knife 和 Fork 类 ) 和 园艺 设备 ( PitchFork， 指 干草 又 ) 建 模 。 如 
图 8-4 所 示 。 
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图 8-4 接口 可 以 插入 到 类 层次 结构 任何 部 分 的 类 型 中 


如 果 已 经 定义 了 PitchFork、Fork 和 Knife 类 型 ， 那 么 现在 可 以 定义 一 个 支持 IPointy 接 口 的 对 象 数 
组 。 既 然 这 些 成 员 都 支持 同样 的 接口 ， 因 此 可 以 抛 开 类 层次 结构 的 全 部 差异 性 ， 通 过 数组 进行 迭代 并 
将 每 个 对 象 视 为 支持 IPointy 接 口 的 对 象 : 


static void Main(string[] args) 
// 这 个 数组 仅仅 包含 实现 了 IPointy 接 口 的 类 型 
IPointy[] myPointyObjects = {new Hexagon(), new Knife(), 
new Triangle(), new Fork(), new PitchFork()}; 
foreach(IPointy i in myPointyObjects) 


Console.WritelLine("Object has {0} points.", i.Points); 
Console.ReadLine(); 


下 面 强调 一 下 这 个 示例 的 重要 性 ， 请 记 住 : 如 果 你 有 一 个 给 定 接口 的 数组 ， 那 么 这 个 数组 可 以 包 
含 实现 了 该 接口 的 任何 类 或 者 结构 。 


源 代 码 ”CustomInterface 项 目的 源 代 码 位 于 Chapter 8 的 子 目录 下 。 


8.8 使 用 Visual Studio 实现 接口 


尽管 基于 接口 编程 是 非常 强大 的 编程 技术 ， 实 现 接口 却 需要 大 量 的 代码 键入 。 由 于 接口 是 一 组 具 
名 的 抽象 成 员 ， 每 个 支持 该 行为 的 类 型 中 的 每 个 接口 方法 ， 都 需要 键入 定义 和 实现 。 
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正如 我 们 所 期 待 的 ，Visual Studio 支 持 多 个 工具 来 减少 实现 接口 的 工作 任务 量 。 通 过 简单 的 测试 ， 
将 最 后 一 个 类 插入 到 当前 项 目 PointyTestClass 中 。 当 实现 IPointy 接 口 (或 者 其 他 接口 ) 时 ， 注 意 当 完 
成 键 人 接口 名 称 或 在 代码 窗口 中 将 鼠标 光标 移 到 接口 名 称 上 时 ， 第 一 个 字母 是 带 下 划 线 的 ( 正式 名 称 
为 智能 标签 )。 单 击 智能 标签 ， 一 个 用 来 实现 接口 的 下 拉 列 表 将 显示 出 来 ， 如 图 8-5 所 示 。 


PointyTestClass.cs” 三 X PervedShapes.cs Shapescd Object Browser 2 
Custominterface.PointyTestClass > ~ 
Jusing System; 二 


using System,Collections.Generic; 

using Systes.Ling; 

Using System.Text; 

using System.Threading. Tasks; 
-namespace CustomInterface Et 


class PoinryTestCiass : Ipoingy | 
{ 仙 ~ 
} Implement interface TPointy’ BR 
Explicitly implement interface 'Pointy' 


图 8-5 ”使 用 Visual Studio 实 现 接口 


注意 图 中 有 两 个 选项 ， 下 一 节 将 详细 介绍 第 2 个 选项 ( 显 式 接口 实现 )。 选 定 第 一 个 选项 后 ， 将 看 
到 Visual Studio 在 一 个 已 命名 的 代码 区 块 中 内 置 生成 了 存根 代码 供 读者 修改 ( 注意 ， 其 中 默认 实现 抛 
出 System.NotImplementedException 异 常 ， 它 显然 能 被 删除 掉 )。 
. namespace CustomInterface 
class PointyTestClass : IPointy 
public byte Points 


get { throw new NotImplementedException(); } 


说 明 ”Visual Studio 还 支持 提取 Refactor 菜 单 中 的 接口 重 构 。 这 允许 我 们 从 既 有 类 定义 中 提取 新 的 接口 
定义 。 例 如 ， 你 可 能 在 编写 一 个 类 的 中 途 发 现 可 以 将 其 行为 归纳 为 一 个 接口 (这 样 就 可 以 提 
供 另 一 种 实现 )。 


8.9 显 式 接口 实现 


之 前 说 过 ,一 个 类 或 结构 可 以 实现 许多 接口 。 因 此 ， 我们 可 能 实现 包含 重复 命名 成 员 的 接口 ， 所 
以 就 需要 处 理 命名 冲突 。 为 了 演示 解决 这 个 问题 的 各 种 方式 , 新 建 一 个 叫 InterfaceNameClash 的 控制 台 
应 用 程序 。 现 在 设计 3 个 自 定义 接口 来 表示 实现 类 型 呈现 自身 输出 的 各 种 位 置 : 
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// 绘制 到 表单 上 

public interface IDrawToForm 
void Draw(); 

// 绘制 到 内 存 中 

public interface IDrawToMemory 
void Draw(); 

// 呈现 到 打印 机 

public interface IDrawToPrinter 


void Draw(); 


注意 , 每 一 个 接口 都 定义 了 Draw() 方 法 , 其 名 称 相同 ( 碰巧 都 没有 参数 )。 如 果 我 们 现在 希望 一 个 
名 为 0ctagon 的 类 类 型 支持 这 些 接口 中 的 每 一 个 ， 编 译 器 会 允许 如 下 的 定义 : 
class Octagon : IDrawToForm, IDrawToMemory, IDrawToPrinter 


public void Draw() 
// 共享 绘制 还 辑 


Console.WritelLine("Drawing the Octagon..."); 
} 
尽管 这 段 代 码 可 以 通过 编译 ， 你 可 能 也 认为 我 们 会 有 问题 。 简 单 来 说 ， 如 果 提 供 一 个 Draw() 方 法 
实现 ,我 们 就 不 能 从 0ctagon 对 象 根据 某 个 接口 采取 一 系列 行动 。 例 如 ,下 面 的 代码 会 调用 相同 的 Draw(). 
方法 ， 而 不 管 我 们 获取 到 哪个 接口 : 


static void Main(string[] args) 


Console.WritelLine("***** Fun with Interface Name Clashes *****\n"); 
// 所 有 这 些 调用 部 会 调用 相同 的 Draw() 方 法 
Octagon oct = new Octagon(); 


IDrawToForm itfForm = (IDrawToForm)oct; 
itfForm.Draw(); 


IDrawToPrinter itfpriner = (IDrawToPrinter)oct; 
itfpriner.Draw(); 


IDrawToMemory itfMemory = (IDrawToMemory)oct; 
itfMemory .Draw( ); 


Console.ReadLine(); 


显然 ， 把 图 像 呈现 到 窗 体 的 代码 和 把 图 像 呈 现 到 网 络 打印 机 或 内 存 中 某 个 区 域 的 代码 不 太一 样 。 
如 果 要 实现 具有 相同 成 员 的 接口 ， 可 以 使 用 显 式 接口 实现 语法 来 解决 这 种 命名 冲突 。 考 虑 如 下 对 
0ctagon 类 型 的 更 新 : 


class Octagon : IDrawToForm, IDrawToMemory, IDrawToPrinter 
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// 对 某 个 接口 显 式 绑 定 Draw() 
void IDrawToForm.Draw() 
Console.WriteLine("Drawing to form..."); 
void IDrawToMemory .Draw() 
Console.WritelLine("Drawing to memory..."); 
void IDrawToprinter.Draw() 
Console.WriteLine("Drawing to a printer..."); 
i 
我 们 可 以 看 到 ， 如 果 显 式 实现 接口 成 员 的 话 ， 大 致 模式 可 以 归结 为 : 





returnType InterfaceName.MethodName(params){} 








如 果 使 用 这 个 语法 ,我 们 只 需要 提供 一 个 访问 修饰 符 ， 显 式 实现 的 成 员 是 自动 私有 的 。 例 如 ， 下 
面 的 语法 是 不 合法 的 : 


// 错误 ! 没有 访问 修饰 符 
public void IDrawToForm.Draw() eB 
Console.WritelLine("Drawing to form..."); 


由 于 显示 实现 的 成 员 总 是 隐 式 私有 的 ， 这 些 成 员 在 对 象 级 别 就 不 可 用 。 其 实 ， 如 果 我 们 把 点 操作 
符 应 用 到 0ctagon 类 型 ， 就 会 发 现 智能 感知 不 会 显示 我 们 的 Draw() 方 法 。 可 以 想象 , 我 们 必须 使 用 显 式 
转换 来 访问 需要 的 功能 。 例 如 : 


static void Main(string[] args) 


Console.WTiteLine("##k## Fun with Interface Name Clashes ***+**\n"); 
Octagon oct = new Octagon(); 


// 现在 必须 使 用 转换 来 访问 Draw() 成 页 
IDrawToForm itfForm = (IDrawToForm)oct; 
itfForm.Draw( ) ; 


// 如 果 以 后 不 需要 接口 变量 ， 可 以 简化 成 这 个 形式 
((IDrawToPrinter)oct).Draw(); 


// 也 可 以 使 用 “as” 关 键 字 
if(oct is IDrawToMemory ) 
((IDrawToMemory)oct).Draw(); 


Console.ReadLine(); 


虽然 这 个 语法 对 解决 命名 冲突 很 有 用 ， 但 是 如 果 希 望 从 对 象 级 别 隐藏 “高 级 ”成 员 的 话 ， 我 们 也 
可 以 使 用 显 式 接口 实现 。 这 样 , 如 果 对 象 用 户 使 用 点 操作 符 的 话 , 他 就 只 能 看 到 类 型 所 有 功能 的 子 集 。 
然而 ， 那 些 需要 更 多 高 级 行为 的 人 可 以 通过 显 式 转换 提取 需要 的 接口 。 


源 代码 ”InterfaceNameClash 项 目的 源 代码 位 于 Chapter 8 子 目 录 下 。 


8.10 设计 接口 层次 结构 

接口 可 以 组 织 成 接口 层次 结构 。 和 类 层次 结构 相似 ， 如 果 接 口 扩展 了 既 有 接口 ， 它 就 继承 了 父 类 
定义 的 抽象 成 员 。 当 然 ， 和 基于 类 的 继承 不 同 的 是 ， 派 生 接 口 不 会 继承 真正 的 实现 ， 而 只 是 通过 额外 
的 抽象 成 员 扩 展 了 其 自身 的 定义 。 

如 果 和 希望 扩展 既 有 接口 功能 又 不 变动 既 有 代码 ， 接 口 层次 结构 就 会 很 有 用 。 为 了 举例 说 明 ， 让 我 
们 新 建 一 个 控制 台 应 用 程序 InterfaceHierarchy。 现在， 让 我 们 重新 设计 之 前 的 一 组 与 呈现 相关 的 接口 ， 
这 样 IDrawable 就 是 家 族 树 的 根 : 


public interface IDrawable 


void Draw(); 


由 于 IDrawable 定 义 了 基本 绘制 行为 , 我们 现在 就 可 以 创建 派生 接口 来 扩展 以 修改 后 的 格式 呈现 的 
能 力 ， 例 如 : 


public interface IAdvancedDraw : IDrawable 


void DrawInBoundingBox(int top, int left, int bottom, int right); 
void DrawUpsideDown(); 


有 了 这 样 的 设计 ， 如果 一 个 类 实现 IAdvancedDraw, 我 们 现在 就 必须 实现 在 继承 链 上 定义 的 每 一 个 
成 员 (更 准确 地 说 是 Draw()、DrawInBoundingBox() 和 DrawUpsideDown() 方 法 ) : 


public class BitmapImage : IAdvancedDraw 
public void Draw() 


Console.WritelLine("Drawing..."); 


public void DrawInBoundingBox(int top, int left, int bottom, int right) 


Console.WritelLine("Drawing in a box..."); 


public void DrawUpsideDown() 
Console.WriteLine("Drawing upside down!"); 


} 
现在 ， 使 用 BitmapImage 时 ， 可 以 在 对 象 级 别 上 调用 每 一 个 方法 (因为 它们 都 是 公有 的 )， 也 可 以 
通过 显 式 转换 提取 每 一 个 支持 接口 的 引用 : 


static void Main(string[] args) 


Console.WriteLine("***** Simple Interface Hierarchy *****"); 
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// 从 对 象 级 别 调用 

BitmapImage myBitmap = new BitmapImage(); 
myBitmap.Draw(); 
myBitmap.DrawInBoundingBox(10, 10, 100, 150); 
myBitmap.DrawUpsideDown(); 


// 显 式 获取 IAdvancedDraw 
IAdvancedDraw iAdvDraw = myBitmap as IAdvancedDraw; 
If(iAdvDraw ! = null) 

iAdvDraw.DrawUpsideDown(); 


Console.ReadLine(); 


源 代 码 ”InterfaceHierarchy 项 目的 源 代码 位 于 Chapter 8 子 目 录 下 。 


接口 类 型 的 多 重 继 承 


和 类 类 型 不 同 ， 一 个 接口 可 以 扩展 多 个 基 接 口 。 这 就 允许 我 们 设计 非常 强大 、 非 常 灵 活 的 抽象 。 
新 建 一 个 控制 台 应 用 程序 MIInterfaceHierarchy。 这 是 一 套 全 新 的 接口 ， 模 拟 了 各 种 呈现 以 及 图 形 相关 
的 抽象 。 注 意 IShape 接 口 扩展 了 IDrawable 和 IPrintable: 


// 接口 可 以 是 多 重 继 承 的 
interface IDrawable 





void Draw(); 


interface IPrintable 


void Print(); 
void Draw(); // 《<-- 注意 ， 可 能 导致 命名 冲突 


// 多 重 接口 继承 。 没 有 问题 
interface IShape : IDrawable, IPrintable 


int GetNumberOfSides(); 


图 8-6 说 明了 当前 的 接口 层次 结构 。 
现在 ， 关 键 问题 就 是 如 果 我 们 有 一 个 类 支持 IShape， 需 要 实现 多 少 方法 呢 ? 回答 是 : 看 情况 。 如 
果 和 希望 提供 Draw() 的 简单 实现 ， 只 需要 提供 3 个 成 员 ， 如 下 面 的 Rectangle 类 型 所 示 : 


class Rectangle : IShape 


public int GetNumberOfSides() 
{ return 4; } ” 


public void Draw() 
{ Console.MNriteLine("Drawing..."); } 


public void Print() 
{ Console.WritelLine("Prining..."); } 














IShape 
接口 

~ IDrawable 
~ IPrintablie 


图 8-6 ”和 类 不 一 样 ， 接 口 可 以 扩展 多 个 接口 类 型 


如 果 我 们 更 愿意 对 每 一 个 Draw() 方 法 提供 特定 实现 ( 这 里 应 该 比较 有 意义 的 ), 就 可 以 使 用 显 式 接 
口 实现 解决 命名 冲突 ， 如 下 面 的 Square 类 型 所 示 : 


class Square : IShape 


// 使 用 显 式 实现 来 处 理 成 员 命 名 冲突 
void IPrintable.Draw() 


{ // 绘制 到 打印 机 上 
void IDrawable.Draw() 
| // 绘制 到 屏幕 上 
public void Print() 
5 打印 


public int GetNumberOfSides() 
{ return 4; } 


} 

至 此 , 你 应 该 比较 熟悉 使 用 C# 滞 法 来 定义 和 实现 自 定义 接口 的 过 程 了 。 坦 白地 说 , 基于 接口 的 编 
程 不 是 那么 容易 理解 的 ， 如 果 你 确实 还 有 点 糊涂 ， 这 完全 是 正常 的 。 

然而 ， 需 要 知道 ， 接 口 是 .NET 框 架 的 一 个 基本 方面 。 不 管 我 们 在 开发 什么 类 型 的 应 用 程序 ( 基 
于 Web、 桌 面 GUI 还 是 数据 访问 类 库 等 )， 总 会 要 用 到 接口 。 最 后 来 总 结 一 下 ,接口 在 以 下 情况 下 特 
别 有 用 : 

口 只 有 一 个 层次 结构 ， 但 是 只 有 一 个 派生 类 型 的 子 集 支 持 公共 行为 ; 

口 需要 构建 的 公共 行为 跨 多 个 层次 结构 ， 而 且 除 了 System.0bject 以 外 ， 没 有 其 他 公共 父 类 。 

既然 我 们 已 经 研究 了 构建 和 实现 自 定义 接口 的 细节 , 本 章 剩余 部 分 会 研究 在 ,NET 基础 类 库 中 包含 
的 许多 预定 义 接口 。 


源 代码 ”MIInterfaceHierarchy 项 目的 源 代 码 位 于 Chapter 8 子 目 录 下 。 
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8.11 构建 可 枚 举 类 型 (IEnumerable 和 IEnumerator ) 


为 了 开始 对 实现 既 有 .NET 接 口 的 研究 ， 让 我 们 先 看 一 下 IEnumerable 和 IEnumerator 的 作用 。 回 忆 
一 下 ，C# 支 持 关 键 字 foreach， 人 允许 我 们 遍历 任何 数组 类 型 的 内 容 : 


// 遍历 数组 的 项 
int[] myArrayOfInts = {10, 20, 30, 40}; 


foreach(int i in myArrayOfInts) 


Console.WriteLine(i); 


虽然 看 上 去 只 有 数组 类 型 才 可 以 使 用 这 个 结构 ， 其 实 任 何 支持 GetEnumerator() 方 法 的 类 型 都 可 以 
通过 foreach 结 构 进行 运算 。 举 例 说 明 ， 首 先 新 建 一 个 叫 CustomEnumerator 的 控制 台 应 用 程序 。 然 后 ， 
增加 在 第 7 章 SimpleException 示 例 中 定义 的 Carcs 和 Radio.cs 文 件 (通过 Project 一 Add Existing Item 菜 
单项 )。 


说 明 ”你 可 能 希望 将 包含 Car 和 Radio 类 型 的 命名 空间 重 命 名 为 CustomEnumerator， 这 样 就 可 以 避免 将 
CustomException 命 名 空间 导入 到 新 项 目 中 。 


现在 ， 插 入 一 个 新 类 Garage， 它 在 System.Array 中 保存 了 一 组 Car 类 型 : 


// Garage 包 含 一 组 Car 对 象 
public class Garage 


private Car[] carArray = new Car[4]; 


// 启动 时 填充 一 些 Car 对 象 
public Garage() 
{ 


carArray[0] = new Car("Rusty", 30); 
carArray[1] = new Car("Clunker", 55); 
carArray[2] = new Car("Zippy", 30); 
carArray[3] = new Car("Fred", 30); 


} 
理想 情况 下 ， 与 数据 值 数 组 一 样 ， 使 用 foreach 构 造 迭代 Garage 对 象 中 的 每 个 子 项 比较 方便 : 
// 这 看 起 来 好 像 是 可 行 的 


public class Program 
static void Main(string[] args) 


Console.WriteLine("***** Fun with IEnumerable / IEnumerator *****\n"); 
Garage carlot = new Garage(); 


// 移交 集合 中 的 每 个 Car 对 象 吗 
foreach (Car c in carLot) 


Console.WritelLine("{0} is going {1} MPH"， 
Cc.PetName, c.CurrentSpeed); 





Console.ReadLine(); 
} 


让 人 泪 丧 的 是 ,编译 器 通知 我 们 Garage 类 没有 实现 名 为 GetEnumerator() 的 方法 。 这 个 方法 是 由 隐 
藏 在 System.Collections 命 名 空间 中 的 IEnumerable 接 口 定义 的 。 


说 明 下 一 章 将 介绍 泛 型 的 作用 以 及 System.Collections.Generic 命 名 空间 。 你 将 看 到 ， 该 命名 空间 
包含 IEnumerab]le/IEnumerator 的 泛 型 版 本 ， 它 为 子 对 象 的 迭代 提供 类 型 更 加 安全 的 方式 。 


支持 这 种 行为 的 类 或 结构 实际 上 是 在 宣告 它们 向 调用 者 ( 如 foreach 关 键 字 本 身 ) 公 开 了 所 包含 的 
子 项 ， 下 面 是 标准 的 .NET 接 口 定 义 : 


// 这 个 接口 告知 调用 方 对 象 的 子 项 可 以 枚 举 
public interface IEnumerable 


IEnumerator GetEnumerator(); 


可 以 看 到 ，GetEnumerator() 方 法 返回 一 个 对 另 一 个 接口 System.Collections.IEnumerator 的 引用 。 
这 个 接口 提供 了 基础 设施 ， 调 用 方 可 以 用 来 移动 Tinumerable 兼 容 容器 包含 的 内 部 对 象 : 


// 这 个 接口 允许 调用 方 获取 一 个 容器 的 子 项 
public interface IEnumerator 


{ 
bool MoveNext (); // 将 光标 的 内 部 位 置 向 前 移动 
object Current { get;}  // 获取 当前 的 项 (只 读 属 性 ) 
ts // 将 光标 重 置 到 第 一 个 成 员 前 面 


如 果 想 修改 Garage 类 型 使 之 支持 这 些 接口 ， 可 以 手工 实现 每 个 方法 ， 这 需要 花费 不 少 精力 。 虽 然 
自己 开发 GetEnumerator() 、MoveNext() 、Current 和 Reset() 也 没 问题 ， 但 有 一 个 更 简单 的 办 法 。 因 为 
System.Array 类 型 和 其 他 许多 类 型 已 经 实现 了 IEnumerable 和 IEnumerator 接 口 , 你 可 以 简单 地 将 请 求 委 
托 到 System.Array， 如 下 所 示 : 


using System.Collections; 
public class Garage : IEnumerable 


// System.Array 已 经 实现 了 IEnumerator 
private Car[] carArray = new Car[4]; 


public Garage() 

{ 
carArray[0] = new Car("FeeFee", 200, 0); 
carArray[1] = new Car("Clunker", 80, 0); 
carArray[2] = new Car("Zippy", 30, 0); 
carArray[3] = new Car("Fred", 30, 0); 


public IEnumerator GetEnumerator() 


// 返回 数组 对 象 的 [Enumerator 
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return carArray.GetEnumerator(); 
} 
} 
修改 Garage 类 型 之 后 , 就 可 以 在 C# foreach 结 构 中 安全 使 用 该 类 型 了 。 除 此 之 外 , GetEnumerator() 
被 定义 为 公开 的 ， 对 象 用 户 可 以 与 IEnumerator 类 型 交互 : 


// 手动 与 IEnumerator 协 作 

IEnumerator i = carLot.GetEnumerator(); 

i.MoveNext(); 

Car myCar = (Car)i.Current; 

Console.WritelLine("{0} is going {1} MPH", myCar.PetName, myCar.CurrentSpeed); 
如 果 和 希望 在 对 象 级 隐藏 IEnumerable 的 功能 ， 只 需要 使 用 显 式 接口 实现 就 行 了 : 


IEnumerator IEnumerable.GetEnumerator() 


// 返回 数组 对 象 的 [Enumerator 
return carArray.GetEnumerator(); 


这 样 的 话 , 对 象 用 户 就 不 能 找到 Garage 的 GetEnumerator() 方 法 ,而 foreach 结 构 会 在 必要 的 时 候 在 
背后 获得 接口 。 


源 代码 CustomEnumerator 项 目的 源 代 码 位 于 Chapter 8 子 目录 下 。 





8.11.1 用 yield 关 键 字 构 建 迭代 器 方法 


在 以 前 ， 如 果 我 们 希望 构建 支持 foreach 枚 举 的 自 定 义 集合 ( 如 Garage )， 只 能 实现 IEnumerable 接 
口 (可 能 还 有 IEnumerator 接 口 )。 然 而 ， 还 可 以 通过 和 迭代 器 来 构建 使 用 foreach 循 环 的 类 型 。 

简单 来 说 ,迭代 器 就 是 这 样 一 个 成 员 方 法 , 它 指定 了 容器 内 部 项 被 foreach 处 理 时 该 如 何 返 回 。 虽 
然 迭 代 器 方法 还 必须 命名 为 GetEnumerator(), 返回 值 还 是 必须 为 IEnumerator 类 型 , 但 自 定义 类 不 需要 
实现 原来 那些 接口 了 。 

为 了 演示 ， 新 建 一 个 Console Application 项 目 CustomEnumeratorWithYield， 并 添加 前 面 示例 中 的 
Car 、Radio 和 Garage 类 型 ( 如 果 愿 意 的 话 , 可 以 将 命名 空间 的 名 称 改 为 当前 项 目 ), 现 在 ,对 当前 的 Garage 
类 型 做 如 下 改进 : 


public class Garage:IEnumerator 
private Car[] carArray = new Car[4]; 


// 迭代 器 方法 
public IEnumerator GetEnumerator() 


foreach (Car c in carArray) 


yield return cj; 
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注意 ， 这 个 GetEnumerator() 的 实现 使 用 内 部 foreach 轩 辑 迭 代 每 个 子 项 ， 使 用 新 的 yield return 
语法 向 调用 方 返回 每 个 Car 对 象 。yield 关 键 字 用 来 向 调用 方 的 foreach 结 构 指 定 返回 值 。 当 到 达 yield 
return 语 句 后 ， 当 前 位 置 被 存储 下 来 ， 下 次 调用 和 迭代 器 时 会 从 这 个 位 置 开 始 执行 。 

和 迭 代 咒 方法 不 一 定 要 通过 foreach 关 键 字 来 返回 内 容 。 我 们 也 可 以 使 用 如 下 代码 定义 迭 代 器 方法 : 


public IEnumerator GetEnumerator() 


yield return carArray[0]; 
yield return carArray[1]; 
yield return carArray[2]; 
yield return carArray[3]; 


在 这 个 实现 中 ,注意 6etEnumerator() 方 法 显 式 返回 新 的 值 给 调用 者 。 虽 然 对 于 这 个 示例 来 说 意义 
不 是 很 大 ， 因 为 如 果 我 们 为 carArray 成 员 变 量 增加 更 多 对 象 的 话 ，GetEnumerator() 方 法 就 不 会 同步 。 
但 是 ， 如 果 我 们 希望 方法 返回 能 被 foreach 语 法 处 理 的 局 部 数据 ， 这 个 语法 就 很 有 用 。 


8.11.2 构建 命名 迭代 器 


还 有 有 趣 的 一 点 是 ，yield 关 键 字 从 技术 上 说 可 以 结合 任何 方法 一 起 使 用 ， 无 论 方法 名 是 什么 。 
这 些 方法 ( 技术 上 称 为 命名 迭代 器 ) 独特 之 处 在 于 可 以 接受 许多 参数 。 如 果 构 建 命名 迭代 器 的 话 ， 需 
要 知道 这 些 方法 会 返回 IEnumerable 接 口 , 而 不 是 预计 的 IEnumerator 兼 容 类 型 .例如 ,我们 可 以 为 Garage 
类 型 增加 如 下 方法 : 


public IEnumerable GetTheCars(bool ReturnReversed) 


// 逆序 返回 项 
if (ReturnReversed) 


for (int i = carArray.Length; i != 0; i--) 
yield return carArray[i-1]; 


} 


else 


// 按 顺序 返回 数组 中 的 项 
foreach (Car c in carArray) 


yield return c; 


} 
} 


注意 ,我 们 的 新 方法 允许 调用 者 以 正 序 和 逆序 ( 如 果 传人 的 参数 值 为 true ) 来 获取 子 项 。 我 们 可 
以 按 如 下 所 示 的 代码 和 新 方法 进行 交互 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with the Yield Keyword *****\n"); 
Garage carLot = new Garage(); 


// 使 用 GetEnumerator() 获 取 项 
foreach (Car c in carLot) 
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Console.WiriteLine("{o} is going {1} MPH", 
c.PetName, c.CurrentSpeed); 


Console.WritelLine(); 


// 使 用 命名 和 迭代 器 来 获取 项 (逆序 ) 


foreach (Car c in carLot.GetTheCars(true) ) 


Console.WritelLine("{0} is going {1} MPH”， 
c.PetName, c.CurrentSpeed); 


Console.ReadLine(); 


命名 迭代 器 是 很 有 用 的 结构 ， 因 为 一 个 自 定义 容器 可 以 定义 多 重 方式 来 请 求 返回 的 集 。 

那么 ， 总结 一 下 可 枚 举 对 象 的 构建 吧 。 记 住 ， 如 果 自 定义 类 型 要 和 C# 的 foreach 关 键 字 一 起 使 用 
的 话 ， 容 器 就 需要 定义 一 个 名 为 GetEnumerator() 的 方法 ， 它 由 IEnumerator 接 口 类 型 来 定制 。 通 常 ， 这 
个 方法 的 实现 只 是 交 给 保存 子 对 象 的 内 部 成 员 ， 然 而 ， 我 们 也 可 以 使 用 yield return 语 法 来 提供 多 个 
“命名 迭代 器 ”方法 。 


源 代码 ”CustomEnumeratorWithYield 项 目的 源 代 码 位 于 Chapter 8 子 目 录 下 。 [ie 
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回忆 一 下 第 6 章 ，System.0bject 定 义 了 一 个 名 为 MemberwiseClone() 的 成 员 。 这 个 方法 用 来 获取 当 
前 对 象 的 一 份 浅 复制 。 因 为 它 是 受 保护 的 ， 对 象 用 户 不 会 直接 调用 这 个 方法 ， 而 一 个 对 象 可 能 在 克隆 
过 程 中 自己 调用 这 个 方法 。 为 便于 说 明 , 创建 一 个 名 为 CloneablePoint 的 新 控制 台 应 用 程序 项 目 ， 其 中 
定义 了 一 个 名 为 Point 的 类 : 


// 一 个 名 为 Point 的 类 
public class Point 


public int X {get; set;} 
public int Y {get; set;} 


public Point(int xPos, int ypPos) { X = xPos; Y = yPos;} 
public Point(){} 


// 重 写 Object.ToString() 
public override string ToString() 
{ return string.Format("X = {0}; Y = {1}", xX, Y ); } 


在 第 4 章 中 你 已 经 知道 了 引用 类 型 与 值 类 型 ， 注 意 如 果 给 一 个 引用 变量 分 配 男 一 个 引用 变量 ,将 
有 两 个 引用 指向 内 存 中 的 同一 个 对 象 。 下 面 的 赋值 操作 将 导致 两 个 引用 指向 堆 上 的 同一 个 point 对 象 ， 
通过 任何 一 个 引用 都 能 修改 堆 上 的 同一 对 象 : 


static void Main(string[] args) 
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Console.WriteLine("***** Fun With Object Cloning *****\n"); 
// 指向 同一 对 象 的 两 个 引用 

Point p1 = new Point(50, 50); 

Point p2 = p1; 

p2.X = 0; 

Console.WriteLine(p1); 

Console.WriteLine(p2); 

Console.ReadLine(); 


} 
如 果 读 者 想 使 自己 的 自 定义 类 型 支持 向 调用 方 返回 自身 同样 副本 的 能 力 ， 需 要 实现 标准 
ICloneable 接 口 。 如 在 本 章 开 头 提 到 的 ， 这 个 类 型 定义 了 一 个 简单 的 方法 Clone(): 


public interface ICloneable 


object Clone(); 


很 明显 , 不 同 对 象 的 Clone() 方 法 实现 不 一 样 。 但 基本 功能 差不多 , 都 是 将 成 员 变 量 的 值 复制 到 同 
类 型 的 新 对 象 实例 ， 然 后 向 用 户 返 回 该 实例 。 思 考 下 面 Point 类 的 更 新 : 


// Point 现 在 支持 克隆 能 力 
public class Point : ICloneable 


public int X { get; set; } 
public int Y { get; set; } 


public Point(int xPos, int yPos) { X = xPos; Y = yPos; } 
public Point() { } 


// 重 写 0bject.ToString() 
public override string ToString() 
{ return string.Format("X = {0}; Y = {1}", Xx, Y); } 


// 返回 一 个 当前 对 象 的 副本 
public object Clone() 
{ return new Point(this.X, this.Y); } 


} 
这 样 我 们 就 可 以 创建 完全 独立 的 Point 类 型 的 副本 了 ， 如 下 所 示 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Object Cloning *****\n"); 
// 请 注意 Clone() 返 回 了 一 个 通用 的 对 象 类 型 

// 读者 需要 显 式 转换 来 获取 派生 类 型 

Point p3 = new Point(100, 100); 

Point p4 = (Point)p3.Clone(); 


// 改变 p4.x 将 不 影响 p3.x 
p4.X = 0; 


// 输出 每 个 对 象 
Console.WritelLine(p3); 
Console.WriteLine(p4); 
Console.ReadLine(); 


虽然 现在 的 Point 实 现 可 以 满足 需要 ， 但 我 们 再 做 一 些 改进 。 因 为 Point 类 型 并 不 包含 内 部 引用 类 
型 变量 ， 可 以 按 如 下 代码 所 示 简 化 Clone() 方 法 的 实现 : 
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public object Clone() 
// 逐个 复制 每 个 Point 字 段 成 员 
return this.MemberwiseClone(); 
请 注意 , 如果 Point 包 含 任何 引用 类 型 成 员 变 量 , MemberwiseClone() 将 这 些 引 用 复制 到 对 象 中 ( 即 
浅 复 制 )，。 如 果 读 者 想 要 支持 真正 的 深 复制 ,需要 在 克隆 过 程 中 创建 任何 引用 类 型 变量 的 新 实例 ， 让 
我 们 来 看 看 示例 。 


更 复杂 的 克隆 示例 


假定 Point 类 包含 一 个 PointDescription 类 型 的 引用 类 型 成 员 变 量 。 这 个 类 保存 一 个 点 的 友好 名 称 
( friendly name ) 和 表示 为 一 个 System.Guid 的 标识 号 。( 对 没有 COM 背 景 的 读者 ， 这 里 解释 一 下 ， 全 局 
唯一 标识 符 [GUID] 是 一 个 静态 的 唯一 的 128 位 数字 。) 下 面 是 具体 实现 : 


// 这 个 类 定义 了 一 个 点 
public class PointDescription 


{ 
public string PetName {get; set;} 
public Guid PointID {get; set;} 


public PointDescription() 
t 


PetName = "No-name"; 
PointID = Guid.NewGuid(); 
} 
} 


之 前 对 Point 类 的 更 新 包括 修改 Tostring()， 以 说 明 状 态 数据 、 定 义 并 创建 PointDescription 引 用 
类 型 。 为 了 允许 外 部 对 象 为 Point 创 建 一 个 昵称 ， 要 修改 传 进 重 载 构造 函数 的 参数 : 
public class Point : ICloneable 
public int X { get; set; } 
public int Y { get; set; } 
public PointDescription desc = new PointDescription(); 


public Point(int xPos, int ypPos, string petName) 


X = xPos; Y = yPos; 
desc.PetName = petName; 


} 
public Point(int xPos, int yPos) 
{ 
X = xPos; Y = yPos; 
} 
public Point() { } 


// 重 写 Object.ToString() 
public override string ToString() 


return string.Format("X = {0}; Y = {1}; Name = {2};\nID = {3}\n", 
X, Y, desc.PetName, desc.PointID); 
} 


248 第 8 章 接口 





// 返回 当前 对 象 的 副本 
public object Clone() 
{ return this.MemberwiseClone(); } 


} 
注意 ， 至今 我 们 仍 没有 修改 Clone() 方 法 。 所 以 如 果 对 和 象 用 户 使 用 当前 实现 请 求 复 制 , 将 得 到 一 
个 逐 项 浅 复制 。 为 便于 说 明 ， 假 定 读者 已 经 修改 了 Main() 方 法 ， 具 体 如 下 : 


static void Main(string[] args) 

{ 
Console.WritelLine("***** Fun with Object Cloning *****\n"); 
Console.WritelLine("Cloned p3 and stored new Point in p4"); 
Point p3 = new Point(100, 100, "Jane"); 
Point p4 = (Point)p3.Clone(); 


Console.WritelLine("Before modification:"); 
Console.WriteLine("p3: {0}", p3); 
Console.Writeline("p4: {0}", p4); 
p4.desc.PetName = "My new Point"; 

p4.X = 9; 


Console.WritelLine("\nChanged p4.desc.petName and p4.X"); 
Console.WriteLine("After modification:"); 
Console.WritelLine("p3: {0}", p3); 

Console.WritelLine("p4: {0}", p4); 

Console.ReadLine(); 


} 
注意 ， 当 值 类 型 被 改变 时 ， 内 部 引用 类 型 保存 的 是 修改 后 的 值 ， 因 为 它们 在 内 存 中 “指向 ”同样 
的 对 象 ( 特别 需要 注意 的 是 ， 这 些 对 象 的 昵称 现在 是 My new Point )。 输 出 结果 如 下 所 示 : 





FU With Object Cloning .wk 下 


Cloned p3 and stored new Point in p4 
Before modification: 

p3: X = 100; Y = 100; Name = Jane; 

ID = 133d66a7-0837-4bd7-95c6-b22ab0434509 


p4: X = 100; Y = 100; Name = Jane; 
ID = 133d66a7-0837-4bd7-95c6-b22ab0434509 


Changed p4.desc.petName and p4.X 

After modification: 

p3: X = 100; Y = 100; Name = My new Point; 
ID = 133d66a7-0837-4bd7-95c6-b22ab0434509 


p4: X = 9; Y = 100; Name = My new Point; 
ID = 133d66a7-0837-4bd7-95c6-b22ab0434509 


为 使 Clone() 方 法 得 到 内 部 引用 类 型 的 深 复制 , 需要 设 定 由 MemberwiseClone() 返 回 的 对 象 来 表示 当 
前 点 的 名 称 。System.Guid 类 型 事实 上 是 一 个 结构 ， 数 值 数据 被 真正 复制 过 来 了 。 下 面 是 一 种 可 行 
实现 : 


// 现在 需要 调整 PointDescription 成 员 
public object Clone() 
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// 首先 获取 浅 复制 
Point newPoint = (Point)this.MemberwiseClone(); 


// 然后 填充 间距 

PointDescription currentDesc = new PointDescription(); 
currentDesc.PetName = this.desc.PetName; 

newPoint.desc = currentDesc; 

return newPoint; 


} 
如 果 再 运行 一 次 这 个 程序 并 查看 输出 结果 ( 如 下 所 示 ), 你 将 会 看 到 返回 自 Clone() 的 Point 确 实 复 
制 了 它 的 内 部 引用 类 型 成 员 变 量 〈 注意 现在 p3 和 p4 的 昵称 都 是 不 同 的 )。 





***** Fun with Object Cloning ***** 


Cloned p3 and stored new Point in p4 
Before modification: 

p3: X = 100; Y = 100; Name = Jane; 

ID = 51f64f25-4b0e-47ac-ba35-37d263496406 


p4: X = 100; Y = 100; Name = Jane; 
ID = 0d3776b3-b159-490d-b022-7f3f60788e8a 





Changed p4.desc.petName and p4.X 

After modification: 

p3: X = 100; Y = 100; Name = Jane; 

ID = 51f64f25-4b0e-47ac-ba35-37d263496406 


p4: X = 9; Y = 100; Name = My new Point; 
ID = 0d3776b3-b159-490d-b022-7f3f60788e8a 





概括 一 下 克隆 过 程 。 如 果 有 一 个 仅 包含 值 类 型 的 类 或 结构 ， 使 用 MemberwiseClone() 实 现 Clone() 
方法 。 如 果 有 一 个 保存 其 他 引用 类 型 的 自 定 义 类 型 ， 需 要 建立 一 个 考虑 了 每 个 引用 类 型 成 员 变 量 的 新 
对 象 。 





源 代 码 CloneablePoint 项 目的 源 代码 位 于 Chapter 8 子 目录 下 。 
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System.IComparable 接 口 指定 了 一 种 允许 一 个 对 象 可 基于 某 些 特定 键 值 进行 排序 的 行为 。 下 面 是 
正式 定义 : 


// 这 个 接口 允许 一 个 对 象 指定 它 与 类 似 对 象 的 关系 
public interface IComparable 


int CompareTo(object o); 


说 明 ”该 接口 的 泛 型 版 本 (IComparable<T> ) 提供 了 类 型 更 加 安全 的 方式 处 理 对 象 间 的 比较 。 你 将 在 
第 9 章 中 学 习 泛 型 的 知识 。 


假定 构建 了 一 个 名 为 ComparableCar 的 新 控制 台 应 用 程序 项 目 ， 它 修改 的 Car 类 型 如 下 所 示 ( 这 里 
只 是 添加 了 一 个 新 成 员 变 量 来 表示 每 个 Car 的 不 同 ID ， 以 及 获取 和 设置 这 个 值 的 方法 ): 


public class Car 


public int CarID {get; set;} 
public Car(string name, int currSp, int id) 


CurrentSpeed = currSp; 
PetName = name; 
CarID = id; 
} 
} 
假设 你 有 一 个 如 下 所 示 的 Car 对 象 的 数组 : 
static void Main(string[] args) 
Console.WritelLine("***** Fun with Object Sorting *****\n"); 


// 建立 一 个 Car 对 象 的 数组 

Car[] myAutos = new Car[5]; 

myAutos[0] = new Car("Rusty", 80, 1); 
myAutos[1] = new Car("Mary", 40, 234); 
myAutos[2] = new Car("Viper"”, 40, 34); 
myAutos[3] = new Car("Mel", 40, 4); 
myAutos[4] = new Car("Chucky", 40, 5); 


Console.ReadLine(); 


System.Array 类 定义 了 一 个 名 为 sort() 的 静态 方法 。 在 内 置 类 型 ( int、short、 string 等 ) 上 调用 
这 个 方法 的 时 候 ， 可 以 以 数字 /字母 顺序 对 数组 中 的 项 排序 ， 因 为 这 些 内 置 数据 类 型 实现 了 
IComparable。 但 我 们 按 如 下 代码 向 Car 对 象 数组 发 送 一 个 Sort() 方 法 ， 又 会 怎样 呢 ? 


// 给 我 的 汽车 排序 吗 
Array. Sort (myAutos); 


运行 这 个 测试 ， 将 发 现 一 个 运行 时 异常 ， 因 为 car 类 并 不 支持 这 个 接口 。 构 建 自 定义 类 型 的 时 候 ， 
可 以 实现 IComparable 以 使 该 类 型 数组 可 被 排序 。 充 实 compareTo() 的 细节 时 ， 需 要 决定 排序 操作 的 基 
准 。 对 于 Car 类 型 来 说 ， 内 部 的 CarID 看 上 去 是 最 合 罗 辑 的 选择 : 


// Car 类 的 选 代 可 以 基于 CarID 进 行 排序 
public class Car : IComparable 


1/ IComparable 的 实现 
int IComparable.CompareTo(object obj) 


Car temp = obj as Car; 
if (temp != null) 
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if (this.CarID > temp.CarID) 
return 1; 

if (this.CarID < temp.CarID) 
return -1; 

else 
return 0; 


else 
throw new ArgumentException("Parameter is not a Car!"); 
} 


} 
可 以 看 到 ，CompareTo() 方 法 背后 的 逻辑 是 ， 根 据 某 个 特定 数据 字段 比较 传人 的 对 象 与 当前 实例 。 
CompareTo() 方 法 的 返回 值 被 用 来 判断 这 个 类 型 小 于 、 大 于 或 是 等 于 它 所 比较 的 对 象 ( 如 表 8-1 所 示 )。 


表 8-1 ”CompareTo() 方 法 的 返回 值 





CompareTo() 方 法 的 返回 值 作 用 
任何 小 于 0 的 数字 这 个 实例 在 指定 对 象 之 前 
0 这 个 实例 等 于 指定 对 象 
任何 大 于 0 的 数字 这 个 实例 在 指定 对 象 之 后 


由 于 C# int 数 据 类 型 ( 只 是 CLR System.Int32 的 简写 形式 ) 实现 了 IComparable， 我 们 就 可 以 按 如 le 
下 所 示 的 方法 实现 Car 的 CompareTo() 方 法 : 


int IComparable.CompareTo(object obj) 


Car temp = obj as Car; 
if (temp != null) 
return this.CarID.CompareTo(temp.CarID); 
else 
throw new ArgumentException("Parameter is not a Car!"); 


既然 Car 类 型 已 知道 如 何 将 它 自己 和 类 似 对 象 进行 对 比 ， 你 可 以 写 如 下 所 示 的 用 户 代 码 : 


// 执行 Comparable 接 口 
static void Main(string[] args) 


// 建立 一 个 Car 对 象 数组 


// 显示 当前 数组 
Console.WriteLine("Here is the unordered set of cars:"); 
foreach(Car c in myAutos) 

Console.Writeline("{0} {1}", c.CarID, c.PetName); 


// 现在 ,使 用 IComparable 为 它们 排序 
Array.Sort(myAutos); 
Console.WritelLine(); 


// 显示 排序 后 的 数组 
Console.WritelLine("Here is the ordered set of cars:"); 
foreach(Car c in myAutos) 

Console.WriteLine("{0} {1}", c.CarID, c.PetName); 
Console.ReadLine(); 


252 第 8 章 接口 


下 面 显示 了 前 面 Main() 方 法 的 运行 结果 : 





***** Fun with Object Sorting ***** 


Here is the unordered set of cars: 
1 Rusty 

234 Mary 

34 Viper 

4 Mel 

5 Chucky 


Here is the ordered set of cars: 
1 Rusty 

4 Mel 

5 Chucky 

34 Viper 

234 Mary 





8.13.1 指定 多 个 排序 顺序 


在 上 面 这 个 版 本 的 Car 类 型 中 ， 我 们 使 用 了 ID 号 作为 排序 的 基准 。 另 一 个 设计 也 许 会 用 昵称 作为 
排序 算法 的 基准 。 那 如 果 要 构建 一 个 既 可 通过 ID 排序 又 可 通过 昵称 排序 的 Car 类 型 ， 该 怎么 办 呢 ? 如 
果 读 者 对 这 种 行为 感 兴趣 ， 就 需要 与 另 一 个 标准 接口 IComparer 打 交道 。 它 按 如 下 代码 所 示 定 义 在 
System.Collections 命 名 空间 里 : 

// 比较 两 个 对 象 的 通用 方法 

interface IComparer 


int Compare(object o01, object 02); 


说 明 该 接 口 的 泛 型 版 本 (IComparer<T> ) 提供 了 类 型 更 加 安全 的 方式 来 处 理 对 象 间 的 比较 。 你 将 在 
第 9 章 学 习 泛 型 的 知识 。 


与 TComparable 接 口 不 同 ，IComparer 接 口 不 是 在 要 排序 的 类 型 ( 即 car ) 中 ， 而 是 在 许多 辅助 类 中 
实现 的 ， 其 中 每 个 排序 各 有 一 个 依据 ( 如 昵称 、ID 号 等 )。 现 在 ，Car 类 型 已 经 知道 如 何 基 于 内 部 ID 号 
进行 对 比 ， 所 以 允许 对 象 用 户 通过 昵称 排序 car 对 象 数 组 ， 需 要 男 一 个 实现 IComparer 接 口 的 辅助 类 。 
代码 如 下 (确保 在 代码 文件 中 导入 System.Collections 命 名 空间 ): 

// 这 个 辅助 类 用 来 通过 昵称 排序 Car 类 型 的 数组 

public class PetNameComparer : IComparer 


{ 
// 测试 每 个 对 象 的 昵称 
int IComparer.Compare(object o1，object o2) 


Car t1 = 01 as Car; 
Car t2 = 02 as Car; 
if(t1 != null && t2 != null) 





return String.Compare(t1.PetName, t2.PetName); 
else 
throw new ArgumentException("Parameter is not a Car!"); 
} 


} 
这 个 对 象 用 户 代 码 可 以 使 用 辅助 类 。System.Array 有 许多 重 载 的 Sort() 方 法 ， 其 中 有 一 个 用 来 在 
对 象 上 实现 IComparer 接 口 。 


static void Main(string[] args) 


“7/ 按照 昵称 进行 排序 


Array.Sort(myAutos, new PetNameComparer()); 


// 转 储 排序 后 的 数组 
Console.WriteLine("Ordering by pet name:"); 
foreach(Car c in myAutos) 

Console.WriteLine("{0} {1}", c.CarID, c.PetName); 


8.13.2 自 定义 属性 、 自 定义 排序 类 型 

值得 指出 的 是 ， 在 通过 特定 数据 字段 排序 Car 类 型 的 时 候 ， 可 以 使 用 自 定 义 的 静态 属性 辅助 对 象 
用 户 。 假 定 car 类 添加 了 一 个 静态 只 读 属性 SortByPetName， 它 返回 一 个 实现 了 IComparer 接 口 的 对 象 的 
实例 ( 本 例 中 为 PetNameComparer ): 


// 现在 可 以 使 用 一 个 自 定义 静态 属性 来 返回 正确 的 IComparer 接 口 
public class Car : IComparable 


// 返回 SortByPetName 比 较 的 属性 
public static IComparer SortByPetName 
{ get { return (IComparer)new PetNameComparer(); } } 


对 象 用 户 代 码 现在 可 以 使 用 强 关联 属性 按照 昵称 排序 ， 而 不 是 只 能 使 用 独立 的 PetNameComparer 
类 型 : 


// 简洁 明了 地 按照 昵称 排序 
Array.Sort(myAutos, Car.SortByPetName); 


源 代码 ”ComparableCar 项 目的 源 代 码 位 于 Chapter 8 子 目 录 下 。 


很 高 兴 现 在 大 家 不 仅 了 解 了 如 何 定义 和 实现 接口 类 型 ， 而 且 知 道 了 接口 的 用 处 是 多 么 大 。 是 的 ， 
接口 出 现在 每 个 主要 的 .NET 命 名 空间 里 ， 你 将 在 本 书 其 他 章节 中 继续 使 用 各 种 标准 接口 。 


8.14 ”小结 
接口 可 以 被 定义 为 抽象 成 员 的 集合 。 因 为 接口 不 提供 任何 实现 细节 ， 通 常 把 接口 看 做 某 个 类 型 支 
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持 的 行为 。 如 果 两 个 或 更 多 类 实现 相同 的 接口 ,我们 就 可 以 以 相同 方式 对 待 两 个 类 型 ( 又 叫 基 于 接口 
的 多 态 )， 即 使 类 型 定义 在 独立 的 类 继承 体系 中 。 

C# 提 供 了 interface 关 键 字 来 允许 我 们 定义 新 的 接口 。 我 们 已 经 看 到 ， 类 型 可 以 使 用 逗号 分 隔 列 
表 支 持 任意 多 个 接口 。 此 外 ， 也 可 以 构建 从 多 个 基 接 口 派生 的 接口 。 

除了 构建 自 定义 接口 之 外 ，.NET 类 库 还 定义 了 许多 标准 ( 即 框 架 支 持 的 ) 接口 。 可 以 看 到 ,我 们 
完全 可 以 构建 自 定义 类 型 来 实现 这 些 预定 义 的 接口 以 获得 许多 有 用 特性 ， 如 克隆 、 排 序 以 及 枚 举 。 
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第 9 章 
集合 与 泛 型 











1 用 .NET 平 台 创建 的 任何 应 用 程序 ， 都 需要 解决 在 内 存 中 维护 和 操作 一 组 数据 点 的 问题 。 这 
些 数据 点 可 以 来 自任 何 地 方 ， 包 括 关系 型 数据 库 、 本 地 文本 文件 、XML 文 件 、Web 服 务 调 

用 ， 也 可 能 是 用 户 提供 的 输入 。 

自从 .NET 平 台 第 一 次 发 布 之 后 ， 程 序 员 经 常 使 用 System.Collections 命 名 空间 来 以 更 灵活 的 方式 
管理 数据 。 然 而 ， 自 从 .NET 2.0 发 布 之 后 ，C# 编 程 语 言 就 增强 了 ， 开 始 支持 泛 型 。 基 于 此 ， 在 基础 类 
库 中 引入 了 一 个 以 集合 为 中 心 的 新 命名 空间 : System.Collections.Generic 命 名 空间 。 

本 章 将 介绍 不 同 集合 ( 泛 型 和 非 泛 型 ) 命名 空间 的 概况 和 .NET 基 础 类 库 中 的 类 型 。 你 会 看 到 , 泛 
型 容器 与 它们 的 非 泛 型 版 本 相 比 ,在 很 多 方面 要 优越 得 多 ， 因 为 它们 提供 了 更 好 的 类 型 安全 和 性 能 优 
势 。 在 我 们 看 到 如 何 创建 和 操纵 框架 中 的 泛 型 项 之 后 , 本 章 余下 部 分 会 研究 如 何 构 建 自己 的 泛 型 类 型 。 
此 时 ， 你 将 学 习 约 束 的 作用 和 C# where 关 键 字 ， 它 允许 构建 类 型 安全 的 容器 。 


9.1 集合 类 的 动机 


毫 无 疑问 ， 我 们 用 来 保存 应 用 程序 中 数据 的 最 简单 的 容器 就 是 数组 。 在 第 4 章 我 们 看 到 ，C# 数 组 
可 以 定义 一 组 具有 固定 上 限 的 相同 类 型 的 项 ( 包括 System.0bject 类 型 的 数组 , 它 实际 上 表示 任何 数据 
类 型 的 一 个 数组 )。 同 时 ， 第 4 章 还 介绍 了 所 有 C# 数 组 变量 都 从 System.Array 类 获得 了 大 量 功能 。 我 们 
来 快速 回顾 一 下 这 些 知识 ， 看 看 下 面 的 Main() 方 法 ， 它 创建 了 一 个 文本 数据 的 数组 ， 并 通过 各 种 方式 
操纵 其 内 容 。 


static void Main(string[] args) 


// 创 建 一 个 字符 串 数据 的 数组 
string[] strArray = {"First", "Second", "Third" }; 


// Show number of items in array using Length property. 
Console.WriteLine("This array has {0} items.", strArray.Length); 
Console.WritelLine(); 


// 使 用 枚 举 器 显示 内 容 
foreach (string s in strArray) 


Console.WritelLine("Array Entry: {0}", s); 
Console.WritelLine(); 


// 颠倒 数组 并 打印 
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Array.Reverse(strArray); 
foreach (string s in strArray) 


Console.WritelLine("Array Entry: {0}", s); 


Console.ReadLine(); 


尽管 基本 数组 可 以 用 来 管理 少量 固定 大 小 的 数据 ， 但 很 多 时 候 你 都 会 需要 一 种 更 灵活 的 数据 结 
构 ， 如 容器 可 以 动态 伸缩 ， 或 只 保存 满足 某 个 标准 的 对 象 (如 只 保存 派生 自 某 个 特定 基 类 或 实现 了 某 
个 接口 的 对 象 )。 在 使 用 简单 数组 时 ， 始 终 要 记得 它们 是 “固定 大 小 的 "。 如 果 创 建 了 一 个 包含 三 个 项 
的 数组 ， 就 只 能 得 到 三 个 项 ， 因 此 下 面 的 代码 将 产生 一 个 运行 时 异常 ( Index0ut0fRangeException ): 

static void Main(string[] args) 


// 创 建 一 个 字符 事 数 据 的 数组 
string[] strArray = { "First", "Second", "Third" }; 


// 想 在 最 后 添加 新 项 ? 将 得 到 运行 时 错误 
strArray[3] = "new item?"; 
人 
为 了 摆脱 简单 数组 的 这 些 限制 ，.NET 基 础 类 库 发 布 了 很 多 包含 集合 类 的 命名 空间 。 与 简单 的 C# 
数组 不 同 ， 集 合 类 本 身 的 尺寸 是 动态 的 ， 你 可 以 在 运行 时 插 和 人 或 移 除 项 。 此 外 ， 很 多 集合 类 还 提供 了 
更 强 的 类 型 安全 ， 并 且 进 行 了 高 度 优化 ， 可 以 以 内 存 高 效 的 方式 处 理 所 包 含 的 数据 。 在 读 完 本 章 后 你 
会 发 现 ， 集 合 类 可 划分 为 两 大 种 类 : 
口 非 泛 型 集合 〈 主要 位 于 System.Collections 命 名 空间 ) 
口 泛 型 集合 ( 主要 位 于 System.Collections.Generic 命 名 空间 ) 
非 泛 型 集合 通常 设计 为 操作 System.0bject 类 型 ,因此 是 非常 松散 类 型 的 容器 ( 尽管 如 此 ， 有 些 非 
泛 型 集合 还 是 专门 用 来 操作 特定 类 型 的 数据 ， 如 string 对 象 )。 相反 , 泛 型 集合 更 加 类 型 安全 ， 因 为 必 
须 在 创建 时 指定 “类 型 的 类 型 "。 你 将 会 看 到 ， 任 何 泛 型 项 中 的 标记 叫做 “类 型 参数 "， 用 尖 括 号 括 起 
( 如 List<T> )。 本章 稍 后 会 介绍 泛 型 的 细节 ( 以 及 很 多 优点 )。 现在 , 我 们 先 来 学 习 System.Collections 
和 System.Collections.Specialized 命 名 空间 中 的 一 些 主要 的 非 泛 型 集合 类 型 。 


9.1.1 System.Collections 命 名 空间 


在 .NET 平 台 最 初 发 布 时 ， 程 序 员 常常 使 用 System.Collections 命 名 空间 中 的 非 泛 型 集合 类 。 该 命 
名 空间 提供 了 很 多 类 来 管理 和 组 织 大 量 的 数据 。 表 9-1 列 出 了 一 些 常 用 的 集合 类 , 以 及 它们 所 实现 的 核 
心 接 口 o 








说 明 任何 使 用 NET 2.0 或 更 高 版 本 创建 的 项 目 都 应 该 放弃 使 用 System.Collections 中 的 类 ， 而 使 用 
System.Collections.Generic 中 的 类 。 不 过 ， 有 必要 了 解 一 些 非 泛 型 集合 类 的 基础 知识 ， 因 为 
你 可 能 要 使 用 它 维护 一 些 遗 留 软件 。 
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表 9-1 System.Collections 中 的 常用 类 


System.Collections 类 作 用 实现 的 关键 接口 
ArrayList 表示 动态 大 小 的 对 象 集合 ， 其 中 的 ”IList、ICollection、IEnumerable 和 ICloneable 
对 象 是 按 顺序 列 出 的 
BitArray 管理 位 值 的 简单 数组 ， 位 值 用 布尔 ”ICollection、IEnumerable 和 ICloneable 


值 表示 ，true 表 示 该 位 打开 (1 )， 
false 表 示 该 位 关闭 (0 ) 


Hashtable 表示 键 值 对 的 集合 ， 按 键 的 散 列 值 IDictionary、 ICollection、 IEnumerable 和 ICloneable 
进行 组 织 

Queue 表示 标准 的 先进 先 出 ( FIFO ) 队列 ICollection、ICloneable 和 IEnumerable 

SortedList 表示 键 值 对 的 集合 ， 按 键 排序 , 可 IDictionary、 ICollection、 IEnumerable 和 ICloneable 
通过 键 和 索引 进行 访问 

Stack 后 进 先 出 (LIFO ) 的 栈 ， 提 供 压 人 ICollection、ICloneable 和 IEnumerable 
和 弹出 功能 


由 这 些 基 本 集合 类 实现 的 接口 可 以 洞悉 整个 功能 。 表 9-2 列 出 了 这 些 关 键 接口 的 性 质 , 其 中 一 些 已 
经 在 第 8 章 中 接触 过 。 


表 9-2 System.Collections 中 的 类 所 支持 的 关键 接口 





System.Collections 接 口 作 用 
ICollection 为 所 有 非 泛 型 集合 类 型 定义 基本 特性 ( 如 大 小 、 枚 举 、 线 程 安全 ) 
ICloneable 允许 实现 它 的 对 象 向 调用 者 返回 它 的 副本 
IDictionary 允许 非 泛 型 集合 对 象 使 用 名 称 / 值 对 来 表示 其 内 容 
IEnumerable 返回 实现 了 IEnumerator 接 口 ( 见 下 一 行 ) 的 对 象 
IEnumerator 人 允许 子 类 型 以 foreach 形 式 迭 代 
IList 为 顺序 列表 中 的 对 象 提供 添加 、 移 除 和 索引 项 的 行为 





示例 演示 : 使 用 ArrayList 

你 可 能 以 前 使 用 过 (或 实现 过 ) 一 些 传统 的 数据 结构 ， 如 栈 、 队 列 和 列表 。 如 果 不 是 这 样 ， 我 将 
在 本 章 后 面 介 绍 泛 型 版 本 时 再 深入 探讨 它们 的 区 别 。 在 那 之 前 ， 我 们 先 来 看 看 这 个 使 用 了 ArrayList 
对 象 的 Main() 方 法 。 注 意 ， 我 们 可 以 在 运行 时 添加 (或 移 除 ) 项 ， 容 器 将 相应 地 自动 改变 大 小 : 

// 要 访问 ArrayList， 必 须 引 入 System.Collections 

static void Main(string[] args) 


ArTayList strArray = new ArrayList(); 
strArray.AddRange(new string[] { "First", "Second", "Third" }); 


// 显 示 ArrayList 中 项 个 数目 
Console.WriteLine("This collection has {0} items.", strArray.Count); 
Console.Writeline(); 
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// 添 加 新 项 ， 并 展示 当前 数目 
strArray.Add("Fourth!"); 
Console.WriteLine("This collection has {0} items.", strArray.Count); 


// 显 示 内 容 
foreach (string s in strArray) 


Console.WritelLine("Entry: {0}", s); 


Console.WriteLine(); 


正如 你 所 猜测 的 那样 ，ArrayList 类 除了 Count 属 性 和 AddRange()、Add() 方 法 外 ， 还 包含 很 多 有 用 
的 成 员 ,， 详细 内 容 请 参考 .NET Framework 文 档 。 此 外 ，System.Collections 下 的 其 他 类 ( Stack、Queue 
等 ) 在 .NET 帮助 系统 中 也 包含 完整 的 文档 。 

但 必须 指出 的 是 ， 大 多 数 .NET 项 目 都 不 会 使 用 System.Collections 命 名 空间 中 的 集合 类 ! 的 确 ， 
这 些 年 更 常见 的 是 使 用 System.Collections.Generic 命 名 空间 中 的 泛 型 类 。 鉴于 此 , 我 就 不 再 莹 述 (或 
列举 ) System.Collections 中 的 其 他 非 泛 型 类 了 。 


9.1.2 System.Collections.Specialized 命 名 空间 


System.Collections 不 是 唯一 包含 非 泛 集 合 类 的 .NET 命 名 空间 。 比 如 System.Collections . 
Specialized 命 名 空间 就 定义 了 一 些 专 有 的 集合 类 型 。 表 9-3 列 出 了 这 个 特殊 的 以 集合 为 核心 的 命名 空 
间 中 一 些 十 分 有 用 的 类 型 ， 它 们 都 是 非 泛 型 的 。 


表 9-3 System.Collections.Specialized 中 有 用 的 类 





System.Collections.Specialized 中 的 类 型 作 用 
HybridDictionary 该 类 实现 了 IDictionary, 在 集合 较 小 时 使 用 ListDictionary, 在 集合 变 
大 后 改 用 Hashtable 
ListDictionary 在 管理 少量 ( 10 个 左右 ) 可 随时 改变 的 项 时 非常 有 用 。 它 使 用 单 链表 
来 维护 数据 
StringCollection 该 类 提供 了 管理 大 型 字符 串 集 合 的 另 一 种 方式 
BitVector32 该 类 提供 了 一 种 简单 的 结构 ， 用 32 位 内 存 存储 布尔 值 和 小 整数 


除了 这 些 核心 类 型 , System.Collections.Specialized 命 名 空间 还 包含 了 很 多 额外 的 接口 和 抽象 基 
类 ， 可 以 用 来 作为 创建 自 定义 集合 类 的 起 始点 。 这 些 “ 特 定 ” 的 类 型 可 能 在 某 些 情况 下 恰好 是 你 的 项 
目 所 需要 的 ， 这 里 就 不 逐一 点 评 它们 的 用 法 了 。 此 外 , 在 许多 情况 下 ,你 可 能 会 发 现 System.Collections. 
Generic 命 名 空间 提供 的 类 与 上 面 这 些 功能 相似 ， 但 还 有 其 他 一 些 好 处 。 


说 明 .NET 基 类 库 中 还 包含 两 个 以 集合 为 核心 的 命名 空间 ( System.Collections.0bjectModel 和 System. 
Collections.Consurrent ) 。 我 们 将 在 本 章 学 习 完 泛 型 后 介绍 前 一 个 命名 空间 。 System.Collections. 
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9.2” 非 泛 型 集合 的 问题 


尽管 很 多 成 功 的 .NET 应 用 程序 在 多 年 前 都 使 用 这 些 “ 经 典 ” 的 集合 类 ( 和 接口 ) 构建 , 但 历史 证 
明 使 用 这 些 类 型 会 导致 相当 多 的 问题 。 

第 一 个 问题 是 ， 使 用 System.Collections 和 System.Collections.Specialized 下 的 类 会 导致 低 性 能 
的 代码 ， 特 别 是 在 操作 数值 数据 时 ( 如 值 类 型 )。 稍 后 你 将 看 到 ， 当 你 在 一 个 操作 System.0bject 的 非 
泛 型 集合 类 中 存储 结构 时 ，CLR 必 须 执行 大 量 的 内 存 转换 操作 ， 这 会 降低 运行 时 的 执行 速度 。 

第 二 个 问题 是 , 这 些 经 典 的 集合 类 不 是 类 型 安全 的 ,因为 它们 是 为 了 操作 System.0bject 类 而 开发 
的 , 因此 可 以 包含 任何 类 型 。 如 果 .NET 开 发 者 需要 创建 高 度 类 型 安全 的 集合 ( 如 某 容器 只 能 容纳 实现 
了 某 个 接口 的 对 象 )， 唯 一 的 选择 是 手工 创建 一 个 全 新 的 集合 类 。 这 么 做 的 工作 量 并 不 大 ， 但 却 多 少 
有 点 繁琐 。 

在 学 习 如 何在 程序 中 使 用 泛 型 之 前 ,研究 一 下 非 泛 型 集合 类 的 问题 会 非常 有 用 。 这 将 有 助 于 你 更 
好 地 理解 泛 型 要 解决 的 首要 问题 ,创建 一 个 名 为 IssuesWithNongenericCollections 的 Console Application ， 
然后 在 C# 代 码 文 件 的 项 端 引 入 System.Collections 命 名 空间 : 


using System.Collections; 


9.2.1 性 能 问题 


第 4 章 介 绍 过 , .NET 平 台 支持 两 大 类 数据 类 型 : 值 类 型 和 引用 类 型 。 由 于 .NET 定 义 了 这 两 大 类 型 ， 
我 们 有 时 需要 用 一 个 类 别 的 变量 来 表示 另 一 个 类 别 的 变量 。 为 此 ，C# 提 供 了 称 为 装 箱 的 简单 机 制 来 实 
现 ， 它 可 以 把 值 类 型 数据 保存 在 引用 类 型 变量 中 。 假 设 我 们 在 SimpleBoxUnbox0peration() 方 法 中 创建 
了 一 个 int 类 型 的 本 地 变量 。 在 应 用 程序 的 过 程 中 ， 如 果 要 将 值 类 型 表示 为 引用 类 型 ， 需 要 对 值 进行 
装 箱 ， 如 下 所 示 : 


static void SimpleBoxUnboxOperation() 


// 创 建 一 个 ValueType(int) 变 量 
int myInt = 25; 


// 将 int 装 箱 为 object 引 用 
object boxedInt = myInt; 


装 箱 可 以 正式 定义 为 : 显 式 地 将 值 类 型 分 配给 System.0bject 变 量 的 过 程 。 当 我 们 对 一 个 值 进行 装 
箱 时 ，CLR 就 会 在 堆 上 分 配 新 的 对 象 并 且 将 值 类 型 的 值 ( 这 里 是 25 ) 复制 到 那个 实例 上 。 因 此 ， 返 回 
给 我 们 的 就 是 新 分 配 在 堆 上 的 对 象 的 引用 。 

相反 的 操作 可 以 通过 拆 箱 来 实现 。 拆 箱 就 是 把 保存 在 对 象 引 用 中 的 值 转换 回 栈 上 的 相应 值 类 型 。 
从 语法 上 来 说 ， 拆 箱 操 作 更 像 是 转换 操作 。 但 它们 在 语义 上 却 过 然 不 同 。CLR 会 验证 收 到 的 值 类 型 是 
不 是 等 价 于 装 箱 的 类 型 ， 如 果 是 ， 就 将 值 复 制 回 本 地 栈 变 量 上 。 例 如 ， 如 下 拆 箱 操作 会 成 功 ， 因 为 
boxedInt 的 实际 类 型 确实 是 int: 


static void SimpleBoxUnboxOperation() 
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// 创 建 一 个 ValueType(int) 变 量 
int myInt = 25; 


// 将 int 装 箱 为 object 引 用 
object boxedInt = myInt; 


// 将 引用 拆 箱 为 相应 的 int 
int unboxedInt = (int)boxedInt; 


当 C# 编 译 器 发 现 装 箱 / 拆 箱 语法 时 ， 所 生成 的 CIL 代 码 包 含 box/unbox 操 作 码 。 用 ildasm.exe 查 看 编 
译 后 的 程序 集 ， 结 果 如 下 : 


.method private hidebysig static void SimpleBoxUnboxOperation() cil managed 


// 代码 大 小 19 (0x13) 
.maxstack 1 
.locals init ([0] int32 myInt, [1] object boxedInt, [2] int32 unboxedInt) 
IL 0000: nop 
IL 0001: ldc.i4.s 25 
IL 0003: stloc.0 
IL 0004: ldloc.0 
IL 0005: box [mscorlib]System.Int32 
IL 000a: stloc.1 
IL_000b: ldloc.1 
IL O00c: unbox.any [mscorlib]System.Int32 
IL 0011: stloc.2 
IL 0012: ret 
}// Program: :SimpleBoxUnboxOperation 方 法 结束 


记 住 ， 与 执行 通常 的 转换 不 同 ， 拆 箱 必 须 回 到 合适 的 数据 类 型 。 如 果 尝 试 将 数据 拆 箱 为 不 正确 
的 变量 ， 将 抛 出 InvalidCastException 异 常 。 为 了 确保 安全 ， 你 需要 将 每 个 拆 箱 操作 都 包 庄 在 
try/Vcatch 逻 辑 中 。 但 这 样 的 工作 量 又 太 大 了 。 由 于 尝试 将 装 箱 后 的 int 拆 箱 为 ong， 下 面 的 代码 将 
抛 出 一 个 错误 : 


static void SimpleBoxUnboxOperation() 





// 创建 一 个 ValueType(int) 变 量 
int myInt = 25; 


// 将 int 装 藉 为 object 引 用 
object boxedInt = myInt; 


// 拆 箱 为 错误 的 数据 类 型 将 触发 运行 时 异常 
try 


long unboxedInt = (long)boxedInt; 
catch (InvalidCastException ex) 
} Console.WriteLine(ex.Message); 
} 
乍 看 上 去 ， 装 箱 和 拆 箱 看 似 是 一 个 普通 的 语言 特性 ， 其 学 术 意义 大 于 实际 意义 。 毕 竟 ， 你 不 会 像 
示例 中 那样 将 本 地 值 类 型 保存 为 本 地 object 变 量 。 但 其 实 装 ( 拆 ) 箱 过 程 很 用， 因为 我 们 可 以 将 所 
有 东西 都 当成 System.0bject， 而 CLR 会 自己 负责 内 存 相关 的 细节 。 
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为 了 看 看 这 项 技术 的 实际 用 途 , 假设 我 们 创建 了 非 泛 型 的 System.Collections.ArrayList 来 保存 数 
值 (分 配 在 栈 上 的 ) 数据 。 如 果 研 究 ArrayList 成 员 ， 就 会 发 现 它 们 所 操作 的 是 System.0bject 数 据 。 
来 看 看 Add() 、Insert() 、Remove() 方 法 以 及 类 索引 器 : 


public class ArrayList : object， 
IList, ICollection, IEnumerable, ICloneable 


”public Virtual int Add(object value); 
public virtual void Insert(int index, object value); 
public virtual void Remove(object obj); 
public virtual object this[int index] {get; set; } 
} 
ArrayList 所 操作 的 是 object， 这 表示 数据 分 配 在 堆 上 ， 因 此 下 面 的 代码 可 能 看 上 去 有 些 奇 怪 ， 因 
为 它 不 但 可 以 通过 编译 ， 而 且 执 行 时 也 不 会 抛 出 错误 : 
static void WorkWithArrayList() 
// 在 传递 给 需要 0bject 的 方法 时 ， 值 类 型 会 自动 装 菠 
ArrayList myInts = new ArraylList(); 
myInts.Add(10); 


myInts.Add(20); 
myInts.Add(35); 


尽管 你 把 数字 数据 直接 传人 要 求 object 的 方法 ,但 运行 时 会 自动 将 栈 数据 进行 装 箱 。 然 后 ， 如 果 
希望 使 用 类 型 索引 器 从 ArrayList 中 获取 项 , 则 必须 使 用 转换 操作 , 将 堆 分 配 的 对 象 拆 箱 成 栈 分 配 的 整 
数 。 记 住 ，ArrayList 的 索引 器 返回 System.0bject， 不 是 System. Int32: 

static void WorkwithArrayList() 

// 在 传递 给 要 求 object 的 成 员 时 ， 值 类 型 将 自动 装 箱 
ArTayList myInts = new ArTayList(); 
myInts.Add(10); 


myInts.Add(20); 
myInts.Add(35); 


// 当 将 object 转 换 回 栈 数 据 时 ， 会 发 生 拆 箱 
int i = (int)myInts[0]; 


// 由 于 WriteLine() 要 求 object 类 型 ， 因 此 再 次 发 生 装 箱 操 作 
Console.WriteLine("Value of your int: {0}", i); 


再 次 注意 ， 在 调用 ArrayList.Add() 之 前 ， 栈 分 配 的 System.Int32 被 装 箱 ， 以 便 它 被 传递 给 所 需 的 
System.0bject 。 同 样 ， 通 过 类 型 索引 器 从 ArrayList 获 取 数 据 时 ，System.0bject 将 被 拆 箱 为 
System.Int32， 只 有 当 传 递 给 Console.WriteLine() 方 法 时 ， 才 会 被 再 次 装 箱 ， 这 是 因为 该 方法 操作 的 
也 是 System.0bject 变 量 。 

尽管 装 箱 和 拆 箱 对 程序 员 来 说 很 方便 , 但 是 这 种 方式 带 来 的 堆 / 栈 内 存 转移 会 导致 性 能 问题 ( 执行 
速度 和 代码 多 少 )， 并 且 也 缺乏 类 型 安全 。 为 了 理解 性 能 问题 ， 思 考 一 下 在 装 箱 和 拆 箱 一 个 整数 时 发 
生 的 步骤， 有 具体 如 下 所 示 。 

(1) 必须 在 托管 堆 上 分 配 一 个 新 对 象 。 
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(2) 基于 栈 数据 的 值 必须 被 转移 到 新 分 配 的 内 存 位 置 。 

(3) 在 拆 箱 时 ， 保 存在 堆 对 象 中 的 值 必须 转移 回 栈 。 

(4) 堆 上 无 用 的 对 象 (最 后 ) 会 被 回收 。 

尽管 这 个 WorkWithArrayList() 方 法 不 会 导致 明显 的 性 能 瓶颈 , 但 如 果 程 序 维 护 的 ArrayList 包 含 了 
几 千 个 整数 就 很 是 问题 了 。 理 想 情况 下 ， 我 们 应 该 可 以 在 没有 任何 性 能 问题 的 容器 中 操作 栈 数 据 ， 并 
且 在 获取 数据 时 也 不 必 使 用 try/catch 作 用 域 ( 这 正 是 泛 型 所 实现 的 )。 


9.2.2 ”类 型 安全 问题 


在 介绍 拆 箱 操作 时 ,我 们 提 到 了 类 型 安全 问题 。 我 们 必须 将 数据 拆 箱 为 装 箱 之 前 声明 的 类 型 。 但 
是 ， 你 还 必须 记 住 非 泛 型 世界 中 的 另 一 个 类 型 安全 问题 : 由 于 System.Collections 中 的 大 多 数 类 所 操 
作 的 都 是 System.0bject， 因 此 它们 可 以 容纳 任何 类 型 。 例 如 ， 下 面 方法 中 的 ArrayList 包 含 一 些 不 相 
关 的 数据 : 

static void ArrayListOfRandomObjects() 

// ArrayList 可 以 保存 任何 类 型 

ArrayList allMyObjects = new ArraylList(); 

allMyObjects.Add(true); 

allMyObjects.Add(new OperatingSystem(PlatformID.MacOSX, new Version(10, 0))); 


allMyObjects .Add(66); 
allMyObjects.Add(3.14); 





某 些 情况 下 ， 你 可 能 需要 极其 灵活 的 容器 来 容纳 任何 东西 (如 本 例 )。 但 大 多 数 情况 下 ， 你 还 是 
需要 一 个 类 型 安全 的 容器 来 操作 特定 的 数据 类 型 。 例 如 ， 你 可 能 需要 只 能 容纳 数据 库 连 接 、 位 图 或 
IPointy 兼 容 对 象 的 容器 。 

在 泛 型 之 前 ， 要 解决 类 型 安全 问题 的 唯一 方法 是 手工 创建 自 定义 ( 强 类 型 的 ) 集合 类 。 假 设 你 要 
创建 一 个 只 包含 Person 类 型 对 象 的 自 定义 集合 : 

public class Person 

public int Age {get; set;} 


public string FirstName {get; set;} 
public string LastName {get; set;} 


public Person(){} 
public Person(string firstName, string lastName, int age) 


Age = age; 
FirstName = firstName; 
LastName = lastName; 


public override string ToString() 


return string.Format("Name: {0} {1}, Age: {2}", 
FirstName, LastName, Age); 


} 
要 构建 只 容纳 Person 对 象 的 集合 ,我 们 可 以 在 PersonCollection 类 中 定义 一 个 System.Collections. 
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ArrayList 成 员 变量 , 并 且 配 置 所 有 成 员 操作 强 类 型 的 Person 对 象 而 不 是 System.0bject 类 型 。 下 面 是 一 
个 简单 的 示例 〈 一 个 产品 级 的 自 定义 集合 可 支持 更 多 额外 的 成 员 ， 并 可 扩展 System.Collections 或 者 
System.Collections.Specialized 命 名 空间 中 的 某 个 抽象 基 类 ): 


public class PersonCollection : IEnumerable 
private ArrayList arPeople = new ArrayList(); 


// 为 调用 者 进行 转换 
public Person GetPerson(int pos) 
{ return (Person)arPeople[pos]; } 


// 只 插入 Person 对 象 
public void AddPerson(Person p) 
{ arPeople.Add(p); } 


public void ClearPeople() 
{ arPeople.Clear(); } 


public int Count 
{ get { return arPeople.Count; } } 


// 支持 foreach 枚 举 
IEnumerator IEnumerable.GetEnumerator() 
{ return arPeople.GetEnumerator(); } 


} 

注意 ,为 了 允许 对 包含 的 项 进行 foreach 迭 代 ，PersonCollection 类 实现 了 IEnumerable 接 口 。 还 要 
注意 ，GetPerson() 和 AddPerson() 方 法 已 经 被 定义 为 只 操作 Person 对 象 (不 是 位 图 、 字 符 串 、 数 据 库 连 
接 等 )。 定 义 了 这 些 类 型 以 后 ， 就 不 用 担心 类 型 安全 了 ， 因 为 C# 编 译 器 会 检查 任何 尝试 插入 不 兼容 数 
据 类 型 的 请 求 。 


static void UsePersonCollection() 


Console.WritelLine("***** Custom Person Collection *****\n"); 
PersonCollection myPeople = new PersonCollection(); 
myPeople.AddPerson(new Person("Homer", "Simpson", 40)); 
myPeople.AddPerson(new Person("Marge", "Simpson", 38)); 
myPeople.AddPerson(new Person("Lisa", "Simpson", 9)); 
myPeople.AddPerson(new Person("Bart", "Simpson", 7)); 
myPeople.AddPerson(new Person("Maggie", "Simpson", 2)); 


// 这 会 产生 编译 时 错误 
// myPeople.AddPerson(new Car()); 


foreach (Person p in myPeople) 
Console.WritelLine(p); 


虽然 自 定义 的 集合 可 以 确保 类 型 安全 ,但 是 如 果 使 用 这 个 方法 ， 就 必须 为 每 一 个 希望 包含 的 类 型 
创建 一 个 ( 基本 一 样 ) 自 定义 集合 。 因 此 ， 如 果 我 们 需要 一 个 自 定义 集合 来 操作 从 Car 基 类 派生 的 任 
何 类 ， 就 需要 构建 非常 相似 的 集合 类 : 


public class CarCollection : IEnumerable 


private ArrayList arCars = new ArrayList(); 


// 为 调用 者 进行 转换 
public Car GetCar(int pos) 
{ return (Car) arCars[pos]; } 


// 只 插入 Car 对 象 
public void AddCar(Car c) 
{ arCars.Add(c); } 


public void ClearCars() 
{ arCars.Clear(); } 


public int Count 
{ get { return arCars.Count; } } 


// 支持 foreach 枚 举 
IEnumerator IEnumerable.GetEnumerator() 
{ return arCars.GetEnumerator(); } 


然而 ， 这 些 自 定 义 集合 类 并 没有 消除 装 箱 / 拆 箱 的 损失 。 即 使 我 们 创建 叫做 IntCollection 的 自 定 
义 集 合 ， 只 处 理 System.Int32 数 据 项 ， 我 们 还 是 要 分 配 某 个 类 型 的 对 象 来 保存 数据 〈 如 System.Array 


和 ArrayList 等 ): 


public class IntCollection : IEnumerable 
private ArTrayList arInts = new ArrayList(); 


// 为 调用 者 拆 箱 
public int GetInt(int pos) 
{ return (int)arInts[pos]; } 


// 装 箱 操 作 
public void AddInt(int i) 
{ arInts.Add(i); } 


public void ClearInts() 
{ arInts.Clear(); } 


public int Count 
{ get { return arInts.Count; } } 


IEnumerator IEnumerable.GetEnumerator() 
{ return arInts.GetEnumerator(); } 


不 管 选择 哪个 类 型 来 保存 整数 ， 我 们 都 不 能 避免 使 用 非 泛 型 容器 带 来 的 装 箱 问题 。 


9.2.3 初 识 泛 型 集合 


使 用 泛 型 集合 类 可 以 解决 上 面 所 有 的 问题 , 包括 装 箱 / 拆 箱 损 耗 和 类 型 安全 缺失 。 另 外 , 基本 上 不 
需要 手工 构建 自 定义 ( 泛 型 ) 集合 类 。 与 其 构建 包含 人 、 汽 车 和 整数 的 类 ， 不 如 使 用 泛 型 集合 类 并 指 


定 类 型 。 


考虑 如 下 的 方法 ， 它 使 用 泛 型 List<T> 类 ( 位 于 System.Collections.Generic 命 名 空间 ) 以 强 类 型 


的 方式 保存 不 同 的 类 型 ( 不 用 在 意 泛 型 语法 的 细节 ): 
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static void UseGenericlist() 
Console.WriteLine("***** Fun with Generics *****\n"); 


// 该 List<> 只 能 容纳 Person 对 象 

List<Person> morePeople = new List<Person>(); 
morePeople.Add(new Person ("Frank", "Black", 50)); 
Console.WritelLine(morePeople[0]); 


// 该 List<> 只 能 容纳 整数 

List<int> moreInts = new List<int>(); 
moreInts.Add(10); 

moreInts.Add(2); 

int sum = moreInts[0] + moreInts[1]; 


// 编译 时 错误 ! 不 能 将 Person 对 象 添加 到 整 型 列表 中 
// moreInts.Add(new Person()); 


} 

第 一 个 List<T> 对 象 只 能 包含 Person 对 象 。 因 此 ,在 从 容器 中 获取 项 时 不 必 进 行 转换 ,这 使 得 这 种 
方法 更 加 类 型 安全 。 第 二 个 ListxT> 只 能 包含 整 型 ， 所 有 的 整数 都 分 配 在 栈 上 。 也 就 是 说 ， 非 泛 型 的 
ArzrayList 中 没有 那 种 隐藏 的 装 箱 或 拆 箱 。 与 非 泛 型 容器 相 比 ， 泛 型 容器 的 一 些 优势 如 下 所 示 。 

口 泛 型 提供 了 更 好 的 性 能 ， 因 为 它们 不 会 导致 装 箱 或 拆 箱 的 损耗 。 

口 泛 型 更 类 型 安全 ， 因 为 它们 只 包含 我 们 指定 的 类 型 。 

口 泛 型 大 幅 减 少 了 构建 自 定义 集合 类 型 的 需要 ， 因 为 当 创 建 泛 型 容器 时 指定 了 “类 型 的 类 型 "。 


源 代 码 IssuesWithNonGenericCollections 项 目的 源 代码 位 于 Chapter 9 子 目 录 下 。 


9.3” 泛 型 类 型 参数 的 作用 


在 .NET 基 础 类 库 的 每 个 命名 空间 中 几乎 都 可 以 看 到 泛 型 类 、 接口 、 结 构 和 委托 。 大 家 也 非常 清楚 ， 
比 起 单纯 定义 集合 类 ，, 泛 型 的 用 处 要 大 得 多 。 事 实 确实 是 这 样 ， 你 会 看 到 本 书 剩余 部 分 会 以 各 种 理由 
用 到 泛 型 。 


说 明 只 有 类 、 结 构 、 接 口 和 委托 可 以 使 用 泛 型 ， 枚 举 类 型 不 可 以 。 


当 你 在 .NET Framework 4.5 SDK 文 档 或 Visual Studio 对 象 浏览 器 中 看 到 泛 型 项 时 , 你 会 发 现 其 表现 
形式 为 一 对 尖 括 号 包 着 内 部 的 字母 或 其 他 标记 。 图 9-1 显 示 了 System.Collections.Generic 命 名 空间 中 
的 一 些 泛 型 项 ， 包 括 突出 显示 的 List<T> 类 。 

尖 括 号 中 标记 的 正式 名 称 为 类 型 参数 ,但 你 也 可 以 通俗 地 将 其 称 为 占 位 符 。<T> 符 号 读 作 of T。 因 
此 IEnumerablex<T> 读 作 IEnumerable of7， 或 者 也 可 以 称 其 为 类 型 7 的 枚 举 。 





说 明 类 型 参数 ( 占 位 符 ) 的 名 称 可 以 随意 取 ， 它 取决 于 创建 该 泛 型 项 的 人 。 但 通常 情况 下 ，7 表 示 
类 型 ，TKey 或 K 表 示 键 ，TValue 或 V 表 示 值 。 
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图 9-1 支持 类 型 参数 的 泛 型 项 


在 创建 泛 型 对 象 、 实 现 泛 型 接口 或 调用 泛 型 成 员 时 ， 为 泛 型 参数 提供 的 值 是 由 开发 者 决定 的 。 
在 本 章 中 你 会 看 到 大 量 的 示例 。 但 为 了 打 好 基础 ， 我 们 先 来 看 看 如 何 与 泛 型 类 型 和 泛 型 成 员 进 行 


交互 。 


9.3.1 为 泛 型 类 /结构 指定 类 型 参数 


在 创建 泛 型 类 或 泛 型 结构 的 实例 时 , 需要 在 声明 变量 和 调用 构造 函数 时 指定 类 型 参数 。 在 之 前 的 
代码 示例 中 ，UseGenericList() 定 义 了 两 个 List<T> 对 和 象 : 


// 该 List<> 只 能 容纳 Person 对 象 
List<Person> morePeople = new List<Person>(); 


这 个 代码 片段 可 以 读 成 a List <> of T，7 为 Person 类 型 。 或 者 更 简单 地 读 作 Person 对 象 列 表 。 为 泛 
型 项 指定 了 类 型 参数 后 ， 就 不 能 更 改 了 ( 记 住 ， 泛 型 是 类 型 安全 的 )。 在 为 泛 型 类 或 结构 指定 类 型 参 
数 时 ， 所 有 的 占 位 符 都 将 替换 为 你 提供 的 值 。 

如 果 用 Visual Studio 对 象 浏览 器 查看 泛 型 ListxcT> 类 的 完整 声明 ， 你 会 发 现 占 位 符 T 遍 布 整个 
List<T> 类 型 的 定义 。 以 下 是 部 分 代码 (注意 粗 体 的 部 分 ): 

// ListkT> 类 的 部 分 代码 

namespace System.Collections.Generic 


public class List<T> : 
IList<T>, ICollection<T>, IEnumerable<T>,IReadOnlyList<T> 
IList, ICollection, IEnumerable 


{ 


ee 
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public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
} 
} 


void Add(T item); 

ReadOnlyCollection<T> AsReadonly(); 

int BinarySearch(T item); 

bool Contains(T item); 

void CopyTo(T[] array); 

int FindIndex(System.Predicate<T> match); 
T FindLast(System.Predicate<T> match); 
bool Remove(T item); 

int RemoveAll(System.Predicate<T> match ) ; 
T[] ToArray(); 

bool TrueForAll(System.Predicate<T> match); 
T this[int index] { get; set; } 


当 创 建 指定 Person 对 象 的 List<T> 时 ， 就 如 同 List<T> 类 型 的 定义 如 下 : 


namespace System.Collections.Generic 


public class List<Person> : 
IList<Person>, ICollection<Person>, IEnumerable<Person>,IReadOnlyList<Person> 


IList， 

{ 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 

} 

} 


ICollection, IEnumerable 


void Add(Person item); 
ReadOnlyCollection<Person> AsReadOnly(); 

int BinarySearch(Person item); 

bool Contains(Person item); 

void CopyTo(Person[] array); 

int FindIndex(System.Predicate<Person> match); 
Person FindLast(System.Predicate<Person> match); 
bool Remove(Person item); 

int RemoveAll(System.Predicate<Person> match); 
Person[] ToArray(); 

bool TrueForAll(System.Predicate<Person> match); 
Person this[int index] { get; set; } 


当然 ， 在 创建 泛 型 List<T> 变 量 时 ， 编 译 器 并 没有 为 List<T> 类 创建 全 新 的 实现 ， 而 是 只 处 理 你 实 
际 调用 的 泛 型 类 型 的 成 员 。 


9.3.2 为 泛 型 成 员 指定 类 型 参数 


非 泛 型 类 或 结构 都 支持 泛 型 成 员 〈 如 方法 和 属性 )。 因 此 在 调用 这 种 方法 时 ， 你 仍然 需要 指定 占 
位 符 的 值 。 例 如 ，S$ystem.Array 支 持 一 些 泛 型 方法 。 如 现在 的 非 泛 型 Sort() 静 态 方法 包含 一 个 相应 的 
泛 型 方法 Sort<T>()。 考 虑 下 面 的 代码 段 ， 其 中 T 为 int 类 型 : 


int[] myInts = { 10, 4, 2, 33, 93 }; 


// 为 Sort<>() 泛 型 方法 指定 占 位 符 
Array.Sort<int>(myInts); 


foreach (int i in myInts) 


Console.WritelLine(i); 
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9.3.3 为 泛 型 接口 指定 类 型 参数 


在 构建 支持 不 同 框架 行为 ( 如 克隆 、 排 序 和 枚 举 ) 的 类 或 结构 时 ， 实 现 泛 型 接口 是 很 常见 的 。 我 
们 在 第 8 章 中 学 习 了 一 些 非 泛 型 接口 ， 如 IComparable 、IEnumerable 、IEnumerator 和 IComparer。 非 泛 
型 的 IComparable 接 口 的 定义 如 下 : 


public interface IComparable 


int CompareTo(object obj); 


在 第 8 章 中 ， 我们 在 Car 类 上 实现 了 该 接口 ， 使 之 能 够 在 标准 数组 中 排序 。 但 是 ， 代 码 需 要 进行 很 
多 运行 时 检查 和 转换 操作 ， 因 为 参数 是 通用 的 System.0bject: 


public class Car : IComparable 


所 IComparable 的 实现 
int IComparable.CompareTo(object obj) 


Car temp = obj as Car; 
if (temp != null) 


if (this.CarID > temp.CarID) 
return 1; 

if (this.CarID < temp.CarID) 
return -1; 

else 
return 0; 





else 
throw new ArgumentException("Parameter is not a Car!"); 
} 


} 
现在 ,假设 我 们 使 用 与 该 接口 对 应 的 泛 型 : 


public interface IComparable<T> 


int CompareTo(T obj); 


这 时 ， 实 现 的 代码 会 变 得 十 分 整洁 : 


public class Car : IComparable<Car> 


// IComparable<T> 的 实现 
int IComparable<Car>.CompareTo(Car obj) 


if (this.CarID > obj.CarID) 
return 1; 

if (this.CarID < obj.CarID) 
return -1; 

else 
return 0; 
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这 里 你 不 用 判断 传人 的 参数 是 否 为 Car， 因 为 它 只 能 为 Car。 如 果 传人 的 数据 类 型 不 兼容 ， 将 得 到 
编译 时 错误 。 现 在 我 们 已 经 了 解 了 与 泛 型 项 交互 的 方式 和 类 型 参数 ( 占 位 符 ) 的 作用 ， 下 面 就 来 学 习 
System.Collections.Generic 命 名 空间 下 的 类 和 接口 。 


9.4 System.Collections.Generic 命名 空间 


我 们 构建 .NET 应 用 程序 时 需要 一 种 管理 内 存 数据 的 方式 ，System.Collections.Generic 就 是 专门 做 这 
个 的 。 在 本 章 开始 ， 我 简单 提 到 了 一 些 非 泛 型 接口 ， 它 们 是 由 一 些 非 泛 型 集合 类 实现 的 。 不 要 奇怪 ， 
System.Collections.Generic 命 名 空间 中 为 大 多 数 非 泛 型 接口 都 定义 了 泛 型 版 本 。 

实际 上 ， 你 会 发 现 很 多 泛 型 接口 都 扩展 了 它们 的 非 泛 型 版 本 ! 这 看 上 去 很 怪异 。 不 过 ， 这 人 么 做 可 
以 使 那些 实现 类 支持 非 泛 型 版 本 中 的 旧 功 能 。 例如，IEnumerable<T> 扩 展 了 IEnumerable。 表 9-4 列 出 了 
在 使 用 泛 型 集合 类 时 经 常 遇 到 的 核心 泛 型 接口 。 


表 9-4 System.Collections.Generic 中 的 类 支持 的 核心 接口 


System.Collections.Generic 接 口 


作 用 





ICollection<T> 


IComparer<T> 


IDictionary<TKey, TValue> 


IEnumerablex<T> 


IEnumerator<T> 


IList<T> 


ISet<T> 


为 所 有 泛 型 集合 类 型 定义 基本 特性 ( 如 大 小 、 枚 举 、 线 程 安全 ) 
定义 比较 对 象 的 方式 

允许 泛 型 集合 对 象 使 用 名 称 / 值 对 来 表示 其 内 容 

为 给 定 对 象 返 回 IEnumerator<T> 接 口 

允许 泛 型 集合 以 foreach 形 式 迭 代 

为 顺序 列表 中 的 对 象 提供 添加 、 移 除 和 索引 项 的 行为 

为 抽象 的 集 提供 基 接 口 


System.Collections .Generic 命 名 空间 还 定义 了 一 些 实现 这 些 核心 接口 的 类 。 表 9-5 描 述 了 该 命名 
空间 中 的 常用 类 、 它 们 实现 的 接口 和 基本 功能 。 


表 9-5 System.Collections.Generic 中 的 类 


泛 型 类 
Dictionary 
<TKey, TValue> 


LinkedList<T> 
List<T> 


Queue<T> 


SortedDictionary 


<TKey, TValue> 
SortedSet<T> 
Stack<T> 


ICollection<T> 、 


IEnumerable<T> 


ICollection<T>、 
ICollection<T>、 
ICollection ( 不 是 笔 误 ， 就 是 非 泛 型 集合 接口 ) 、 


IEnumerable<T> 


ICollection<T> 、 


IEnumerable<T> 


ICollection<T>、 
ICollection (不 是 笔 误 ， 就 是 非 泛 型 集合 接口 ) 、 


IEnumerablex<T> 


支持 的 关键 接口 作 用 
IDictionary<TKey, TValue> 、 一 个 名 / 值 对 泛 型 集合 
IEnumerable<T> 一 个 双向 链表 的 泛 型 实现 


一 个 可 动态 改变 大 小 的 顺序 列表 
一 个 先 人 先 出 (FIFO ) 列表 的 泛 型 实现 


IEnumerable<T> 、IList<T> 


IDictionary<TKey, TValue> 、 一 个 排序 的 名 称 / 值 对 集合 的 泛 型 实现 


一 个 排序 的 不 重复 的 对 象 集合 
一 个 后 人 先 出 ( LIFO ) 列表 的 泛 型 实现 


IEnumerable<T>、ISet<T> 
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System.Collections.Generic 命 名 空间 还 定义 了 许多 与 特定 容器 联合 使 用 的 辅助 类 与 结构 。 举例 来 
说 , LinkedListNode<T> 类 型 表示 泛 型 LinkedList<T> 中 容纳 的 节点 。 如 果 试 图 使 用 不 存在 的 键 从 容器 中 
取出 一 项 ， 将 触发 KeyNotFoundException 异 常 。 

还 要 指出 一 点 ，System.Collections.Generic 命 名 空间 不 仅仅 在 mscorlib.dll 和 System.dll 程 序 集中 
添加 了 新 的 类 型 。 例 如 ， 在 System.Core.dll 中 添加 了 HashSet<T> 类 。 有 关 System.Collections.Generic 
命名 空间 更 详细 的 内 容 ， 请 参考 .NET Framework 文 档 。 

我 们 下 一 步 的 任务 是 学 习 如 何 使 用 这 些 泛 型 集合 类 。 不 过 在 这 之 前 ， 我 要 介绍 一 个 ( .NET 3.5 中 
引入 的 ) C#i 语 言 特性 ， 它 简化 了 填充 泛 型 ( 和 非 泛 型 ) 数据 集合 容器 的 方式 。 


9.4.1 集合 初始 化 语法 


在 第 4 章 中 ， 我 们 学 习 了 对 象 初始 化 语法 ， 它 允许 我 们 在 构造 变量 时 设置 其 属性 。 与 此 密切 相关 
的 是 集合 初始 化 语法 。 这 个 C# 语 言 特性 让 你 可 以 用 与 填充 基础 数组 类 似 的 语法 ， 来 填充 ArrayList 或 
List<T> 等 容器 。 


说 明 只 能 对 支持 Add() 方 法 的 类 使 用 集合 初始 化 语法 ， 这 是 ICollectionkT>/ICollection 接 口 决 
的 。 


对 


考虑 如 下 的 示例 : 


// 初始 化 标准 的 数组 
int[] myArrayOfInts = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }); 


// 初始 化 整数 的 泛 型 List<> 
List<int> myGenericList = new List<int> { 0，1，2，3，4，5，6，7，8，9 }; 


// 使 用 数字 数据 初始 化 ArTayList 

ArrayList myList = new ArrayList { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; 

如 果 容 器 操作 的 是 类 或 结构 的 集合 ， 你 可 以 将 对 象 初始 化 语法 与 集合 初始 化 语法 混合 使 用 ， 以 产 
生 一 些 功能 代码 。 你 也 许 还 记得 第 5 章 中 的 Point 类 , 它 定义 了 两 个 属性 Xx 和 Y。 如 果 要 构建 Point 对 象 的 
泛 型 List<T>， 可 以 编写 如 下 的 代码 : 

List<Point> myListOfPoints = new List<Point> 

new Point { X= 2, Y = 2 }, 


new Point { X = 3, Y = 3 }, 
new point(PointColor. BloodRed){ X= 4, Y=4} 


; 
foreach (var pt in myListOfPoints) 


Console.WriteLine(pt); 


这 种 语法 的 好 处 也 是 减少 键盘 输入 。 如 果 不 注意 格式 的 话 ， 这 种 髓 套 的 大 括号 会 降低 可 读 性 。 但 
， 如 果 没 有 集合 初始 化 语法 ， 填 充 下 面 这 个 Rectangle 的 List<T> 需 要 的 代码 量 将 是 非常 惊人 的 (你 
es 它 包含 的 两 个 属性 都 封装 了 Point 对 象 ): 
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List<Rectangle> myListOfRects = new List<Rectangle> 


new Rectangle {Topleft = new Point { X = 10, Y = 10 }, 
BottomRight = new Point { X = 200, Y = 200}}, 
new Rectangle {Topleft = new Point { X= 2, Y = 2 ), 
BottomRight = new Point { X = 100, Y = 100}}, 
new Rectangle {Topleft = new Point { X= 5, Y= 5 }, 


BottomRight = new Point { X = 90, Y = 75}} 
}; 


foreach (var r in myListOfRects) 


Console.WriteLine(r); 


} 


9.4.2 ”使 用 ListxT> 类 


创建 一 个 全 新 的 Console Application 项 目 FunWithGenericCollections。 注 意 初 始 的 C# 代 码 文件 还 引 
入 了 System.Collections.Generic 命 名 空间 。 

我 们 要 研究 的 第 一 个 泛 型 类 是 ListkcT> ， 它 在 本 章 中 已 经 出 现 一 两 次 了 。ListcT> 类 是 
System.Collections.Generic 命 名 空间 中 最 常用 的 类 型 , 因为 它 可 以 动态 调整 内 容 。 为 了 演示 该 类 型 的 
基础 ,考虑 下 面 这 个 Program 类 中 的 方法 ,该 类 使 用 List<T> 操 作 本 章 前 面 提 到 的 Person 对 象 ,这 些 Person 
对 象 定义 了 3 个 属性 (Age、FirstName 和 LastName ) 和 一 个 自 定义 Tostring() 实 现 : 


static void UseGenericList() 


{ 
// 使 用 集合 /对 象 初始 化 语法 ， 构 建 一 个 Person 对 象 的 列表 
List<Person> people = new List<Person>() 


new Person {FirstName= "Homer", LastName="Simpson", Age=47}, 
new Person {FirstName= "Marge", LastName="Simpson", Age=45}, 
new Person {FirstName= "Lisa", LastName="Simpson", Age=9}, 
new Person {FirstName= "Bart", LastName="Simpson", Age=8} 


}; 


// 打印 列表 中 项 的 个 数 
Console.WriteLine("Items in list: {0}", people.Count); 


// 枚 举 列 表 
foreach (Person p in people) 
Console.WriteLine(p); 


// 插入 一 个 新 Person 

Console.WriteLine("\n->Inserting new person."); 

people.Insert(2, new Person { FirstName = "Maggie", LastName = "Simpson", Age = 2 }); 
Console.WriteLine("Items in list: {0}", people.Count); 


// 将 数据 复制 到 新 的 数组 中 
Person[] arrayOfPeople = people.ToArray(); 
for (int i = 0; i < arrayOfPeople.Length; i++) 


Console.WriteLine("First Names: {0}", arrayOfPeople[i].FirstName); 
} 
} 
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这 里 我 们 使 用 初始 化 语法 将 对 象 填 人 List<T>, 将 其 作为 调用 n 次 Add() 方 法 的 简写 形式 。 打 印 集合 
的 项 数 和 枚 举 各 个 项 之 后 ， 调 用 了 Insert() 方 法 。 如 你 所 见 ，Insert() 可 以 向 List<T> 中 的 指定 索引 位 
置 插入 一 个 新 项 。 

最 后 调用 了 ToArray() 方 法 ， 它 基于 原始 的 List<T>， 返 回 一 个 Person 对 象 数组 。 我 们 使 用 数组 索 
引 器 语法 ， 对 该 数组 再 次 执行 循环 。 在 Main() 中 调用 该 方法 ， 将 得 到 如 下 输出 结果 : 





****** Fun with Generic Collections ***** 


Items in list: 4 

Name: Homer Simpson, Age: 47 
Name: Marge Simpson, Age: 45 
Name: Lisa Simpson, Age: 9 
Name: Bart Simpson, Age: 8 


->Inserting new person. 
Items in list: 5 

First Names: Homer 
First Names: Marge 
First Names: Maggie 
First Names: Lisa 
First Names: Bart 





List<T> 类 还 定义 了 其 他 一 些 有 趣 的 成 员 ,， 更 多 信息 请 参考 .NET Framework 文 档 。 接 下 来 ,我 们 来 
学 习 更 多 的 泛 型 集合 ， 如 Stack<T>、Queue<T> 和 SortedSet<T>。 这 将 有 助 于 你 理解 如 何 选 择 保存 用 户 自 
定义 数据 的 方式 。 


9.4.3 ”使 用 Stack<T> 类 


stack<T> 类 表示 以 后 进 先 出 的 方式 维护 数据 的 集合 。 它 包含 Push() 和 Pop() 方 法 ， 可 以 向 栈 压 入 数 
据 或 从 栈 移 除数 据 。 下 面 的 代码 创建 了 一 个 Person 对 象 的 栈 ; 


static void UseGenericStack() 


{ 


Stack<Person> stackOfPeople = new Stack<Person>(); 
stackOfPeople.Push(new Person 


{ FirstName = "Homer", LastName = "Simpson", Age = 47 }); 
stackOfPeople.Push(new Person 
{ FirstName = "Marge", LastName = "Simpson", Age = 45 }); 


stackOfPeople.Push(new Person 
{ FirstName = "Lisa", LastName = "Simpson", Age = 9 }); 


// 观察 栈 顶 的 项 ， 取 出 ， 再 次 观察 
Console.WriteLine("First person is: {0}", stackOfPeople.Peek()); 
Console.WriteLine("Popped off {0}", stackOfPeople.Pop()); 


Console.WriteLine("\nFirst person is: {0}"，stackOfPeople.Peek()); 
Console.WritelLine("Popped off {0}", stackOfPeople.Pop()); 


Console.WritelLine("\nFirst person item is: {0}", stackOfPeople.Peek()); 
Console.Writeline("Popped off {0}", stackOfPeople.Pop()); 


try 
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Console.WriteLine("\nnFirst person is: {0}", stackOfPeople.Peek()); 
Console.WriteLine("Popped off {0}", stackOfPeople.Pop()); 


i (InvalidOperationException ex) 
Console.WritelLine("\nError! {0}", ex.Message); 
} 
} 
这 里 ,我们 构建 了 包含 3 个 Persen 的 栈 ， 按 名 字 的 顺序 添加 : Homer、Marge 和 Lisa。 在 观察 栈 时 ， 


得 到 的 永远 是 栈 顶 对 象 。 因此 , 我 们 先 调 用 Peek() 来 显示 第 三 个 Person 对 象 。 在 一 系列 的 Pop() 和 Peek() 
调用 之 后 ， 栈 最 终 为 空 ， 这 时 再 调用 peek() 和 pop() 将 触发 系统 异常 。 输 出 结果 如 下 : 





沙 冰 冰冰 沙 Fun with Generic Collections ***** 


First person is: Name: Lisa Simpson, Age: 9 
Popped off Name: Lisa Simpson, Age: 9 


First person is: Name: Marge Simpson, Age: 45 
Popped off Name: Marge Simpson, Age: 45 


First person item is: Name: Homer Simpson, Age: 47 
Popped off Name: Homer Simpson, Age: 47 


Error! Stack empty. 





9.4.4 ”使 用 0ueuex<T> 类 


队列 是 确保 以 先进 先 出 的 方式 访问 数据 的 容器 。 悲 剧 的 是 , 我 们 人 类 整 天 都 在 队列 : 在 银行 排队 ， 
在 电影 院 排队 , 在 咖啡 馆 排队 。 如 果 你 需要 对 一 个 以 先 到 先 得 方式 处 理 数 据 的 场景 进行 建 模 , Queue<T> 
类 是 很 适合 的 。 除 了 接口 提供 的 功能 以 外 ，Queue 还 定义 了 如 表 9-6 所 示 的 关键 成 员 。 


表 9-6 ”Queue<T> 类 型 的 成 员 


Queue<T> 中 的 选择 成 员 作 用 
Dequeue() 移 除 并 返回 Queue<T> 开 始 处 的 对 象 
Enqueue() 在 Queuex<T> 的 末尾 处 添加 一 个 对 象 
peek() 返回 Queue<T> 开 始 处 的 对 象 ， 但 不 移 除 





现在 来 使 用 这 些 方法 。 我 们 再 次 使 用 Person 类 构建 一 个 QueuexT> ， 来 模仿 一 群 正在 排队 点 咖啡 的 
人 。 首先 ， 编写 如 下 的 静态 辅助 方法 : 


static void GetCoffee(Person p) 


Console.WritelLine("{0} got coffee!", p.FirstName); 


现在 假设 你 有 另 一 个 辅助 方法 ， 在 其 内 部 调用 GetCoffee() : 
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static void UseGenericQueue() 


{ 

// 创建 一 个 包含 3 个 人 的 队列 

Queue<Person> people0 = new Queue<Person>(); 

peopleQ.Enqueue(new Person {FirstName= "Homer", 
LastName="Simpson", Age=47}); 

peopleQ.Enqueue(new Person {FirstName= "Marge", 
LastName="Simpson", Age=45}); 

people0.Enqueue(new Person {FirstName= "Lisa", 
LastName="Simpson", Age=9}); 


// 观察 队列 中 的 第 一 个 人 
Console.WriteLine("{0} is first in line!", peopleQ.Peek().FirstName); 


// 移 除 队列 中 的 人 
GetCoffee(peopleQ.Dequeue()); 
GetCoffee(peopleQ.Dequeue()); 
GetCoffee(peopleQ.Dequeue()); 
// 再 次 从 队列 中 获取 数据 

try 


GetCoffee(peopleQ.Dequeue()); 
catch(InvalidOperationException e) 
Console.WritelLine("Error! {0}", e.Message); 

} 

我 们 在 这 里 使 用 Enqueue() 方 法 向 Queue<T> 类 中 插入 了 3 个 项 。 调 用 Peek() 方 法 可 以 观察 (但 不 移 
除 ) 当前 Queue 中 的 第 一 项 。 最 后 ， 调 用 Dequeue() 方 法 移 除 队 列 中 的 项 ， 并 将 其 发 送 给 GetCoffee() 辅 
助 方法 进行 处 理 。 注 意 ， 如 果 你 对 一 个 空 队列 进行 移 除 操作 ， 将 抛 出 运行 时 异常 。 以 下 是 调用 该 方法 
的 输出 结果 : 








etter er eT se 


** 水 ** Fun with Generic Collections ***** 


Homer is first in line! 
Homer got coffee! 

Marge got coffeel 

Lisa got coffee! 

Error! Queue empty. 





9.4.5 ”使 用 SortedSetx<T> 类 


我 们 要 介绍 的 最 后 一 个 泛 型 集合 类 是 .NET 4.0 刚 刚 引 入 的 SortedSetxT> 类 。SortedSet<T> 类 中 的 项 是 
排序 的 ， 在 插入 和 移 除 项 之 后 ， 也 能 自动 确保 排序 正确 ， 因 此 该 类 十 分 有 用 。 不 过 ， 你 必须 通知 
SortedSset<T> 按 何 种 方式 进行 排序 ， 你 可 以 向 其 构造 函数 传递 一 个 实现 了 IComparer<T> 泛 型 接口 的 参数 。 

创建 一 个 全 新 的 类 SortPeopleByAge， 实 现 IComparer<T>， 其 中 T 为 Person 类 型 。 记 住 该 接口 定义 了 
Compare() 方 法 ， 可 以 包含 任何 需要 的 比较 逻辑 。 下 面 是 该 类 的 简单 实现 : 


class SortPeopleByAge : IComparer<Person> 


public int Compare(Person firstPerson, Person secondPerson) 
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if (firstpPerson.Age > secondPerson.Age) 
return 1; 
if (firstPerson.Age < secondPerson.Age) 
return -1; 
else 
return 0; 
} 


} 
现在 在 Program 类 中 添加 下 面 的 新 方法 ， 我 们 假设 在 Main() 中 调用 该 方法 : 


static void UseSortedSet() 


{ 
// 添加 一 些 不 同年 龄 的 人 
SortedSet<Person> setOfPeople = new SortedSet<Person>(new SortPeopleByAge()) 


new Person {FirstName= "Homer”", LastName="Simpson", Age=47}, 
new Person {FirstName= "Marge", LastName="Simpson", Age=45}, 
new Person {FirstName= "Lisa", LastName="Simpson", Age=9}, 
new Person {FirstName= "Bart", LastName="Simpson", Age=8} 


}; 
// 各 项 是 按照 年 龄 排序 的 


foreach (Person p in setOfPeople) 
Console.WriteLine(p); 


Console.WriteLine(); 


// 添加 一 些 具有 不 同年 龄 的 人 
setOfPeople.Add(new Person { FirstName 
setOfPeople.Add(new Person { FirstName 


// 仍然 按照 年 龄 排序 
foreach (Person p in setOfPeople) 


"Saku", LastName = "Jones", Age = 1 }); 
"Mikko", LastName = "Jones", Age = 32 }); 


Console.WriteLine(p); 


} 
运行 应 用 程序 ， 列 表 中 的 对 象 将 永远 按 Age 属 性 的 值 排序 ， 而 与 插入 和 移 除 对 象 的 顺序 无 关 : 


一 
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Name: Bart Simpson, Age: 8 
Name: Lisa Simpson, Age: 9 
Name: Marge Simpson, Age: 45 
Name: Homer Simpson, Age: 47 


Name: Saku Jones, Age: 1 
Name: Bart Simpson, Age: 8 
Name: Lisa Simpson, Age: 9 
Name: Mikko Jones, Age: 32 
Name: Marge Simpson, Age: 45 
Name: Homer Simpson, Age: 47 





源 代码 ”FunWithGenericCollections 项 目的 源 代 码 位 于 Chapter 9 子 目 录 下 。 
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9.5 System.Collections.0bjectModel 命名 空间 


现在 你 已 经 理解 了 如 何 使 用 泛 型 ， 下 面 我 们 来 看 一 另 一 个 以 泛 型 为 核心 的 命名 空间 
System.Collections.0bjectModel。 它 是 一 个 非常 小 的 命名 空间 ， 只 包含 少量 的 类 。 表 9-7 列 出 了 两 个 
你 应 该 了 解 的 类 。 


表 9-7 System.Collections.0bjectModel 中 有 用 的 成 员 








System.Collections.0bjectModel 中 的 类 型 含 义 
ObservableCollection<T> 表示 能 在 添加 、 移 除 项 或 刷新 整个 列表 时 提供 通知 的 动态 数据 集合 。 
Read0nl1yObservabJleCollection<Ty 表示 0bservableCollection<T> 的 只 读 版 本 


ObservableCollection<T> 类 十 分 有 用 ， 它 可 以 在 其 内 容 发 生变 化 时 以 某 种 方式 通知 外 部 对 象 
( ReadOnlyObservableCollection<T> 的 操作 与 之 类 似 ， 只 不 过 是 只 读 的 )。 


使 用 ObservableCollection<T> 


创建 一 个 新 的 名 为 FunWithObservableCollection 的 Console Application， 在 初始 的 C# 代 码 文 件 
中 引入 System.Collections.0bjectModel 命 名 空间 。 在 很 多 情况 下 ， 使 用 0bservableCollection<T> 
与 使 用 List<T> 完 全 相同 , 因为 它们 都 实现 了 相同 的 核心 接口 。 不同 的 是 , ObservableCollection<T> 
实现 了 一 个 名 为 CollectionChanged 的 事件 。 该 事件 将 在 插入 新 项 、 移 除 ( 或 重新 分 配 ) 当前 项 或 修 
改 整 个 集合 时 触发 。 

与 其 他 事件 相同 ，CollectionChanged 定 义 为 委托 ( 这 里 为 NotifyCollectionChangedEventHandler )。 
该 委托 可 以 调用 任何 以 object 为 第 一 个 参数 ， 以 NotifyCollectionChangedEventArgs 为 第 二 个 参数 的 方 
法 。 下 面 的 Main() 方 法 将 生成 一 个 包含 Person 对 象 的 可 观察 集合 ， 并 绑 定 CollectionChanged 事 件 : 


class Program 
static void Main(string[] args) 


// 创 建 一 个 用 来 观察 的 集合 ， 并 添加 一 些 Person 对 象 
ObservableCollection<Person> people = new ObservableCollection<Person>() 


{ 
new Person{ FirstName = "Peter", LastName = "Murphy", Age = 52 }, 
new Person{ FirstName = "Kevin", LastName = "Key", Age = 48 }, 
2 

// 绑 定 CO01lectionChanged 事 件 

people.CollectionChanged += people CollectionChanged; 


} 


static void people CollectionChanged(object sender, 
System.Collections.Specialized.NotifyCollectionChangedEventArgs e) 


throw new NotImplementedException(); 
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接 下 来 的 NotifyCollectionChangedEventArgs 参 数 定义 了 两 个 重要 属性 ，01dItems 和 NewItems ， 前 
者 给 出 当前 集合 中 事件 触发 之 前 的 项 ， 后 者 给 出 变化 后 的 新 项 。 不 过 ,你 可 能 只 会 在 正常 情况 下 查看 
列表 。 回 想 一 下 ,插入 、 移 除 、 重 新 定位 或 者 重新 设置 项 均 会 触发 CollectionChanged 事 件 。Action 属 
性 可 用 来 测试 NotifyCollectionChangedAction 枚 举 的 下 列 任意 成 员 : 
public enum NotifyCollectionChangedAction 
Add = 0， 
Remove = 1， 
Replace = 2， 
Move = 3， 


Reset = 4， 
} 


以 下 是 CollectionChanged 事 件 处 理 程序 的 一 种 实现 ， 它 在 集合 插入 或 移 除 项 时 打印 旧 的 或 新 的 集合 : 
static void people CollectionChanged(object sender, 
System.Collections.Specialized,NotifyCollectionChangedEventArgs e) 


// 触 发 事件 的 行为 是 什么 


Console.WritelLine("Action for this event: {0}", e.Action); 


// 是 移 除 项 
if (e.Action == System.Collections.Specialized.NotifyCollectionChangedAction.Remove) 


Console.WriteLine("Here are the OLD items:"); 
foreach (Person p in e.0ldItems) 


Console.WriteLine(p.ToString()); 


Console.WriteLine(); 
上 
// 是 添加 项 
if (e.Action == System.Collections.Specialized.NotifyCollectionChangedAction.Add) 


// 显 示 添 加 后 的 新 项 
Console.WritelLine("Here are the NEW items:"); 
foreach (Person p in e.NewItems) 


Console.WritelLine(p.ToString()); 


} 
上- 


现在 ,假设 我 们 更 新 了 Main() 方 法 来 添加 和 移 除 一 个 项 ， 你 将 看 到 类 似 下 面 的 输出 结果 : 





Action for this event: Add 
Here are the NEW items: 
Name: Fred Smith, Age: 32 


Action for this event: Remove 
Here are the OLD items: 
Name: Peter Murphy, Age: 52 





以 上 就 是 .NET 基 础 类 库 中 以 泛 型 为 核心 的 命名 空间 。 作 为 本 章 的 结束 , 我 们 将 学 习 如 何 构 建 自 定 
义 泛 型 方法 和 自 定义 泛 型 类 型 。 
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源 代码 ”FunWithObservableCollection 项 目的 源 代码 位 于 第 9 章 的 子 目 录 下 。 





9.6 ”创建 自 定义 泛 型 方法 

尽管 大 多 数 开 发 者 通常 使 用 基础 类 库 中 已 知 的 泛 型 类 型 ,不 过 你 也 可 以 构建 自己 的 泛 型 成 员 和 自 
定义 泛 型 类 型 。 我 们 来 看 看 如 何在 项 目 中 添加 自 定义 泛 型 。 首 先 构 建 一 个 泛 型 包装 方法 。 我 们 新 建 一 
个 控制 台 应 用 程序 CustomGenericMethods。 

在 构建 自 定义 泛 型 方法 时 ， 你 可 以 得 到 一 个 加 强 版 的 方法 重 载 方式 。 在 第 2 章 中 ， 我 们 知道 重 载 
可 以 为 一 个 方法 定义 多 个 版 本 ， 它 们 以 参数 的 数量 和 类 型 进行 区 分 。 

尽管 在 面向 对 象 语 言 中 重 载 是 很 有 用 的 特性 ， 但 却 经 常 发 生 多 个 方法 实现 相似 功能 的 情况 。 例 
如 ， 你 需要 构建 一 些 方法 ， 使 用 简单 的 规则 交换 两 个 数据 。 你 可 能 会 编写 一 个 操作 整数 的 新 方法 ， 如 
下 所 示 : 

// 交换 两 个 整数 

static void Swap(ref int a, ref int b) 


int temp; 
temp = a; 
a=b; 

b = temp; 


就 这 样 还 好 。 但 如 果 还 希望 交换 两 个 Person 对 象 ， 就 需要 编写 swap() 的 新 版 本 : 


// 交换 两 个 Person 对 象 
static void Swap(ref Person a, ref Person b) 


Person temp 


temp = a; 
a 三 -的 
b = temp; 


毫 无 疑问 ， 你 知道 这 意味 着 什么 。 如 果 还 需要 交换 浮 点 数 、 位 图 、 汽 车 、 按 钮 等 ， 就 需要 构建 更 
多 的 方法 ， 这 将 给 维护 工作 带 来 麻烦 。 你 可 以 创建 单一 的 〈 非 泛 型 的 ) 方法 来 操作 object 参 数 ， 但 这 
将 面 对 本 章 开 始 时 所 指出 的 所 有 问题 ， 如 装 箱 、 拆 箱 、 缺 乏 类 型 安全 、 显 示 转 换 等 。 

如 果 你 要 创建 的 方法 重 载 只 是 输入 参数 不 同 , 可 以 使 用 泛 型 。 考虑 如 下 的 Swap<T> 泛 型 方法 , 可 以 
交换 任意 两 个 T: 

// 该 方法 可 以 交换 任意 两 个 由 类 型 参数 <T> 指 定 的 项 

a void Swap<T>(ref T a, ref T b) 


Console.WritelLine("You sent the Swap() method a {0}", 
typeof(T)); 
temp; 
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注意 , 在 定义 泛 型 方法 时 ， 类 型 参数 在 方法 名 称 之 后 、 参 数列 表 之 前 进行 指定 。 这 里 的 Swap<T>() 
方法 可 以 操作 任意 两 个 <T> 类 型 的 参数 。 为 了 更 加 直观 地 说 明 ， 我 们 还 使 用 C# 的 typeof() 操 作 符 向 控 
制 台 打印 占 位 符 的 类 型 名 称 。 现 在 考虑 下 面 的 Main() 方 法 ， 可 以 交换 整数 和 字符 串 : 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Custom Generic Methods *****\n"); 


// 交换 两 个 整数 

int a = 10, b = 90; 

Console.WritelLine("Before swap: {0}, {1}", a, b); 
Swap<int>(ref a, ref b); 
Console.WriteLine("After swap: {0}, {1}", a, b); 
Console.WriteLine(); 


// 交换 两 个 字符 事 

string s1 =“Hello"，s2 = "There"; 
Console.WritelLine("Before swap: {0} {1}!", s1, s2); 
Swap<string>(ref s1, ref s2); 
Console.WriteLine("After swap: {0} {1}!", s1, s2); 


Console.ReadLine(); 


输出 结果 如 下 所 示 : 





六 炒米 灶 米 Fun with Custom Generic Methods ***** 


Before swap: 10, 90 
You sent the Swap() method a System.Int32 
After swap: 90, 10 


Before swap: Hello There! 
You sent the Swap() method a System.String 
After swap: There Hello! 





该 方法 最 大 的 优势 在 于 , 只 需要 维护 一 个 swap<T>() 版 本 , 而 且 它 能 以 类 型 安全 的 方式 操作 任意 两 
个 给 定 参 数 类 型 的 项 。 更 重要 的 是 ， 栈 数据 保留 在 栈 上 ， 堆 数据 保留 在 堆 上 。 


类 型 参数 的 推断 


调用 诸如 swap<T> 之 类 的 泛 型 方法 时 ， 当 ( 且 仅 当 ) 泛 型 方法 需要 参数 时 , 我 们 可 以 选择 省 略 类 型 
参数 ， 因 为 编译 器 会 基于 成 员 参 数 推断 类 型 参数 。 举 个 例子 ， 我 们 可 以 通过 将 以 下 代码 添加 到 Main() 
中 来 交换 两 个 System.Boolean 类 型 的 值 : 


// 编译 器 将 推断 System.Boolean 

bool bl = true, b2 = false; 
Console.WriteLine("Before swap: {0}, {1}", b1, b2); 
Swap(ref b1, ref b2); 

Console.WritelLine("After swap: {0}, {1}", b1i, b2); 


尽管 编译 器 可 以 根据 声明 b1 和 bz 的 类 型 发 现 正确 的 类 型 参数 ， 但 你 还 是 应 该 养 成 显 式 指定 类 型 参 
数 的 习惯 : 


9.6 创建 自 定 义 泛 型 方法 281 


Swap<bool>(ref b1, ref b2); 

这 可 以 让 你 的 同事 很 清楚 地 知道 该 方法 是 泛 型 的 。 另 外 ， 类 型 参数 推断 只 在 泛 型 方法 至 少 有 一 个 
参数 的 时 候 起 作用 。 例 如 ， 假 设 Program 类 包含 如 下 的 谤 型 方法 : 

static void DisplayBaseClass<T>() 


{ 
// BaseType 是 反射 中 使 用 的 一 个 方法 ， 反 射 将 在 第 15 章 中 介绍 
Console.WritelLine("Base class of {0} is: {1}.", 
typeof(T), typeof(T).BaseType); 


这 时 ， 就 必须 在 调用 时 提供 类 型 参数 : 


static void Main(string[] args) 


// 如 果 方 法 没有 和 参数， 就 必须 提供 类 型 参数 
DisplayBaseClass<int>(); 
DisplayBaseClass<string>(); 


// 编译 器 错误 | 没有 参数 时 必须 提供 占 位 符 
// DisplayBaseClass(); 
Console.ReadLine(); 


} 

现在 泛 型 方法 swap<T> 和 DisplayBaseClass<T> 已 经 定义 在 应 用 程序 的 Program 类 中 了 。 和 其 他 方法 
一 样 ， 你 可 以 在 其 他 类 类 型 ( MyGenericMethods ) 中 定义 这 些 成 员 : 

public static class MyGenericMethods 


public static void Swap<T>(ref T a, ref Tb) 


Console.WritelLine("You sent the Swap() method a {0}", 
typeof (T)); 
T temp; 


} 
public static void DisplayBaseClass<T>() 


Console.WriteLine("Base class of {0} is: {1}.", 
typeof(T), typeof(T).BaseType); 


} 

因为 Swap<T> 和 DisplayBaseClass<T> 静 态 方 法 已 被 包含 进 这 个 全 新 的 静 类 类 型 中 ,所 以 我 们 在 调用 
任 一 成 员 时 需要 指定 类 型 名 称 ， 例 如 : 

MyGenericMethods.Swap<int>(ref a, ref b); 

当然 ， 泛 型 方法 并 不 一 定 是 静态 的 。 如 果 swap<T> 和 DisplayBaseClass<T> 是 实例 方法 ( 并 且 定 
义 在 非 静态 类 中 ) ,那么 简单 创建 一 个 MyGenericMethods 的 实例 ,然后 使 用 该 对 象 变量 就 可 以 调用 
它们 : 


MyGenericMethods c = new MyGenericMethods(); 
c.Swap<int>(ref a, ref b); 
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源 代码 ”CustomGenericMethods 项 目的 源 代码 位 于 Chapter 9 子 目录 下 。 


9.7 创建 自 定义 泛 型 结构 和 类 


了 解 了 如 何 定 义 和 调 用 泛 型 方法 之 后 ， 让 我 们 将 注意 力 转 到 泛 型 结构 的 构建 上 来 ( 泛 型 类 的 构建 过 
程 是 一 样 的 ), 新 建 一 个 Console Application 项 目 GenericPoint。 假定 我 们 构造 了 一 个 灵活 的 Point 泛 型 结构 : 
支持 由 一 个 类 型 参数 来 表示 (X,Y ) 坐标 的 实际 存储 结构 。 调 用 者 可 以 像 下 面 这 样 创建 Point<T> 类 型 . 


// 使 用 整数 的 Point 
Point<int> p = new Point<int>(10, 10); 


// 使 用 双 精 度数 的 Point 
Point<double> p2 = new Point<double>(5.4, 3.3); 


下 面 是 Point<T> 的 完整 定义 ,分析 如 下 : 


// 一 个 泛 型 Point 结 构 
public struct Point<T> 


{ 
// 泛 型 状态 数据 
private T xPos; 
private T yPos; 


// 泛 型 构造 函数 
public Point(T xVal, T yVal) 
{ 


xPos = xVal; 
yPos = yVal; 
// 泛 型 属性 
public T X 
{ 
get { return xPos; } 
set { xPos = value; } 
public T Y 
{ 
get { return yPos; } 
set { yPos = value; } 
public override string ToString() 
return string.Format("[{0}, {1}]", xPos, yPos); 
// 重 置 字段 为 类 型 参数 的 默认 值 
public void ResetPoint() 


xPos = default(T); 
yPos = default(T); 
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泛 型 代码 中 的 default 关 键 字 


可 见 ，Point<T> 的 类 型 参数 出 现在 字段 数据 定义 、 构 造 函 数 参数 和 属性 定义 中 。 除 此 之 外 ， 请 注 
意 除 了 重 写 ToString() 方 法 外 ，Point<T> 在 定义 ResetPoint() 方 法 时 使 用 了 一 个 新 的 语法 : 
// 在 C# 中 ，default 关 键 字 被 重 载 


// 和 泛 型 一 起 使 用 时 ， 它 表示 一 个 类 型 参数 的 默认 值 
public void ResetPoint() 
{ 


default(T); 
default(T); 


<x 


在 引入 泛 型 时 ，default 关 键 字 被 赋予 了 双重 身份 。 除 了 在 switch 结 构 内 部 使 用 外 ,还 可 用 于 设置 
类 型 参数 的 默认 值 。 这 是 非常 有 用 的 ， 因 为 一 个 泛 型 类 型 预先 并 不 知道 实际 的 占 位 符 ， 因 此 无 法 安全 
地 假设 默认 值 是 什么 。 类 型 参数 的 默认 值 如 下 : 

口 数值 的 默认 值 为 0; 

口 引用 类 型 的 默认 值 为 nul1; 

口 一 个 结构 的 字段 被 设 为 0 ( 值 类 型 ) 或 null (引用 类 型 )。 

对 Pointx<T> 而 言 , 由 于 其 调用 者 仅仅 使 用 数值 数据 , 所 以 可 以 直接 把 Xx 和 Y 设 为 0 而 使 用 default(T) 
语法 ， 则 可 以 提高 泛 型 类 型 的 灵活 性 。 但 无 论 如 何 ， 我 们 都 可 以 像 下 面 这 样 使 用 Point<T>: 

static void Main(string[] args) 


Console.Writeline("***** Fun with Generic Structures *****\n"); 


// 使 用 整数 的 Point 

Point<int> p = new Point<int>(10, 10); 
Console.WritelLine("p.ToString()={0}", p.ToString()); 
p.ResetPoint(); 
Console.WriteLine("p.ToString()={0}", p.ToString()); 
Console.WritelLine(); 


// 使 用 双 精 度数 的 Point 

Point<double> p2 = new Point<double>(5.4, 3.3); 
Console.WritelLine("p2.ToString()={0}", p2.ToString()); 
p2.ResetPoint(); 
Console.WritelLine("p2.ToString()={0}", p2.ToString()); 


Console.ReadLine(); 
} 
输出 结果 如 下 : 


PNR NEE BiGOE ON EH ESB ED Ee oT OE ODER AICO OE OO Et HOE 


沙沙 六 于 六 Fun with Generic Structures ***** 


p.Tostring()=[10，10] 
p.ToString()=[0, 0] 


p2.ToString()=[5.4, 3.3] 
p2.Tostring()=[0，0] 


ENN 
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源 代码 “GenericPoint 项 目的 源 代 码 位 于 Chapter 9 子 目 录 下 。 


9.8 ”类 型 参数 的 约束 


正如 本 章 所 描述 的 ,任何 泛 型 项 都 必须 至 少 有 一 个 类 型 参数 ， 并 在 与 泛 型 类 型 或 参数 交互 时 指定 
该 类 型 参数 。 这 可 以 使 我 们 构建 类 型 安全 的 代码 。 而 .NET 平 台 使 用 where 关 键 字 可 以 得 到 更 加 具体 的 
类 型 参数 信息 。 

使 用 这 个 关键 字 ， 可 以 对 给 定 的 类 型 参数 添加 一 组 约束 ，C# 编 译 器 将 在 编译 时 检查 这 些 约束 。 可 
对 类 型 参数 添加 的 约束 如 表 9-8 所 示 。 


表 9-8 泛 型 类 型 参数 的 约束 





泛 型 约束 作 用 
where T : struct 该 类 型 参数 cT> 必 须 在 其 继承 链 中 包含 System.ValueType 值 类 型 ， 即 必须 为 结构 
where T : class 该 类 型 参数 <T> 不 能 在 其 继承 链 中 包含 System.ValueType 值 类 型 ， 即 <T> 必 须 是 引用 类 型 
where T : new() 该 类 型 参数 cT> 必 须 包含 一 个 默认 的 构造 函数 。 因 为 无 法 预知 自 定义 构造 函数 的 格式 ， 所 


以 如 果 泛 型 类 型 必须 创建 一 个 类 型 参数 的 实例 , 这 将 是 非常 有 用 的 。 注意 在 有 多 个 约束 的 
类 型 上 ， 此 约束 必须 列 在 末尾 


where T : 该 类 型 参数 <T> 必 须 派 生 于 Name0fBaseClass 指 定 的 类 

NameOfBaseClass 

where T : 该 类 型 参数 <T> 必 须 实现 Name0fInterface 指 定 的 接口 ， 多 个 接口 必须 用 逗号 隔 开 
NameOfInterface 





除非 要 创建 类 型 安全 的 自 定 义 集合 ， 否 则 你 很 少 会 在 C# 项 目 中 使 用 where 关 键 字 。 下 面 的 部 分 代 
码 示例 演示 了 如 何 使 用 where 关 键 字 。 


9.8.1 使 用 where 关 键 字 的 示例 


假设 你 已 经 创建 了 一 个 自 定义 泛 型 类 ， 并且 希望 确保 类 型 参数 包含 一 个 默认 的 构造 函数 。 这 在 自 
定义 泛 型 类 需要 创建 T 的 实例 时 非常 有 用 ， 因 为 对 很 多 常用 类 型 来 说 ， 默 认 构造 函数 是 唯一 的 构造 函 
数 。 同 样 ， 对 T 进 行 这 种 约束 可 以 获得 编译 时 检查 。 如 果 T 是 引用 类 型 ， 程 序 员 会 重新 定义 在 类 中 定义 
的 默认 构造 函数 ( 在 定义 自己 的 类 时 ， 可 能 移 除 了 默认 的 构造 函数 ): 


// MyGenericClass 派 生 自 object， 而 包含 项 必须 拥有 默认 的 构造 函数 
public class MyGenericClass<T> where T : new() 


注意 ，where 子 句 指 定 类 型 参数 需 遵 循 某 种 约束 ， 在 其 之 后 为 冒号 操作 符 。 冒 号 后 面 列 出 了 各 个 
可 能 的 约束 ( 本 例 为 默认 构造 函数 )。 下 面 是 另 一 个 示例 : 


// MyGenericClass 派 生 自 object， 并 且 包 含 项 为 实现 了 IDrawable 的 类 ， 并 且 必 须 支持 默认 构造 函数 
public class MyGenericClass<T> where T : class, IDrawable, new() 
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{ 


} 

本 例 中 的 T 包 含 3 个 条 件 。 它 必须 为 引用 类 型 ( 不 能 为 结构 )， 因 为 使 用 了 class 标 记 。 其 次 ，T 必 须 
实现 IDrawable 接 口 。 最 后 , 它 必须 包含 默认 的 构造 函数 。 这 些 约束 组 成 了 用 逗号 分 隔 的 列表 。 但 要 注 
意 的 是 ，new() 约 束 必须 总 是 在 列表 的 末尾 。 因 此 ， 如 下 的 代码 无 法 编译 : 


// 错误 | new() 约 束 必 须 在 最 后 
public class MyGenericClass<T> where T : new(), class, IDrawable 


} 
如 果 你 创建 的 自 定 义 泛 型 集合 指定 了 多 个 类 型 参数 ， 可 以 为 每 个 类 型 参数 指定 约束 集 ， 各 约束 集 
之 间 用 where 子 句 分 隔 : 


// 《<K>' 必 须 扩展 SomeBaseClass， 并 且 必 须 包 含 默认 构造 函数 

// 《<T> 必 须 为 结构 ， 并 且 实 现 泛 型 TComparable 接 口 

public class MyGenericClass<Kk, T> where K : SomeBaseClass, new() 
where T : struct, IComparablex<T> 


a 
尽管 构建 完整 的 自 定义 泛 型 集合 类 的 情况 很 少见 ， 但 你 还 可 以 将 where 关 键 字 用 于 泛 型 方法 。 例 
如 ， 如 果 要 指定 泛 型 sSwap<T> 方 法 只 能 操作 结构 ， 可 以 这 样 更 新 代码 : 


// 该 方法 可 以 交换 任何 结构 ， 但 不 能 用 于 类 国 
static void Swap<T>(ref T a, ref T b) where T : struct 


{ 
注意 , 如 果 要 以 这 种 方式 约束 Swap() 方 法 , 就 不 能 再 对 string 对 象 进行 交换 了 ( 如 示例 代码 所 示 )， 
因为 string 为 引用 类 型 。 


9.8.2 ”操作 符 约束 的 不 足 


在 本 章 即 将 结束 的 时 候 ， 我 还 想 再 评价 一 下 泛 型 方法 和 约束 。 在 创建 泛 型 方法 时 ， 如 果 对 类 型 参 
数 应 用 任何 C# 操 作 符 (+、-、* 、== 等 )， 都 将 产生 令 人 惊奇 的 编译 器 错误 。 举 例 来 说 ， 想 象 一 下 可 以 
对 泛 型 类 型 进行 Add()、Subtract()、Multiply() 和 Divide() 的 类 : 


// 编译 器 错误 | 不 能 对 类 型 参数 使 用 操作 符 
public class BasicMath<T> 


public T Add(T arg1, T arg2) 

{ return argl + arg2; } 

public T Subtract(T arg1, T arg2) 
{ return arg1 - arg2; } 

public T Multiply(T arg1, T arg2) 
{ return arg1 * arg2; 

public T Divide(T arg1, T arg2) 

{ return arg1 / arg2; } 
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遗憾 的 是 ， 上 面 的 BasicMath 类 并 不 能 编译 。 请 记 住 泛 型 并 不 是 万 能 的 , 不 能 对 类 型 参数 进行 操作 
符 操作 看 上 去 就 是 它 的 主要 限制 之 一 。 当 然 ， 数 值 数据 可 以 使 用 C# 的 二 进 制 操作 符 。 但 如 果 <T> 是 一 
个 自 定义 类 或 结构 类 型 ， 编 译 器 就 不 能 保证 它 已 经 重 载 了 +、-、* 和 /操作 符 。 理 想 情 况 下 ，C# 应 当 允 
许 泛 型 类 型 支持 操作 符 约束 ， 例 如: 
// 演示 代码 
public class BasicMath<T> where T : operator +, operator -， 
operator *, operator / 


public T Add(T arg1, T arg2) 

{ return arg1 + arg2; } 

public T Subtract(T arg1，T arg2) 
{ return arg1 - arg2; } 

public T Multiply(T arg1, T arg2) 
{ return arg1 * arg2; } 

public T Divide(T arg1, T arg2) 

{ return arg1 / arg2; } 


唉 ， 当 前 的 C# 版 本 还 不 支持 操作 符 约束 。 但 我 们 可 以 定义 支持 这 些 操作 符 的 接口 ( C# 接 口 可 以 定 
义 操 作 符 ) ， 然 后 为 泛 型 类 指定 该 接口 的 约束 来 满足 这 一 需求 (但 工作 量 较 大 )。 不 管 怎样 ， 本 章 完 
成 了 关于 构建 自 定义 泛 型 类 型 的 介绍 。 在 下 一 章 介 绍 ,NET 委 托 类 型 时 ， 我 们 还 将 讨论 泛 型 。 


9.9 小结 


本 章 首 先 介 绍 了 System.Collections 和 System.Collections.Specialized 中 的 非 泛 型 集合 类 型 ， 以 
及 很 多 非 泛 型 容器 中 存在 的 问题 ， 如 缺乏 类 型 安全 和 装 箱 拆 箱 操作 带 来 的 运行 时 开销 。 正 因为 如 此 ， 
如 今 的 .NET 程 序 通常 使 用 System.Collections.Generic 和 System.Collections.0bjectModel 中 的 泛 型 集 
合 类 。 

我 们 已 经 看 到 ,使 用 泛 型 能 够 在 创建 对 象 时 ( 在 泛 型 方法 中 为 调用 对 象 时 ) 才 指 定 类 型 的 占 位 符 
(也 就 是 类 型 参数 )。 从 本 质 上 来 说 ， 泛 型 解决 了 .NET 1.1 开 发 中 烦人 的 装 箱 和 类 型 安全 问题 。 此 外 ， 
泛 型 类 型 一 般 不 需要 构建 自 定义 集合 类 型 。 

最 后 要 说 明 的 是 , 在 .NET 基 础 类 库 中 泛 型 随处 可 见 。 本 章 关注 的 是 泛 型 集合 。 然 而 在 你 阅读 本 书 
剩余 章节 ( 或 深入 研究 NET 平台 ) 时 , 你 会 发 现在 一 些 命名 空间 下 还 有 泛 型 类 、 泛 型 结构 和 泛 型 委托 ， 
而 且 在 非 泛 型 类 中 还 可 以 存在 泛 型 成 员 。 


mr 下 








> 止 到 现在 , 本 书 讲解 的 每 个 应 用 程序 ， 从 某 种 意义 上 说 , 都 在 给 Main() 方 法 添加 向 指定 对 象 
发 送 请 求 的 各 种 代码 段 。 但 是 ， 很 多 应 用 程序 需要 对 象 使 用 某 种 回调 机 制 ， 能 够 与 创建 它 
的 实体 进行 通信 。 尽 管 回调 机 制 可 用 于 各 种 应 用 程序 ， 但 它们 对 于 图 形 用 户 界面 来 说 尤其 重要 ， 因 为 
控件 ( 如 按钮 ) 需要 在 正确 的 环境 下 调用 外 部 方法 〈 如 单 击 按钮 时 、 鼠 标 滑 过 按钮 表面 时 等 )。 
在 .NET 平 台 下 ， 委 托 类 型 用 来 定义 和 响应 应 用 程序 中 的 回调 。 事 实 上 ，.NET 委 托 类 型 是 一 个 类 
型 安全 的 对 象 ， 指 向 可 以 以 后 调用 的 其 他 方法 。 和 传统 的 C+ 函数 指针 不 同 ，.NET 委 托 是 内 置 支持 多 
路 广播 和 异步 方法 调用 的 对 象 。 
在 本 章 中 ,我们 将 学 会 如 何 创 建 与 应 用 委托 类 型 ， 接 下 来 再 研究 C# 中 的 event 关 键 字 ， 它 使 我 们 
处 理 委托 类 型 的 过 程 更 加 简化 和 高 效 。 最后， 本 章 讨论 C# 中 与 委托 和 事件 相关 的 语言 新 特性 ,包括 匿 
名 方法 和 方法 组 转换 。 
本 章 最 后 会 讨论 Lambda 表 达 式 。 使 用 新 的 Lambda 操 作 符 (=> ) ， 我 们 就 可 以 在 任何 需要 强 类 型 
委托 的 情况 下 指定 一 个 代码 语句 (以 及 传人 这 个 代码 语句 的 参数 )。 可 以 看 到 ，Lambda 表 达 式 只 是 匿 
名 方法 的 一 种 伪装 ， 提 供 了 一 种 简单 的 方式 来 使 用 委托 。 


10.1 .NET 委托 类 型 


在 正式 定义 .NET 委 托 之 前 ， 让 我 们 先 来 了 解 一 下 背景 。 历 史上 ，Windows API 经 常 使 用 C 语 言 风 
格 的 函数 指针 来 创建 称 为 回调 函数 或 简称 为 回调 ?的 实体 。 使 用 回调 ， 程 序 员 可 以 使 一 个 函数 返回 报 
告 给 ( 即 回调 ) 程序 中 的 另 一 个 函数 。 使 用 这 种 方法 ，Windows 开 发 者 可 以 处 理 按钮 单 击 、 鼠 标 移动 、 
菜单 选择 以 及 内 存 中 两 个 实体 间 的 双向 通信 。 

标准 C 语 言 风格 回调 函数 的 问题 在 于 ， 它 们 除了 原始 内 存 地 址 外 无 法 表示 其 他 信息 。 而 理想 中 的 
回调 应 该 包含 更 多 类 型 安全 信息 ， 例 如 参数 的 数量 与 类 型 、 所 指向 的 方法 的 返回 值 ( 如 果 有 的 话 )。 
很 可 惜 , 这 些 传 统 的 回调 功能 都 做 不 到 , 同时 , 正如 有 些 读 者 可 能 已 经 想到 的 , 它们 因此 经 常 成 为 bug、 
崩溃 和 其 他 运行 时 灾难 的 源头 。 尽 管 如 此 ， 回 调 还 是 非常 有 用 的 实体 。 

在 .NET Framework 里 ， 回 调 仍 是 可 能 的 ， 它 们 的 功能 是 由 使 用 更 为 安全 和 面向 对 象 的 委托 





GD 回调 (callback ) 一 词 本 身 指 的 是 可 以 作为 参数 传 给 其 他 代码 的 一 段 可 执行 代码 。 普 通 调用 往往 是 高 层 代码 ( 如 应 
用 程序 ) 去 调用 处 在 低层 的 函数 (如 系统 函数 、 库 函数 )。 而 回调 时 ， 则 是 在 低层 函数 执行 时 调用 高 层 的 代码 ， 
此 术语 由 此 得 名 。 回 调 (通过 委托 实现 ) 是 多 态 和 泛 型 编程 ( 见 第 9 章 ) 之 外 的 蔡 代 方案 。 一 一 编者 注 
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( delegate ) 来 完成 的 。 本 质 上 来 讲 ， 委 托 是 一 个 类 型 安全 的 对 象 ， 它 指向 程序 中 另 一 个 以 后 会 被 调用 
的 方法 (或 多 个 方法 )。 委 托 类 型 包含 3 个 重要 的 信息 : 

口 它 所 调用 的 方法 的 名 称 ; 

口 该 方法 的 参数 ( 可 选 ); 

口 该 方法 的 返回 值 类 型 ( 可 选 )。 


说 明 ” .NET 委托 既 可 以 指向 静态 方法 ， 也 可 以 指向 实例 方法 。 


当 一 个 委托 对 象 被 创建 并 提供 了 上 述 信息 后 ， 它 可 以 在 运行 时 动态 调用 其 指向 的 方法 。 可 以 看 
到 ，.NET Framework 中 每 个 委托 ( 包括 自 定义 委托 ) 都 被 自动 赋予 同步 或 异步 访问 方法 的 能 力 ， 可 以 
不 用 手工 创建 与 管理 一 个 Thread 对 象 而 直接 调用 另 一 个 辅助 执行 线程 上 的 方法 ,这 大 大 简化 了 编程 工作 。 


说 明 我们 将 在 第 19 章 研究 线程 和 异步 调用 时 介绍 委托 类 型 的 异步 行为 。 本 章 我 们 只 关注 委托 类 型 
的 同步 性 质 。 


10.1.1 在 C# 中 定义 委托 类 型 


在 C# 中 创建 一 个 委托 类 型 时 ， 需 要 使 用 delegate 关 键 字 。 委 托 的 名 称 可 以 自由 选择 。 不 过 ， 必 须 
定义 委托 来 匹配 它 指 向 的 方法 的 签名 。 例 如 ， 假 定 我 们 要 创建 一 个 名 为 Binary0p 的 委托 ， 它 可 以 指向 
任何 输入 两 个 整数 返回 一 个 整数 的 方法 : 


// 这 个 委托 可 以 指向 任何 传 入 两 个 整数 返回 一 个 整数 的 方法 
public delegate int BinaryOp(int x, int y); 


当 C# 编 译 器 处 理 委托 类 型 时 ， 它 先 自动 产生 一 个 派生 自 System.MulticastDelegate 的 密封 类 。 这 
个 类 与 它 的 基 类 System.Delegate 一 起 为 委托 提供 必要 的 基础 设施 , 以 维护 ?以 后 将 要 调用 方法 的 列表 。 
例如 ， 如 果 我 们 通过 ildasm.exe 来 查看 Binary0p 委 托 ， 将 发 现 如 图 10-1 所 示 的 各 项 。 





总 J 
VV FAMy Books\C# Book\C# and the ,NET Platform Sixth Ed (In progress)\Code\Chapter 10\SimpleDele. (cel 天 区 汪 
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图 10-1 C# delegate 关键 字 呈 现 为 一 个 派生 自 System.MulticastDelegate 的 密封 类 





Qz 此 处 和 下 面 的 委托 维护 的 方法 都 指 委托 所 指向 的 方法 。 一 一 编者 注 
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可 以 看 到 ， 生 成 的 Binary0p 类 定义 了 3 个 公共 方法 。Invoke() 可 能 是 核心 方法 ， 因 为 它 被 用 来 以 同 
步 方式 调用 委托 对 象 维护 的 每 个 方法 。 这 里 的 同步 就 是 指 调用 者 必须 等 待 调用 完成 才能 继续 执行 。 奇 
怪 的 是 ， 同 步 Invoke() 方 法 不 能 在 C# 中 直接 调用 。 稍 后 我 们 将 看 到 ， 当 使 用 适当 的 C# 语 法 的 时 候 ， 
Invoke() 将 在 后 台 调 用 。 

BeginInvoke() 和 EndInvoke() 方 法 能 在 第 二 个 执行 线程 上 异步 调用 当前 方法 。 如 果 读 者 有 多 线程 背 
景 知 识 ,会 明白 开发 人 员 创建 第 二 个 执行 线程 的 一 个 最 常见 的 原因 ,是 调用 比较 耗 时 的 方法 。 尽 管 .NET 
基础 类 库 为 多 线程 和 并 行 编程 专门 提供 了 整个 命名 空间 ( System.Threading )， 而 委托 顺带 就 提供 了 这 
一 功能 。 

那么 ,编译 器 又 是 如 何 确切 知道 怎样 定义 Invoke()、BeginInvoke() 和 EndInvoke() 方 法 的 呢 ? 为 了 
理解 这 个 过 程 ， 让 我 们 看 看 下 面 这 段 代 码 ， 它 说 明了 Binary0p 类 的 症结 所 在 〈 其 中 粗 体 部 分 标记 出 定 
义 的 委托 类 型 指定 的 项 ): 

sealed class BinaryOp : System.MulticastDelegate 


public int Invoke(int x, int )); 

public IAsyncResult BeginInvoke(int Xx, int y, 
AsyncCallback cb, object state); 

public int EndInvoke(IAsyncResult result); 


首先 ， 请 注意 由 Invoke() 方 法 定义 的 参数 和 返回 值 完全 匹配 Binary0p 委 托 的 定义 。BeginInvoke() 
员 前 面 的 参数 ( 这 里 是 两 个 整数 ) 也 基于 Binary0p 委 托 ; 但 BeginInvoke() 方 法 将 总 是 提供 最 后 两 个 

参数 ( AsyncCallback 类 型 与 object 类 型 )， 用 于 异步 方法 调用 。 最 后 ，EndInvoke() 方 法 的 返回 值 与 初 
始 的 委托 声明 相同 ， 总 是 以 一 个 实现 了 IAsyncResult 接 口 的 对 象 作为 其 唯一 的 参数 。 

让 我 们 看 看 男 一 个 例子 。 假 设 读者 定义 了 一 个 可 以 指向 任何 方法 、 返 回 ! 个 字符 串 、 接 受 3 个 布尔 
输入 参数 的 委托 类 型 . 

public delegate string MyDelegate(bool a, bool b, bool c); 

这 一 次 ， 自 动产 生 的 类 分 解 如 下 : 

sealed class MyDelegate : System.MulticastDelegate 


public string Invoke(bool a, bool b, bool c); 

public IAsyncResult BeginInvoke(bool a, bool b, bool c， 
AsyncCallback cb, object state); 

public string EndInvoke(IAsyncResult result); 


委托 还 可 以 指向 包含 任意 数量 out 或 ref 参 数 ( 以 及 用 params 关 键 字 标记 的 数组 参数 ) 的 方法 。 例 
如 ， 假 设 有 委托 类 型 如 下 : 

public delegate string MyOtherDelegate(out bool a, ref bool b, int c); 

Invoke() 与 BeginInvoke() 方 法 的 签名 将 不 出 所 料 , 但 EndInvoke() 方 法 稍 有 变化 ， 其 中 包括 委托 类 
型 定义 的 所 有 的 out/ref 参 数 : 

Eo sealed class MyOtherDelegate : System.MulticastDelegate 


public string Invoke(out boo7 a, ref poo7 b, int oo); 
public IAsyncResult BeginInvoke(out bpoo7 a, ref bool b, int c, 
AsyncCallback cb, object state); 
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public string EndInvoke(out bpoo7 a, ref bool b, IAsyncResult result); 


综 上 所 述 ，C# 委 托 类 型 定义 会 生成 一 个 密封 类 ， 它 含有 3 个 编译 器 生成 的 方法 ， 这 3 个 方法 的 参数 
与 返回 值 基于 委托 的 声明 。 下 面 这 段 伪 代 码 说 明了 这 个 基本 模式 : 


// 这 只 是 伪 代 码 
public sealed class DelegateName : System.MulticastDelegate 


public delegateReturnValue Invoke(allDelegateInputRefAndOutParams); 


public IAsyncResult BeginInvoke(allDelegateInputRefAndOutParams, 
AsyncCallback cb, object state); 


public delegateReturnValue EndInvoke(allDelegateRefAndOutParams, 
IAsyncResult result); 
} 


10.1.2 System.MulticastDelegate 与 System.Delegate 基 类 


使 用 C# 中 delegate 关 键 字 创建 委托 的 时 候 ， 也 就 间接 声明 了 一 个 派生 自 System.Multicast- 
Delegate 的 类 。 这 个 类 使 其 继承 类 可 以 访问 包含 由 委托 对 象 维护 的 方法 地 址 的 列表 以 及 一 些 处 理 调用 
列表 的 附加 方法 (与 少数 重 载 的 操作 符 )。 下 面 是 System.MulticastDelegate 的 部 分 成 员 : 


public abstract class MulticastDelegate : Delegate 
{ 
// 返回 所 指向 的 方法 列表 
public sealed override Delegate[] GetInvocationList(); 


// 重 载 的 操作 符 
public static bool operator ==(MulticastDelegate d1i, MulticastDelegate d2); 
public static bool operator !=(MulticastDelegate d1, MulticastDelegate d2); 


// 用 来 在 内 部 管理 委托 所 维护 的 方法 列表 
private IntPtr invocationCount; 
private object invocationlist; 


} 
System.MulticastDelegate 从 它 的 父 类 System.Delegate 继 承 了 更 多 功能 。 下 面 是 父 类 的 部 分 定义 : 


public abstract class Delegate : ICloneable, ISerializable 

{ 
// 与 函数 列表 交互 的 方法 
public static Delegate Combine(params Delegate[] delegates ) ; 
public static Delegate Combine(Delegate a, Delegate b); 
public static Delegate Remove(Delegate source, Delegate value); 
public static Delegate RemoveAll(Delegate source, Delegate value); 


// 重 载 的 操作 符 
public static bool operator ==(Delegate d1, Delegate d2); 
public static bool operator !=(Delegate d1, Delegate d2); 


// 扩展 委托 目标 的 属性 
public MethodInfo Method { get; } 
public object Target { get; } 
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要 记 住 ， 我 们 永远 不 会 直接 派生 自 这 些 基 类 ( 如 果 这 样 做 的 话 ， 会 有 编译 器 错误 )。 然 而 ， 如 果 
我 们 使 用 delegate 关 键 字 ， 就 间接 创建 一 个 类 ， 这 个 类 “是 ”MulticastDelegate。 表 10-1 列 举 了 所 有 
委托 类 型 都 共有 的 核心 成 员 。 


表 10-1 System.MulticastDelegate/System.Delegate 部 分 成 员 


继承 成 员 作 用 

Method 此 属性 返回 System.Reflection.MethodInfo 对 象 ， 用 以 表示 委托 维护 的 静态 方法 的 详细 信息 

Target 如 果 方 法 调用 是 定义 在 对 象 级 别 的 ( 而 不 是 静态 方法 ) ，Target 返 回 表 示 委 托 维护 的 方法 的 对 
象 。 如 果 Target 返 回 值 为 nul1， 调 用 的 方法 是 一 个 静态 成 员 

Combine() 此 静态 方法 给 委托 维护 的 列表 添加 一 个 方法 。 在 C# 中 , 使 用 重 载 += 操 作 符 作为 简化 符号 调用 此 方法 

GetInvocationList() ”此 方法 返回 一 个 System.Delegate 类 型 的 数组 ， 其 中 数组 中 的 每 个 元 素 都 表示 一 个 可 调用 的 特 
定 方法 

Remove() 这 些 静 态 方法 从 调用 列表 中 移 除 一 个 (或 所 有 ) 方法 。 在 C# 中 ，Remove() 方 法 可 通过 使 用 重 载 

RemoveAll() -= 操作 符 来 调用 


10.2 最 简单 的 委托 示例 


初次 接触 委托 可 能 感觉 很 难 。 不 要 紧张 ， 接 下 来 ， 让 我 们 看 一 个 非常 简单 的 使 用 Binary0p 委 托 的 
示例 ， 我 们 以 前 见 过 ， 这 是 一 个 名 为 SimpleDelegate 的 控制 台 应 用 程序 项 目 。 下 面 是 完整 的 代码 和 代 
码 分 析 : 


namespace SimpleDelegate 


// 这 个 委托 可 以 指向 任何 传 入 两 个 整数 并 返回 一 个 整数 的 方法 
public delegate int BinaryOp(int x, int y); 


// 这 个 类 包含 了 Binary0p 将 指向 的 方法 
public class SimpleMath 


public static int Add(int x, int y) 
{ return x + y; } 


public static int Subtract(int x, int y) 
{ return x - y; } 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** Simple Delegate Example *****\n"); 


// 创建 一 个 指向 SimpleMath.Add() 方 法 的 Binary0p 对 象 
BinaryOp b = new BinaryOp(SimpleMath.Add); 


// 使 用 委托 对 象 间接 调用 Add() 方 法 
Console.WriteLine("10 + 10 is {0}", b(10, 10)); 
Console.ReadLine(); 
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还 要 注意 的 是 Binary0p 委 托 类 型 声明 的 格式 ， 它 指向 任何 一 个 带 有 两 个 整数 参数 并 返回 一 个 整数 
的 方法 。 因 此 ， 我 们 可 以 创建 一 个 名 为 SimpleMath 的 类 ， 其 中 定义 了 两 个 完全 匹配 Binary0p 委 托 定义 
模式 的 静态 方法 。 

如 果 要 将 目标 对 象 方法 插入 指定 委托 对 象 ， 只 要 向 委托 的 构造 函数 传人 方法 名 称 即 可 。 


// 创建 指向 SimpleMath.Add() 的 Binary0p 委 托 对 象 
BinaryOp b = new BinaryOp(SimpleMath.Add); 


这 时 ,我 们 可 以 使 用 类 似 直 接 函 数 调用 的 语法 调用 指向 成 员 : 


// Invoke() 在 这 里 被 调用 了 
Console.WriteLine("10 + 10 is {0}", b(10, 10)); 


在 底层 ， 运 行 库 实际 上 在 MulticastDelegate 派 生 类 上 调用 了 编译 器 生成 的 Invoke() 方 法 。 读 者 可 
以 通过 在 ildasm.exe 中 打开 程序 集 ， 观 察 Main() 函 数 中 的 CIL 代 码 自己 进行 验证 : 


.method private hidebysig static void Main(string[] args) cil managed 


callvirt instance int32 SimpleDelegate.BinaryOp::Invoke(int32, int32) 


} 
尽管 C# 不 需要 我 们 在 代码 库 中 显 式 调用 Invoke()， 但 是 我 们 也 完全 可 以 这 么 做 。 因 此 ， 如 下 代码 
语句 是 可 行 的 : 


Console.WritelLine("10 + 10 is {0}", b.Invoke(10, 10)); 
.NET 委 托 是 类 型 安全 的 。 所 以 如 果 读 者 试图 将 一 个 不 “匹配 模式 ”的 方法 传人 委托 ， 将 会 收 到 编 
译 需 错误 。 人 例如， 假定 SimpleMath 类 定义 了 另外 一 个 名 为 SquareNumber() 的 方法 ( 它 的 输入 参数 为 
整数 ); 


public class SimpleMath 


public static int SquareNumber(int a) 
{ returna* a; } 


由 于 Binary0p 委 托 仅 可 指向 带 有 两 个 整数 参数 并 返回 一 个 整数 的 方法 ， 下 面 这 段 代码 是 非法 的 ， 
将 无 法 编译 : 


// 编译 器 错误 ! 方 法 不 匹配 委托 的 模式 
BinaryOp b2 = new BinaryOp(SimpleMath.SquareNumber); 


委托 对 象 

让 我 们 在 Program 类 中 创建 一 个 名 为 DisplayDelegateInfo() 的 静态 方法 来 丰富 当前 的 示例 。 这 个 方 
法 将 输出 由 传 入 的 委托 类 型 所 维护 的 方法 的 名 称 和 定义 该 方法 的 类 的 名 称 。 我 们 通过 迭代 由 
GetInvocationList() 返 回 的 System.Delegate 数 组 ， 调 用 每 个 对 象 的 Target 和 Method 属 性 : 

static void DisplayDelegateInfo(Delegate del0bj) 


// 输出 委托 调用 列表 中 每 个 成 员 的 名 称 
foreach (Delegate d in del0bj.GaetInvocationList()) 
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Console.WriteLine("Method Name: {0}", d.Method); 
Console.WriteLine("Type Name: {0}", d.Target); 


} 
假定 你 已 经 修改 了 Main() 方 法 来 调用 这 个 新 的 辅助 方法 : 


BinaryOp b = new BinaryOp(SimpleMath.Add); 
DisplayDelegateInfo(b); 


将 会 得 到 如 下 所 示 的 输出 结果 : 





****** Simple Delegate Example **** 闪 
Method Name: Int32 Add(Int32, Int32) 


Type Name: 
10 + 10 is 20 





请 注意 SimpleMath 类 型 的 名 称 现在 并 没有 被 Target 属 性 显示 。 这 是 因为 我 们 的 Binary0p 委 托 指向 
静态 方法 , 所 以 没有 对 象 被 引用 ! 而 如 果 修 改 Add() 和 Subtract() 方 法 为 非 静态 的 ( 删除 static 关 键 字 )， 
将 能 创建 simpleMath 类 的 一 个 实例 ， 并 按照 如 下 所 示 通 过 对 象 引用 来 指定 调用 的 方法 : 

static void Main(string[] args) 

Console.WriteLine("***** Simple Delegate Example *****\n"); 
// .NET 委 托 也 可 以 指向 实例 方法 


SimpleMath m = new SimpleMath(); 
BinaryOp b = new BinaryOp(m.Add); 


// 显示 这 个 对 象 的 信息 
DisplayDelegateInfo(b); 


Console.WriteLine("10 + 10 is {0}", b(10, 10)); 
Console.ReadLine(); 


} 
这 样 ， 我 们 就 能 得 到 如 下 所 示 的 输出 结果 : 





***** Simple Delegate Example **** 闪 


Method Name: Int32 Add(Int32, Int32) 
Type Name: SimpleDelegate.SimpleMath 
10 + 10 is 20 





源 代码 ”SimpleDelegate 项 目的 源 代 码 位 于 Chapter 10 子 目录 下 。 


10.3 ”使 用 委托 发 送 对 象 状态 通知 
很 明显 ， 之 前 的 SimpleDelegate 示 例 是 纯粹 用 来 说 明 委托 作用 的 ， 因 为 仅 为 了 加 两 个 数 创建 一 个 
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委托 没有 多 大 必要 。 为 了 提供 更 现实 的 委托 应 用 ， 我 们 使 用 委托 来 定义 Car 类 ， 它 可 以 通知 外 部 实体 
当前 引擎 的 状态 。 下 面 是 我 们 要 进行 的 步骤 。 

(1) 定义 将 通知 发 送 给 调用 者 的 委托 类 型 。 

(2) 声明 Car 类 中 每 个 委托 类 型 的 成 员 变 量 。 

(3) 在 Car 上 创建 辅助 郴 数 使 调用 者 能 指定 由 委托 成 员 变 量 保存 的 方法 。 

(4) 修改 Accelerate() 方 法 以 在 适当 情形 下 调用 委托 的 调用 列表 。 

首先 ， 新 建 一 个 叫 CarDelegate 的 控制 台 应 用 程序 。 现 在 ， 按 如 下 所 示 定 义 Car 类 : 


public class Car 


// 内 部 状态 数据 

public int CurrentSpeed { get; set; } 
public int MaxSpeed { get; set; } 
public string PetName { get; set; } 


// 汽车 能 用 还 是 不 能 用 
private bool carIsDead; 


// 类 构造 函数 
public Car() { MaxSpeed = 100; } 
public Car(string name, int maxSp, int currSp) 


CurrentSpeed = currSp; 
MaxSpeed = maxSp; 
PetName = name; 


} 
现在 ， 考虑 如 下 对 Car 类 的 更 新 ， 它 强调 了 前 面 3 点 : 


public class Car 


// 1) 定义 委托 类 型 
public delegate void CarEngineHandler(string msgForCaller); 


// 2) 定义 每 个 委托 类 型 的 成 员 变 量 


private CarEngineHandler listOfHandlers; 


// 3) 向 调用 者 添加 注册 函数 
public void RegisterWithCarEngine(CarEngineHandler methodToCall) 


{ 
listOfHandlers = methodToCall; 


} 

注意 ， 本 例 中 我 们 直接 在 car 类 作用 域 里 定义 委托 类 型 。 浏 览 基础 类 库 时 会 发 现 ， 将 委托 定义 在 
使 用 它 的 类 型 作用 域 里 是 很 普遍 的 。 委 托 类 型 carEngineHandler 指 向 的 方法 只 有 一 个 字符 串 型 的 输入 
参数 ， 返 回 值 为 void。 

下 一 步 ,注意 我 们 声明 了 一 个 私有 成 员 变 量 ( 名 为 listofHandlers ) 和 一 个 辅助 函数 ( RegisterWith- 
CarEngine() )， 从 而 使 客户 端 能 给 委托 调用 列表 添加 方法 。 
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说 明 严格 地 说 ， 我 们 可 以 将 委托 成 员 变量 定义 为 公共 的 ， 这 样 就 不 需要 创建 额外 的 注册 方法 。 然 
而 ， 如 果 将 委托 成 员 定义 为 私有 的 ， 我 们 就 强制 了 封装 服务 并 提供 了 更 类 型 安全 的 解决 方案 。 
在 研究 C# event 关 键 字 的 时 候 ， 我 们 会 再 次 讨论 公共 委托 成 员 变 量 的 风险 。 


在 这 里 ,我 们 需要 创建 Accelerate() 方 法 。 记 住 ， 这 里 我 们 需要 使 Car 对象 向 订阅 者 发 送 引擎 相关 
的 消息 。 更 新 如 下 : (代码 也 有 不 同 ) 


// 4) 实现 Accelerate() 方 法 以 在 某 些 情况 下 调用 委托 的 调用 列表 
// 如 果 汽 车 不 能 用 了 ， 触 发 引爆 事件 
public void Accelerate(int delta) 


// If this car is "dead," send dead message. 
if (carIsDead) 


if (listOfHandlers != null) 
listofHandlers("Sorry, this car is dead..."); 


} 


else 
CurrentSpeed += delta; 


// 快 不 能 用 了 吗 
if (10 == (MaxSpeed - CurrentSpeed) 
&& listOfHandlers != null) 


listOofHandlers("Careful buddy! Gonna blow!"); 


if (CurrentSpeed >= MaxSpeed) 
carIlsDead = true; 
else 
Console.WriteLine("CurrentSpeed = {0}", CurrentSpeed); 


} 

要 注意 在 我 们 调用 1istofHandlers 成 员 变 量 保存 的 方法 之 前 ， 需 要 检查 该 变量 是 否 是 空 值 。 原 因 
在 于 通过 调用 RegisterwithCarEngine() 辅 助 方法 分 配 这 些 对 象 是 调用 者 的 任务 。 如 果 调 用 者 没有 调用 
这 个 方法 而 我 们 试图 调用 委托 调用 列表 , 将 在 运行 时 触发 一 个 引用 为 空 异常 (NullReferenceException ) 
并 使 程序 失败 (很 明显 ， 那 非常 糟糕 ) 现在 我 们 有 了 委托 构造 ， 下 面 来 看 修改 后 的 Program 类 : 


class Program 
static void Main(string[] args) 
Console.WriteLine("***** Delegates as event enablers *****\n"); 


// 首先 ， 创 建 一 个 Car 对 象 
Car c1 = new Car("SlugBug", 100, 10); 


// 现在 ， 告诉 汽车 ， 它 想 要 向 我 们 发 送信 息 时 调用 哪个 方法 
c1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent)); 


// 加 速 (这 将 触发 事件 ) 
Console.WriteLine("***** Speeding UP *****"); 
for (int i = 0; i < 6; i++) 
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c1.Accelerate(20); 
Console.ReadLine(); 


// 要 传 入 事件 的 方法 
public static void OnCarEngineEvent(string msg) 


Console.WriteLine("\n***** Message From Car Object *****"); 


Console.WriteLine("=> {0}", msg); 
Console .WriteLine("* 六 六 本 闵 冰 六 来 闵 六 六 闲 闵 冰 闵 冰冰 六 六 六 六 本 浆 素 六 来 六 来 六 闵 六 六 冰冰 \n”) 3 


} 

} 

Main() 方 法 首先 新 建 了 一 个 car 对象。 由 于 我 们 对 引擎 事件 感 兴趣 ,所 以 下 一 步调 用 自 定义 的 注册 
函数 RegisterWithCarEngine()。 注 意 ， 该 方法 要 求 传人 一 个 内 艇 的 CarEngineHandler 委 托 的 实例 ， 与 
其 他 委托 一 样 ， 我 们 指定 一 个 “所 指向 的 方法 ”作为 构造 函数 的 参数 。 该 示例 的 关键 在 于 ， 所 讨论 的 
方法 位 于 Program 类 的 内 部 。 并 且 OnCarEngineEvent() 方 法 与 相关 的 委托 完全 匹配 ， 也 包含 string 类 型 
的 输入 参数 和 void 返回 类 型 。 考 虑 如 下 所 示 的 输出 结果 : 





***** Delegates as event enablers 六 冰冰 沙沙 


米 水 素 冰冰 Speeding up 六 六 玉米 闵 


CurrentSpeed = 30 
CurrentSpeed = 50 
CurrentSpeed = 70 


冰冰 冰冰 未 Message From Car Object ***** 


=> Careful buddy! Gonna blow! 
冰冰 六 六 米 米 冰冰 冰冰 六 冰冰 六 闵 冰冰 炒米 闵 闵 冰 闵 六 六 米 闵 冰 六 冰冰 六 六 冰冰 


CurrentSpeed = 90 


****** Message From Car Object ***** 


=> Sorry, this car is dead... 
玉米 闵 米 六 冰冰 闵 阔 闵 冰冰 六 六 六 冰冰 六 六 冰 米 闵 冰 闵 闵 冰冰 玉 冰 米 冰冰 冰冰 六 





10.3.1 支持 多 路 广播 


回想 一 下 ，.NET 委 托 内 置 支持 多 路 广播 。 换 句 话说 ,一 个 委托 对 象 可 以 维护 一 个 可 调用 方法 的 列 
表 而 不 只 是 单独 一 个 方法 。 给 一 个 委托 对 象 添 加 多 个 方法 时 ， 不 用 直接 分 配 ， 重 载 += 操 作 符 即 可 。 为 
使 car 类 支持 多 路 广播 ， 可 以 修改 RegisterWithCarEngine 方 法 ， 具 体 如 下 所 示 : 


public class Car 


// 现在 支持 多 路 广播 
// 注意 现在 我 们 正在 使 用 += 操 作 符 ， 而 不 是 赋值 操作 符 (=) 
public void RegisterWithCarEngine(CarEngineHandler methodToCall) 


listOfHandlers += methodToCall; 
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对 委托 对 象 使 用 += 操 作 符 时 ， 编 译 器 将 该 问题 转换 为 一 个 对 静态 Delegate.Combine() 方 法 的 调用 
(事实 上 ， 也 可 以 直接 调用 Delegate.Combine() 方 法 ， 不 过 使 用 += 操 作 符 是 更 简洁 的 选择 )。 思 考 一 下 
RegisterNithCarEngine() 方 法 的 CIL 实 现 : 


public void RegisterWithCarEngine( CarEngineHandler methodToCall ) 
if (listOfHandlers == null) 
listofHandlers = methodToCall; 


else 
Delegate.Combine(listOfHandlers, methodToCall); 


这 样 ， 调 用 者 就 可 以 为 同样 的 回调 注册 多 个 目标 对 象 了 。 这 里 , 第 二 个 处 理 程序 以 大 写 形式 打印 
传人 的 消息 ， 以 供 显 示 : 


class Program 
static void Main(string[] args) 
Console.Writeline("***** Delegates as event enablers *****\n"); 


// 首先 ， 创 建 Car 对 象 
Car c1 = new Car("SlugBug", 100, 10); 


// 为 通知 注册 多 个 目标 
cl1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent)); 
c1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent2)); 


// 加 如 (这 将 触发 该 事件 ) 

Console.WritelLine("***** Speeding up *****"); 

for (int i=0;ic< 6; i++) 
c1.Accelerate(20); 

Console.ReadLine(); 


// 现在 在 发 送 通知 信息 时 ，Car 类 将 调用 两 个 方法 
public static void OnCarEngineEvent(string msg) 


{ 


Console.WriteLine("\n***** Message From Car Object *****"); 


Console.WriteLine("=> {0}", msg); 
Console. WriteLine( 下 六 六 六 六 玉米 六 玉米 闵 米 玉米 闵 冰 六 六 六 六 六 六 六 六 六 六 六 六 玉米 闵 闵 冰冰 六 阔 \ ys 


} 


public static void OnCarEngineEvent2(string msg) 
Console.WriteLine("=> {0}", msg.ToUpper()); 
} } 
10.3.2 ”从 委托 的 调用 列表 中 移 除 成 员 
Delegate 类 还 定义 了 一 个 静态 Remove() 方 法 ， 人 允许 调用 者 动态 地 从 委托 对 象 的 调用 列表 中 移 除 方 
法 。 这样, 调用 者 就 可 以 在 运行 时 简单 地 “ 退 订 ” 某 个 已 知 的 通知 。 你 可 以 直接 在 代码 中 调用 Delegate， 


Remove(), 不 过 C# 开 发 者 可 以 使 用 -= 操作 符 作为 简写 方式 ,为 Car 类 添加 新 的 方法 ,允许 调用 者 从 调用 
列表 中 移 除 某 个 方法 : 


298 第 10 章 委托 、 事 件 和 Lambda 表 达 式 
public class Car 


public void UnRegisterWithCarEngine(CarEngineHandler methodToCall) 
listOfHandlers -= methodToCall; 
y ; 
这 样 改 完 Car 类 之 后 ， 再 按 如 下 代码 修改 Main() ， 就 可 以 让 第 二 个 处 理 程 序 停止 接收 引擎 通知 : 
static void Main(string[] args) 
Console.WritelLine("***** Delegates as event enablers *****\n"); 


// 首先 ， 创 建 Car 对 象 
Car c1 = new Car("SlugBug", 100, 10); 
c1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent)); 


// 先 绑 定 委托 对 象 ， 稍 后 再 注销 
Car.CarEngineHandler handler2 = new Car.CarEngineHandler(OnCarEngineEvent2); 
c1.RegisterWithCarEngine(handler2); 


// 加 速 (将 触发 事件 ) 

Console.WriteLine("***** Speeding up *****"); 

for (int i = 0; i < 6; i++) 
c1.Accelerate(20); 


// 注销 第 二 个 处 理 程序 

cl1.UnRegisterWithCarEngine(handler2); 

// 看 不 到 大 写 的 消息 了 

Console.WriteLine("***** Speeding UP *****"); 

for (int i = 0; i < 6; i++) 
c1.Accelerate(20); 


Console.ReadLine(); 


Main() 方 法 中 的 一 处 不 同 是 ， 我 们 创建 了 Car.CarEngineHandler 对 象 ， 并 将 它 保存 在 本 地 变量 中 ， 
这 样 就 可 以 使 用 该 对 象 在 后 面 注销 通知 。 在 第 二 次 对 Car 对 象 进行 加 速 的 时 候 ， 就 看 不 到 大 写 的 传人 
消息 了 ， 因 为 我 们 已 经 在 委托 列表 中 移 除了 这 个 目标 。 | 


源 代码 ”CarDelegate 项 目的 源 代 码 位 于 Chapter 10 子 目录 下 。 


10.3.3 ”方法 组 转换 语 ; 
在 CarDelegate 这 个 示例 中 ， 我 们 显 式 地 创建 了 Car.CarEngineHandler 委 托 对 象 的 实例 ， 以 注册 和 
注销 引擎 通知 : 
static void Main(string[] args) 
Console.WritelLine("***** Delegates as event enablers *****\n"); 


Car c1 = new Car("SlugBug", 100, 10); 
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c1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent)); 


Car.CarEngineHandler handler2 = 
new Car.CarEngineHandler(OnCarEngineEvent2); 
c1.RegisterWithCarEngine(handler2); 


} 

当然 ， 如 果 要 调用 MulticastDelegate 或 Delegate 中 继承 的 任何 成 员 ， 手工 创建 一 个 委托 变量 是 最 
直接 的 方式 。 但 大 多 数 情况 下 ， 我 们 并 不 需要 依靠 委托 对 象 。 我 们 常常 使 用 委托 对 象 只 是 为 了 传递 作 
为 构造 函数 参数 的 方法 名 称 。 

为 了 简化 操作 ，C# 提 供 了 一 种 叫做 方法 组 转换 的 简便 方法 。 该 特性 允许 我 们 在 调用 以 委托 作为 参 
数 的 方法 时 直接 提供 方法 的 名 称 ， 而 不 用 创建 委托 对 象 。 


说 明 ”本 章 稍 后 将 使 用 方法 组 转换 语法 简化 C# 事 件 的 注册 。 


为 了 演示 这 一 特性 ， 新 建 一 个 Console Application， 取 名 为 CarDelegateMethodGroupConversion ， 
并 插入 在 CarDelegate 项 目 中 定义 的 Car 类 。 现 在， 考虑 下 面 的 Program 类 ， 使 用 方法 组 转换 来 注册 和 注 
销 引 擎 通知 : 


class Program 
static void Main(string[] args) 


Console.WritelLine("***** Method Group Conversion *****\n"); 
Car c1 = new Car(); 


// 注 册 简 单 的 方法 名 称 
c1.RegisterWithCarEngine(CallMeHere); 


Console.WriteLine("***** Speedjing up *****"); 
for (int i = 0; i «< 6; i++) 
c1.Accelerate(20); 


// 注 销 简单 的 方法 名 称 
c1.UnRegisterWithCarEngine(CallMeHere); 


// 没有 通知 
for (int i = 0; i < 6; i++) 
ci.Accelerate(20); 


Console.ReadLine(); 


static void CallMeHere(string msg) 
Console.WritelLine("=> Message from Car: {0}", msg); 
} 
} 
注意 , 我们 没有 直接 分 配 相 关 的 委托 对 象 , 而 是 简单 地 指定 了 与 委托 期 望 的 签名 相 匹 配 的 方法 ( 返 
回 void 并 且 以 string 为 参数 )。 要 知道 C# 编 译 器 仍然 能 确保 类 型 安 人 全。 因此， 如果 CallMeHere() 方 法 没 
有 string 参 数 或 没有 返回 void， 都 将 得 到 编译 器 错误 。 
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源 代码 ”CarDelegateMethodGroupConversion 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 





10.4 ” 泛 型 委托 

第 9 章 提 到 过 ，C# 人 允许 我 们 定义 泛 型 委托 类 型 。 例 如 ， 假 设 我 们 希望 定义 一 个 委托 类 型 来 调用 任 
何 返 回 void 并 且 接 受 单个 参数 的 方法 。 如 果 这 个 参数 可 能 会 不 同 ， 我 们 就 可 以 通过 类 型 参数 来 构建 。 
为 了 演示 ， 请 考虑 GenericDelegate 新 控制 台 应 用 程序 中 的 如 下 代码 : 

namespace GenericDelegate 


// 这 个 泛 型 委托 可 以 调用 任何 返回 void 并 接受 单个 参数 的 方法 
public delegate void MyGenericDelegate<T>(T arg); 


class Program 
static void Main(string[] args) 
Console.Writeline("***** Generic Delegates *****\n"); 


// 注册 目标 
MyGenericDelegate<string> strTarget = 

new MyGenericDelegate<string>(StringTarget); 
strTarget("Some string data"); 


MyGenericDelegate<int> intTarget = 

new MyGenericDelegate<int>(IntTarget); 
intTarget (9); 
Console.ReadLine(); 


} 
static void StringTarget(string arg) 


Console.WritelLine("arg in uppercase is: {0}", arg.ToUpper()); 


static void IntTarget(int arg) 
Console.Writeline("++arg is: {0}", ++arg); 


} 
} 


注意 ，MyGenericDelegatex<T> 定 义 了 一 个 类 型 参数 来 表示 要 传人 委托 目标 的 实 参 。 在 创建 这 个 类 
型 实例 时 , 我 们 需要 指定 类 型 参数 的 值 以 及 委托 将 调用 的 方法 的 名 称 。 因 此 , 如 果 指 定 了 字符 串 类 型 ， 
我 们 就 可 以 把 字符 串 值 传人 目标 方法 : 


// 创建 MyGenericDelegate<T> 的 实例 ， 使 用 字符 事 作 为 类 型 参数 
MyGenericDelegate<string> strTarget = 

new MyGenericDelegate<string>(StringTarget); 
strTarget("Some string data"); 


由 于 strTarget 对 象 的 格式 ，StringTarget() 方 法 现在 必须 接受 一 个 字符 串 作 为 参数 ， 
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static void StringTarget(string arg) 


Console.WritelLine("arg in uppercase is: {0}", arg.ToUpper()); 


源 代码 ”GenericDelegate 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 











泛 型 Action<> 和 Func<> 委 托 


我 们 已 经 从 本 章 看 到 ， 使 用 委托 在 应 用 程序 中 进行 回调 时 需要 遵循 以 下 步 又 ， 

口 自 定义 一 个 与 要 指向 的 方法 的 格式 相 匹 配 的 委托 ; 

口 创建 自 定义 委托 的 实例 ， 将 方法 名 作为 构造 函数 的 参数 ; 

口 通过 调用 委托 对 象 的 Invoke() 来 间接 调用 该 方法 。 

采用 这 种 方法 通常 会 构造 大 量 只 会 用 于 当前 任务 的 自 定 义 委 托 ( 如 MyGenericDelegate<T> 、 
CarEngineHandler 等 )。 尽管 有 时 候 需 要 为 项 目 定义 一 些 具备 独特 名 称 的 委托 , 但 也 有 了 时候 委托 名 无 关 
紧要 。 许 多 情况 下 ， 我 们 只 需要 接受 一 组 参数 并 返回 一 个 值 (或 void ) 的 委托 。 这 时 候 ， 我们 可 以 使 
用 框架 内 置 的 Actionk> 和 Func<> 委 托 。 为 了 演示 它们 的 用 途 ， 新 建 一 个 名 为 ActionAndFuncDelegates 的 
Console Application 项 目 。 

泛 型 Action<> 委 托 定义 在 mscorlib.d11 和 System.Core.dll 中 的 System 命名 空间 中 。 它 们 可 以 指向 多 至 
16 个 参数 ( 应 该 够 了 吧 ! ) 并 返回 void 的 方法 。 由 于 Actionk> 是 泛 型 委托 ， 因 此 还 需要 指定 各 个 参数 的 
基础 类 型 。 

更 新 Program 类 ， 新 建 一 个 接受 3 个 不 同 参数 的 静态 方法 : 

// Action<> 委 托 的 一 个 目标 


static void DisplayMessage(string msg, ConsoleColor txtColor, int printCount) 


// 设置 命令 行文 本 的 颜色 
ConsoleColor previous = Console.ForegroundColor; 
Console.ForegroundColor = txtColor; 





for (int i = 0; i «< printCount; i++) 
Console.WritelLine(msg); 

// 重 置 颜色 

Console.ForegroundColor = previous; 


} 


现在 ， 要 把 程序 流传 递 给 DisplayMessage() 方 法 ， 我 们 可 以 使 用 Action<> 委 托 ， 而 不 必 手 工 构建 
自 定义 委托 ， 如 下 所 示 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Action and Func *****"); 


// 使 用 Action<> 委 托 来 指向 DisplayMessage 
Action<string, ConsoleColor, int> actionTarget = 
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new Action<string, ConsoleColor, int>(DisplayMessage); 
actionTarget("Action Message!", ConsoleColor.Yellow, 5); 


Console.ReadLine(); 


如 你 所 见 ， 使 用 Actionk> 委 托 避 免 了 创建 自 定义 委托 的 烦恼 。 但 它 只 能 指向 返回 void 的 方法 。 如 
果 要 指向 具有 返回 值 的 方法 ( 同时 又 不 想 编写 自 定 义 委 托 )， 可 以 使 用 Func<>。 

泛 型 Func<> 委 托 可 以 指向 多 至 16 个 参数 ( 和 Action<> 一 样 ) 并 具有 自 定义 返回 值 的 方法 。 为 了 演 
示 ， 在 Program 类 中 添加 如 下 所 示 的 新 方法 : 


// Func<> 委 托 的 目标 
static int Add(int x，int y) 
{ 


return x + y; 


本 章 前 面 构 建 了 一 个 自 定义 的 Binary0p 委 托 ， 用 来 指向 加 减法 方法 。 不 过 ， 我 们 可 以 使 用 包含 3 
个 类 型 参数 的 Func<> 版 本 来 简化 我 们 的 工作 。 注 意 Func<> 的 最 后 一 个 类 型 参数 总 是 方法 的 返回 值 。 为 
了 巩固 这 一 点 ， 假 设 Program 类 还 定义 了 下 面 的 方法 : 

static string SumToString(int x, int y) 


return (x + y).ToString(); 


现在 ，Main() 方 法 可 以 调用 这 两 个 方法 ， 如 下 所 示 : 


Func<int，int，int> funcTarget = new Func<int, int, int>(Add); 
int result = funcTarget.Invoke(40, 40); 
Console.WritelLine("40 + 40 = {0}", result); 


Func<int, int, string> funcTarget2 = new Func<int, int, string>(SumToString); 
string sum = funcTarget2(90, 300); 
Console.WriteLine(sum); 


鉴于 Action<> 和 Func<> 节 省 了 手工 构建 自 定义 委托 的 步 又 , 你 可 能 想 知 道 是 否 应 该 总 是 使 用 它们 。 
和 许多 其 他 编程 问题 一 样 , 答案 是 “ 视 情 况 而 定 ”。 在 很 多 情况 下 Action<> 和 Func<> 都 是 首选 。 但 如 果 
你 觉得 一 个 具有 自 定 义 名 称 的 委托 更 有 助 于 捕获 问题 范畴 , 那么 构建 自 定义 委托 不 过 就 是 一 行 代码 的 
事 儿 。 在 本 书 剩余 部 分 你 将 会 看 到 这 两 种 方式 。 


说 明 很 多 重要 的 .NET API 大 量 使 用 了 Action<> 和 Func<> 委 托 ， 和 包括 并 行程 序 框架 和 LINQ 等 。 


我 们 对 于 .NET 委 托 类 型 的 初步 介绍 就 到 此 为 止 。 在 本 章 小 结 和 第 19 章 介绍 多 线程 和 异步 调用 时 还 
会 涉及 委托 的 一 些 其 他 细节 。 下 面 ， 我 们 来 看 看 C# event 关 键 字 。 


源 代 码 ”ActionAndFuncDelegates 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 
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10.5”C# 事 件 


委托 确实 是 一 个 有 趣 的 结构 ， 它 允许 内 存 中 的 对 象 进行 双向 对 话 。 然 而 ， 你 可 能 会 同意 ， 从 头 使 
用 委托 会 有 一 些 重复 代码 ( 定义 委托 , 声明 必要 的 成 员 变 量 以 及 创建 自 定义 的 注册 /注销 方法 来 保护 封 
装 等 ) 。 

除了 时 间 之 外 ,这 样 使 用 委托 来 作为 应 用 程序 的 回调 机 制 会 有 另 一 个 问题 : 如 果 我 们 没有 把 委托 
成 员 变量 定义 为 私有 的 ， 调 用 者 就 可 以 直接 访问 委托 对 象 。 这 样 ， 调 用 者 就 可 以 把 变量 重新 赋值 为 新 
的 委托 对 象 ( 实际 上 ， 也 就 删除 了 当前 要 调用 的 方法 列表 ) ， 更 糟糕 的 是 ， 调 用 者 可 以 直接 调用 委托 
的 调用 列表 。 为 了 说 明 这 个 问题 ， 考 虑 对 之 前 CarDelegate 实 例 的 改写 ( 和 简化 ) : 


public class Car 
public delegate void CarEngineHandler(string msgForCaller); 


// 这 是 一 个 公共 成 员 
public CarEngineHandler 1istOfHandlers; 


// 触发 分 解 的 通知 
public void Accelerate(int delta) 


{ 
if (listOfHandlers != null) 
listOofHandlers("Sorry, this car is dead..."); 
} 
} 


注意 , 我 们 不 再 有 使 用 自 定义 的 注册 方法 封装 的 私有 委托 成 员 变 量 。 因为 这 些 成 员 确实 是 公共 的 ， 
调用 者 可 以 直接 访问 listofHandlers 成 员 变 量 ， 把 这 个 类 型 重新 分 配给 新 的 CarEngineHandler 对 象 并 
且 随 时 调用 委托 : 
class Program 
static void Main(string[] args) 


Console.WriteLine("***** Agh! No Encapsulation! *****\n"); 

// 创建 一 个 Car 

Car myCar = new Car(); 

// 我 们 可 以 直接 访问 委托 

myCar.listOfHandlers = new Car.CarEngineHandler(CallWhenExploded); 
myCar.Accelerate(10); 


// 现在 可 以 赋值 一 个 全 新 的 对 象 
myCar.listOfHandlers = new Car.CarEngineHandler(CallHereToo); 
myCar.Accelerate(10); 


// 调用 者 还 可 以 直接 调用 委托 
myCar.listOfHandlers.Invoke("hee, hee, hee..."); 
Console.ReadLine(); 


} 


static void CallWhenExploded(string msg) 
{ Console.WriteLine(msg); } 


static void CallHereToo(string msg) 
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{ Console.WriteLine(msg); } 


公共 的 委托 成 员 打 破 了 封装 ， 不 仅 会 导致 代码 难以 维护 和 调试 ， 还 会 导致 应 用 程序 的 安全 风险 ! 
当前 的 示例 的 输出 结果 如 下 所 示 : 





****** Agh! No Encapsulation! ***** 


Sorry, this car is dead... 
Sorry, this car is dead... 
lie WY hee.. 





显然 ,我 们 不 希望 给 其 他 应 用 程序 改变 委托 指向 的 权力 以 及 没有 我 们 的 许可 直接 调用 成 员 的 权力 。 


源 代码 ”PublicDelegateProblem 项 目的 源 代 码 位 于 Chapter 10 子 目录 下 。 


10.5.1 event 关 键 字 


为 了 简化 自 定义 方法 的 构建 来 为 委托 调用 列表 增加 和 删除 方法 ，C# 提 供 了 event 关 键 字 。 在 编译 
器 处 理 event 关 键 字 的 时 候 ， 它 会 自动 提供 注册 和 注销 方法 以 及 任何 必要 的 委托 类 型 成 员 变量 。 这 些 
委托 成 员 变 量 总 是 声明 为 私有 的 ， 因 此 不 能 直接 从 触发 事件 的 对 象 访问 它们 。 可 以 肯定 的 是 ，event 
关键 字 就 像 一 块 语法 糖 ， 只 是 节省 了 我 们 打字 的 时 间 。 

定义 一 个 事件 分 为 两 个 步骤 。 首 先 ， 我 们 需要 定义 一 个 委托 类 型 ， 它 包含 在 事件 触发 时 将 要 调用 
的 方法 。 其 次 ， 通 过 C# event 关 键 字 用 相关 委托 声明 这 个 事件 。 

为 了 演示 event 关 键 字 ， 创 建 一 个 新 的 控制 台 应 用 程序 CarEvents。 在 Car 类 的 迭代 中 会 定义 
AboutToBlow 和 Exploded 这 两 个 事件 。 事 件 相 关联 的 委托 类 型 会 被 命名 为 CarEngineHandler。 下 面 是 对 
Car 类 的 第 一 次 修改 : 


public class Car 


// 这 个 委托 用 来 与 Car 的 事件 协作 
public delegate void CarEngineHandler(string msg); 


// 这 种 汽车 可 以 发 送 这 些 事件 
public event CarEngineHandler Exploded; 
public event CarEngineHandler AboutToBlow; 


es 

向 调用 者 发 送 一 个 事件 ,就 如 通过 名 称 和 相关 联 委托 定义 的 必需 参数 来 指定 事件 这 么 简单 。 为 确 
保 调 用 者 注册 事件 ,需要 在 调用 委托 的 方法 之 前 检查 这 个 事件 是 否 是 无 效 值 。 了 解 了 这 些 之 后 ， 下 面 
来 看 修改 后 的 Car 的 Accelerate() 方 法 : 


public void Accelerate(int delta) 


// 如 果 car 无 法 使 用 了 ， 触 发 Exploded 事 件 
if (carIsDead) 
{ 
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if (Exploded != null) 
Exploded("Sorry, this car is dead..."); 


else 


{ 
CurrentSpeed += delta; 


// 已 经 无 法 使 用 了 吗 
if (10 == MaxSpeed - CurrentSpeed 
&& AboutToBlow != null) 


AboutToBlow("Careful buddy! Gonna blow!"); 


// 还 好 着 呢 
if (CurrentSpeed >= MaxSpeed) 
CarIsDead = true; 
else 
Console.WriteLine("CurrentSpeed = {0}", CurrentSpeed); 


. 
} 
这 样 ， 我们 已 经 设 定 了 Car 对 象 发 送 两 个 自 定义 事件 ， 这 不 再 需要 定义 自 定义 注册 函数 ， 也 不 需 
要 声明 委托 成 员 变 量 。 稍 后 将 看 到 这 种 新 汽车 的 使 用 , 但 在 此 之 前 , 让 我 们 更 深入 考查 一 下 事件 的 架构 。 


10.5.2 ” 揭 开 事件 的 神秘 面纱 


C# 事 件 事实 上 会 扩展 为 两 个 隐藏 的 公共 方法 ， 一 个 带 add_ 前 级 ， 男 一 个 带 remove_ 前 级 。 前 级 后 
面 是 C# 事 件 的 名 称 。 例 如 ，Exploded 事 件 产生 两 个 隐藏 方法 ， 名 为 add_Exploded() 和 remove_ 
Exploded()。 查 看 add AboutToBlow() 的 CIL 指 令 ， 将 发 现 对 Delegate.Combine() 方 法 的 调用 。 考 虑 下 面 
的 部 分 CIL 代 码 : 


.method public hidebysig specialname instance void 
add AboutToBlow(class CarEvents.Car/CarEngineHandler ‘value') cil managed 


{ 


call class [mscorlib]System.Delegate 
[mscorlib]System.Delegate: :Combine( 
class [mscorlib]System.Delegate, class [mscorlib]System.Delegate) 


可 以 想到 ，remove_AboutToBlow() 方 法 将 间接 调用 Delegate.Remove() 方 法 : 


.method public hidebysig specialname instance void 
remove AboutToBlow(class CarEvents.Car/CarEngineHandler 'value') 
cil managed 


| call class [mscorlib]System.Delegate 
[mscorlib]System.Delegate: :Remove( 
class [mscorlib]System.Delegate, class [mscorlib]System.Delegate) 


最 后 ， 代 表 事 件 本 身 的 CIL 代 码 将 使 用 .addon 和 .removeon 指 令 对 应 要 调用 的 add_ XXX() 和 remove 
XXX() 方 法 的 名 称 : 
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.event CarEvents.Car/EngineHandler AboutToBlow 


.addon void CarEvents.Car::add AboutToBlow 
(class CarEvents.Car/CarEngineHandler) 


.removeon void CarEvents.Car::remove AboutToBlow 
(class CarEvents.Car/CarEngineHandler) 
} 


现在 我 们 已 经 了 解 了 如 何 构 建 一 个 能 够 发 送 C# 事 件 的 类 , 并 知道 事件 只 是 为 了 节省 键 和 时间， 下 
一 个 大 问题 就 是 如 何在 调用 者 这 边 监 听 传 入 的 事件 。 


10.5.3 监听 传 入 的 事件 


C# 事 件 也 简化 了 注册 调用 者 事件 处 理 程 序 的 操作 。 现 在 无 需 指定 自 定义 辅助 方法 , 调用 者 仅 需 使 
用 += 和 -= 操作 符 即 可 (操作 符 将 在 后 台 触 发 正确 的 add_XXX() 或 remove_XXX() 方 法 )。 注 册 一 个 事件 要 
遵循 以 下 模式 : 


// NameOfObject.NameOfEvent += new RelatedDelegate(functionToCall); 


// 
Car.EngineHandler d = new Car.CarEventHandler(CarExplodedEventHandler) 


myCar.Exploded += d; 
要 与 事件 源 断 开 时 ， 使 用 -= 操作 符 : 


// NameOfObject.NameOfEvent -= new RelatedDelegate(functionToCall); 
// 
myCar.Exploded -= di; 


由 于 有 这 些 固 定 的 模式 ,我 们 现在 使 用 C# 的 事件 注册 语法 修改 Main() 方 法 ， 如 下 所 示 : 
class Program 


static void Main(string[] args) 

{ 
Console.WritelLine("***** Fun with Events *****\n"); 
Car c1 = new Car("SlugBug", 100,10); 


// 注册 事件 处 理 程序 
C1.AboutToBlow += new Car.CarEngineHandler(CarIsAlmostDoomed); 
c1.AboutToBlow += new Car.CarEngineHandler(CarAboutToBlow); 


Car.CarEngineHandler d = new Car.CarEngineHandler(CarExploded); 
c1.Exploded += dj 


Console.WriteLine("***** Speeding UP *****"); 
for (int i = 0; i < 6; i++) 
c1.Accelerate(20); 


// 从 调用 列表 中 移 除 CarExploded 方 法 
c1.Exploded -= d; 


Console.WriteLine("\n***** Speeding UP *****"); 
for (int i = 0; i < 6; i++) 

c1.Accelerate(20); 
Console.ReadLine(); 
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public static void CarAboutToBlow(string msg) 
{ Console.WriteLine(msg); } 


public static void CarIsAlmostDoomed(string msg) 
{ Console.WriteLine("=> Critical Message from Car: {0}", msg); } 


public static void CarExploded(string msg) 
{ Console.WriteLine(msg); } 


} 
为 了 进一步 简化 事件 注册 ， 可 以 使 用 方法 组 转换 。 考 虑 下 面 的 Main() 方 法 : 


static void Main(string[] args) 


{ 


Console.WriteLine("***** Fun with Events *****\n"); 
Car c1 = new Car("SlugBug", 100, 10); 


// 注册 事件 处 理 程序 

C1.AboutToBlow += CarIsAlmostDoomed; 
C1.AboutToBlow += CarAboutToBlow; 
c1.Exploded += CarExploded; 


Console.WriteLine("***** Speeding Up *****"); 
for (int i = 0; i < 6; i++) 

c1.Accelerate(20); 
c1.Exploded -= CarExploded; 
Console.WriteLine("\n***** Speeding UP *****"); 


for (int i = 0; i < 6; i++) 
c1.Accelerate(20); 


Console.ReadLine(); 


10.5.4 ”使 用 Visual Studio 简 化 事件 注册 


Visual Studio 都 提供 了 协助 注册 事件 处 理 过 程 的 机 制 。 当 我 们 在 事件 注册 操作 中 应 用 += 操 作 符 时 ， 
将 看 到 一 个 IntelliSense 和 窗口 ， 提 示 我 们 按 Tab 键 来 自动 完成 相关 联 的 委托 实例 ( 如 图 10-2 所 示 )， 这 一 
过 程 可 使 用 方法 组 转换 语法 捕获 。 


0 CarEvents.prograrn ~ SH HookintoEventsO 
Console.ReadLine(); 本 








= public static void HookIntoEvents{() 
| { 
| Car newCar = new Car(); 
newCar .AboutToBlow + 四 RE 
二 | newCar_AboutToBlow: fpress TAB to insert) | 


y i i 人 生 全 


图 10-2 ”委托 选择 智能 感知 
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按 下 Tab 键 后 , IDE 提 示 键 入 要 创建 的 事件 处 理 程序 的 名 称 ( 也 可 以 接受 默认 的 名 称 ), 如 图 10-3 所 示 。 


Program.cs” 石 XX - 
Carfvents.Program ~ ® HookintoEvents0 

Console.ReadLine(); 二 

} 2 


public static void HookIntoEvents() 
{ 要 
ar newCar = new Car(); = 
newCar .AboutToBlow +=newCar AboutToBlow; = _ 和 
} | Press TAB to generate handier ‘newCar_AboutToBlow' in this class | 站 








图 10-3 ”委托 目标 对 象 格式 智能 感知 
如 果 再 次 按 Tab 键 ， IDE 将 以 委托 对 象 的 正确 格式 提供 存根 代码 ( 注意 ， 由 于 事件 被 注册 在 一 个 静 
态 方法 Main() 里 ， 所 以 这 个 方法 已 经 被 声明 为 静态 的 ): 


static void newCar AboutToBlow(string msg) 


// 在 这 里 添加 你 的 代码 
throw new NotImplementedException(); 


这 种 智能 感知 特性 可 用 于 基础 类 库 中 的 所 有 .NET 事 件 。 这 个 IDE 特 性 使 我 们 不 必 再 去 搜索 .NET 帮 
助 系统 来 断定 某 个 事件 要 使 用 的 正确 委托 和 委托 目标 对 象 的 正确 格式 ， 所 以 非常 节省 时 间 。 


源 代 码 ”CarEvents 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 


10.5.5 创建 自 定 义 的 事件 参数 


我 们 可 以 对 Car 类 做 最 后 一 步 改 进 ， 以 符合 微软 推荐 的 事件 模式 。 查 看 基础 类 库 中 某 个 类 型 发 送 
的 事件 时 ， 会 发 现 底 层 委 托 的 第 一 个 参数 是 一 个 system.0bject， 第 二 个 参数 是 一 个 派生 自 Systenm. 
EventArgs 的 子 类 型 。 

System.0bject 人 参数 表示 一 个 对 发 送 事件 的 对 象 ( 例如 Car 对 象 ) 的 引用 ， 第 二 个 参数 则 表示 与 该 
事件 相关 的 信息 。System.EventArgs 基 类 表示 一 个 不 发 送 任 何 自 定义 信息 的 事件 : 


public class EventArgs 


public static readonly EventArgs Empty; 
public EventArgs(); 


对 于 简单 的 事件 来 说 , 我 们 可 以 直接 传递 一 个 EventArgs 的 实例 。 但 如 果 要 传递 自 定义 数据 , 应 该 
构建 一 个 派生 自 EventArgs 的 类 。 在 这 个 示例 中 ,假定 我 们 有 一 个 名 为 CarEventArgs 的 类 ， 它 保存 一 个 
字符 串 ， 表 示 要 发 送 给 接收 者 的 信息 : 
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public class CarEventArgs : EventArgs 


public readonly string msg; 
public CarEventArgs(string message) 


{ 
msg = message; 

} 
这 样 ， 我 们 就 可 以 修改 CarEventHandler 委 托 了 ， 如 下 所 示 (事件 将 保持 不 变 ): 
public class Car 

public delegate void CarEngineHandler(object sender, CarEventArgs e); 
久 
当 在 Accelerate() 方 法 中 触发 我 们 的 事件 时 ， 需 要 提供 对 当前 Car 对 象 的 一 个 引用 ( 通过 this 关 键 

字 ) 和 CarEventArgs 类 型 的 一 个 实例 。 例 如 ， 考 虑 下 面 的 部 分 更 新 : 


public void Accelerate(int delta) 


// 如 果 Car 无 法 使 用 了 ， 触 发 Exploded 事 件 
if (carIsDead) 


if (Exploded != null) 
Exploded(this, new CarEventArgs("Sorry, this car is dead...")); 


对 于 调用 者 ， 我 们 要 做 的 就 是 修改 事件 处 理 程序 来 接收 传人 的 参数 ， 并 通过 只 读 字段 获取 消息 。 
例如 : 


public static void CarAboutToBlow(object sender, CarEventArgs e) 


Console.WriteLine("{0} says: {1}", sender, e.msg); 


如 果 接 收 者 想 与 发 送 事件 的 对 象 交 互 ， 我 们 可 以 显 式 强制 类 型 转换 System.0bject。 这 样 ， 就 可 以 
使 用 传递 给 事件 通知 对 象 中 的 任何 公共 成 员 : 


public static void CarAboutToBlow(object sender, CarEventArgs e) 


// 为 安全 起 见 ， 在 强制 类 型 转换 前 做 一 次 运行 时 检查 
if (sender is Car) 


Car 5 = (Car)sender; 
Console.WriteLine("Critical Message from {0}: {1}", c.PetName, e.msg); 


} 


源 代码 ”PrimAndProperCarEvents 项 目的 源 代 码 位 于 Chapter 10 子 目录 下 。 


10.5.6 ” 泛 型 EventHandler<T> 委 托 
由 于 很 多 自 定义 委托 接受 object 作 为 第 一 个 参数 ，EventArgs 派 生 类 型 作为 第 二 个 参数 , 我 们 可 以 
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通过 使 用 泛 型 EventHandler<T> 类 型 来 进一步 简化 之 前 的 示例 ， 其 中 T 就 是 自 定义 的 EventArgs 类 型 。 考 
虑 如 下 对 Car 类 型 的 更 新 ( 注意 我 们 不 再 需要 定义 一 个 自 定义 委托 类 型 ) : 


public class Car 


public event EventHandler<CarEventArgs> Exploded; 
public event EventHandler<CarEventArgs> AboutToBlow; 


i 
Main() 方 法 现在 就 可 以 在 之 前 定义 CarEventHandler 的 任何 地 方 使 用 EventHandler<CarEventArgs> 
(这 次 又 使 用 了 方法 组 转换 ): 


static void Main(string[] args) 
Console.WritelLine("***** PTim and Proper Events *****\n"); 


// 像 平常 一 样 创建 一 个 Car 
Car c1 = new Car("SlugBug", 100, 10); 


// 注册 事件 处 理 程序 
c1.AboutToBlow += CarIsAlmostDoomed; 
c1.AboutToBlow += CarAboutToBlow; 


EventHandler<CarEventArgs> d = new EventHandler<CarEventArgs> (CarExploded); 
c1.Exploded += dj 


太 好 了 ! 我 们 已 经 学 习 了 C# 委 托 和 事件 的 核心 部 分 。 这 些 信息 可 以 满足 所 有 回调 需求 , 不 过 在 本 
章 最 后 我 们 还 是 来 看 一 些 简化 方式 ， 特 别 是 匿名 方法 和 Lambda 表 达 式 。 





源 代码 ”PrimAndProperCarEvents( 泛 型 ) 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 


10.6 ”C# 匿 名 方法 


可 以 看 到 ， 当 一 个 调用 者 想 监听 传 进来 的 事件 时 ， 它 必须 定义 一 个 唯一 的 与 相关 联 委托 签名 匹配 
的 方法 ,例如 : 
class Program 
static void Main(string[] args) 
SomeType t = new SomeType(); 
// 假定 "SomeDelegate" 指 向 不 带 参 数 且 无 返回 值 的 方法 
t.SomeEvent += new SomeDelegate(MyEventHandler); 


} 


// 一 般 情况 下 ， 它 仅 被 SomeDelegate 对 象 调用 
public static void MyEventHandler() 


OE 
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思考 一 下 就 会 发 现 ，MyEventHandler() 这 样 的 方法 很 少 会 被 调用 委托 之 外 的 任何 程序 所 调用 。 从 
生产 效率 的 角度 来 说 ， 手 工 定 义 一 个 由 委托 对 象 调 用 的 方法 显得 有 点 烦琐 ， 不 会 很 受 欢 迎 。 

为 了 解决 这 一 情况 ， 现 在 可 以 在 事件 注册 时 直接 将 一 个 委托 与 一 段 代 码 相 关联 。 这 种 代码 的 正式 
名 称 为 匿名 方法 。 为 了 说 明 它 的 基本 语法 ,查看 下 面 的 Main() 方 法 , 它 使 用 匿名 方法 处 理 Car 类 发 送 的 
事件 ， 而 不 是 使 用 命名 的 事件 处 理 程序 : 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** Anonymous Methods *****\n"); 
Car c1 = new Car("SlugBug", 100, 10); 


// 注册 事件 处 理 程序 作为 匿名 方法 
c1.AboutToBlow += delegate 


Console.WritelLine("Eek! Going too fast!"); 
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c1.AboutToBlow += delegate(object sender, CarEventArgs e) 


Console.WriteLine("Message from Car: {0}", e.msg); 


2» 


c1.Exploded += delegate(object sender, CarEventArgs e) 


Console.WritelLine("Fatal Message from Car: {0}", e.msg); 


3》 


// 这 最 终 会 触发 事件 
for (int i = 0; i < 6; i++) 
c1.Accelerate(20); 


Console.ReadLine(); 


说 明 匿名 方法 中 最 后 一 个 大 括号 必须 以 分 号 结束 ， 否 则 ， 将 产生 一 个 编译 错误 。 





请 注意 , Program 类 型 不 用 再 定义 特定 的 静态 事件 处 理 程序 , 如 CarAboutToBlow() 或 是 CarExploded() 
了 。 未 命名 ( 即 匿名 ) 方法 将 在 调用 者 使 用 += 语 法 处 理事 件 时 被 内 联 定义 。 匿 名 方法 的 基本 语法 符合 
下 面 的 伪 代 码 : 


class Program 
static void Main(string[] args) 


SomeType t = new SomeType(); 
t.SomeEvent += delegate (optionallySpecifiedDelegateArgs) 
{ /* statements */ }; 
} 
} 


在 上 一 个 Main() 方 法 中 处 理 第 一 个 AboutToBlow 事 件 时 ， 注 意 没有 定义 委托 传递 的 参数 : 
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c1.AboutToBlow += delegate 


Console.WriteLine("Eek! Going too fast!"); 


3 


严格 来 讲 ， 我 们 不 需要 接收 由 指定 事件 发 送 的 传人 参数 。 但 如 果 想 使 用 可 能 传人 的 参数 ,需要 通 
过 委托 类 型 指定 参数 原型 ( 就 像 AboutToBlow 和 Exploded 事 件 的 第 二 个 处 理 程序 中 一 样 ) ， 例 如: 
c1.AboutToBlow += delegate(object sender, CarEventArgs e) 


Console.Writeline("Critical Message from Car: {0}", e.msg); 


访问 本 地 变量 


匿名 方法 非常 有 趣 ， 它 使 我 们 能 访问 定义 它们 的 方法 ( 称 为 定义 方法 ) 的 本 地 变量 。 这 些 变量 称 
为 匿名 方法 的 外 部 变量 。 有 关 匿 名 方法 作用 域 与 定义 方法 的 作用 域 之 间 的 交互 , 有 几 个 重要 的 知识 点 ， 
如 下 所 示 。 

口 匿名 方法 不 能 访问 定义 方法 中 的 ref 或 out 参 数 。 

口 匿名 方法 中 的 本 地 变量 不 能 与 外 部 方法 中 的 本 地 变量 重 名 。 

口 匿名 方法 可 以 访问 外 部 类 作用 域 中 的 实例 变量 (或 静态 变量 )。 

口 匿名 方法 内 的 本 地 变量 可 以 与 外 部 类 的 成 员 变 量 同名 ( 本 地 变量 的 作用 域 不 同 ， 可 以 隐藏 外 

部 类 的 成 员 变 量 )。 

假定 Main() 方 法 定义 了 一 个 局 部 的 整数 变量 aboutToBlowCounter。 在 处 理 AboutToBlow 事 件 的 匿名 方 
法 内 部 ， 计 数 右 每 次 增加 1 并 在 Main() 结 束 前 输出 点 数 : 

static void Main(string[] args) 


Console.WritelLine("***** Anonymous Methods *****\n"); 
int aboutToBlowCounter = 0; 


// 像 平常 一 样 生成 一 个 Car 
Car c1 = new Car("SlugBug", 100, 10); 


// 注册 事件 处 理 程序 作为 匿名 方法 
C1.AboutToBlow += delegate 


aboutToBlowCounter++; 
Console.WritelLine("Eek! Going too fast!"); 


和 
c1.AboutToBlow += (object sender, CarEventArgs e) 


aboutToBlowCounter++; 
Console.WriteLine("Critical Message from Car: {0}", e.msg); 


3 


Console.WritelLine("AboutToBlow event was fired {0} times.", 
aboutToBlowCounter); 
Console.ReadLine(); 
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如 果 读 者 运行 了 这 段 修改 后 的 Main() 方 法 ,将 发 现 最 后 Console.WriteLine() 报 告 ，AboutToBlow 事 
件 触发 了 两 次 。 








源 代码 ”AnonymousMethods 项 目的 源 代 码 位 于 Chapter 10 子 目录 下 。 











10.7 Lambda 表达 式 


在 讨论 NET 事件 架构 的 最 后 ， 我 们 来 讲述 C# 的 Lambda 表 达 式 。 在 本 章 前 面 已 经 解释 过 ，C# 支 持 
内 联 处 理事 件 ， 通 过 直接 把 一 段 代码 语句 赋值 给 事件 ( 使 用 匿名 方法 )， 而 不 是 构建 被 底层 委托 调用 
的 独立 方法 。Lambda 表 达 式 只 是 用 更 简单 的 方式 来 写 匿名 方法 ,彻底 简化 了 对 .NET 委 托 类 型 的 使 用 。 

为 了 对 Lambda 表 达 式 的 研究 做 准备 , 新 建 一 个 叫 SimpleLambdaExpressions 的 控制 台 应 用 程序 。 现 
在 ， 考 虑 泛 型 ListxT> 类 的 FindAl1() 方 法 。 当 你 需要 从 一 个 集合 中 提取 子 集 时 ， 可 以 使 用 该 方法 ， 其 
原型 如 下 : 


// System.Collections.Generic.List<T> 类 中 的 方法 
public List<T> FindAll(Predicate<T> match) 


如 你 所 见 ,该 方法 返回 新 的 ListxT> ,表示 数据 子 集 。 同 时 注意 FindAl1() 方 法 的 唯一 参数 是 一 个 System。 


Predicate<T> 类 型 的 泛 型 委托 。 该 委托 指向 任意 以 类 型 参数 作为 唯一 输入 参数 并 返回 bool 的 方法 : 


// FindAll() 方 法 使 用 该 委托 提取 子 集 
public delegate bool Predicate<T>(T obj); 


在 调用 FindAl1() 时 , List<T> 中 的 每 一 项 都 将 传人 Predicate<T> 对 象 所 指向 的 方法 ,方法 在 实现 时 
将 执行 一 些 计 算 , 来 判断 传 和 的 数据 是 否 符合 标准 ， 并 返回 true 或 false。 如 果 返 回 true, 该 项 将 被 添 
加 到 表示 子 集 的 新 List<T> 中 (明白 了 吗 )。 

在 学 习 Lambda 表 达 式 如 何 简化 FindAl1() 的 工作 前 ， 我 们 先 直 接 使 用 委托 对 象 这 种 普通 方法 。 在 
Program 类 型 中 添加 一 个 方法 TraditionalDelegateSyntax()， 它 与 System.Predicate<T> 类 型 交互 ， 找 出 
整数 List<cT> 中 的 偶数 。 


class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Lambdas *****\n"); 
TraditionalDelegateSyntax(); 


Console.ReadLine(); 


static void TraditionalDelegateSyntax() 
// 创建 整数 列表 


List<int> list = new Listcint>(); 
list.AddRange(new int[] { 20, 1, 4, 8, 9, 44 }); 


// 使 用 传统 委托 语法 调用 FindAl11() 
Predicate<int> callback = new Predicate<int>(IsEvenNumber); 
List<int> evenNumbers = list.FindAll(callback); 


314 第 10 章 委托 、 事 件 和 Lambda 表达 式 


Console.WritelLine("Here are .your even numbers:"); 
foreach (int evenNumber in evenNumbers) 


Console.Write("{0}\t", evenNumber); 


Console.WritelLine(); 


} 


// Predicate<> 委 托 的 目标 
static bool IsEvenNumber(int i) 


“证 放 汪 人 
return (i % 2) == 0; 
} 
在 这 里 ， 方 法 IsEvenNumber() 通 过 C# 的 取 模 操作 符 % 来 负责 检查 传人 的 整数 参数 是 偶数 还 是 奇数 。 
如 果 我 们 执行 应 用 程序 ， 就 会 发 现 20、4、8 和 44 被 输出 到 了 控制 台 上 。 
虽然 这 个 使 用 委托 的 传统 方式 可 以 像 预 期 那样 工作 ， 然 而 TsEvenNumber() 方 法 只 是 在 有 限 的 环境 
中 才 会 被 调用 。 而 且 ， 如 果 调 用 FindAl1() ， 就 需要 完整 的 方法 定义 。 如 果 我 们 使 用 匿名 方法 来 替代 ， 
代码 就 简洁 多 了 。 考 虑 如 下 Program 类 的 新 方法 : 
static void AnonymousMethodSyntax() 
// 建立 整数 列表 


List<int> list = new List<int>(); 
list.AddRange(new int[] { 20, 1, 4, 8, 9, 44 }); 


// 现在 使 用 匿名 方法 
List<int> evenNumbers = list.FindAll(delegate(int i) 
{ return (i % 2) == 0; } ); 


Console.WriteLine("Here are your even numbers:"); 
foreach (int evenNumber in evenNumbers) 


Console.Write("{0}\t", evenNumber); 


Console.WritelLine(); 


在 以 上 的 代码 中 , 我 们 并 不 是 首先 创建 一 个 Predicatex<T> 委 托 类 型 , 然后 编写 一 个 独立 方法 , 而 是 
使 用 了 一 个 匿名 方法 。 虽 然 这 是 正确 的 方向 ， 但 是 仍然 需要 使 用 关键 字 delegate ( 或 者 一 个 强 类 型 化 
的 Predicate<T> )， 而 且 还 需要 保证 输入 参数 百分之百 匹配 。 我 们 认为 ,定义 匿名 方法 的 语法 还 是 有 点 
宛 长 。 下 面 的 代码 可 以 更 好 地 说 明 这 个 问题 : 

List<int> evenNumbers = list.FindAll( 

delegate(int i) 
return (i % 2) == 0; 


尘 
我 们 可 以 使 用 Lambda 表 达 式 进一步 简化 对 FindA11() 方 法 的 调用 。 使 用 新 的 语法 时 ， 底 层 的 委托 
对 象 将 会 消失 得 无 影 无 踪 。 请 看 下 面 的 program 类 的 新 方法 : 


static void LambdaExpressionSyntax() 
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// 建立 一 个 整数 列表 
List<int> list = new List<int>(); 
list.AddRange(new int[] { 20, 1, 4, 8, 9, 44 }); 


// 现在 使 用 Lambda 表 达 式 
List<int> evenNumbers = list.FindAll(i => (i % 2) == 0); 


Console.WritelLine("Here are your even numbers:"); 
foreach (int evenNumber in evenNumbers) 


Console.Write("{0}\t", evenNumber); 


Console.WriteLine(); 


} 


我 们 将 奇怪 的 语句 传递 到 方法 FindA11() 中 ， 这 些 语句 其 实 就 是 Lambda 表 达 式 。 随 着 示例 代码 的 
更 新 ， 可 以 发 现 我 们 不 再 使 用 委托 Predicate<T> ( 或 者 关键 字 delegate )， 而 是 用 一 个 简短 的 Lambda 
表达 式 : i => (i % 2) == 0 了 。 

在 深入 了 解 表达 式 的 语法 前 ,我 们 需要 知道 Lambda 表 达 式 可 以 应 用 于 任何 匿名 方法 或 者 强 类 型 委 
托 可 以 应 用 的 场合 ， 而 且 比 匿名 方法 更 节省 编码 时 间 。 其 实 C# 编 译 器 只 是 把 表达 式 翻 译 为 使 用 委托 
Predicate<T> 的 标准 匿名 方法 而 已 (可 以 使 用 ildasm.exe 或 reflectorexe 进 行 验证 )， 如 下 面 的 代码 : 


// Lambda 表 达 式 
List<int> evenNumbers = list.FindAll(i => (i % 2) == 0); 


被 编译 进 下 面 的 C# 代 码 : 


// …… 变 成 了 匿名 方法 
List<int> evenNumbers = list.FindAll(delegate (int i) 


return (i % 2) == 0; 
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10.7.1 剖析 Lambda 表 达 式 


Lambda 表 达 式 是 这 样 编写 的 : 首先 定义 一 个 参数 列表 ,“=>” 标 记 ( 针对 Lambda 操 作 符 的 C# 标 记 
全 部 来 自 Lambda 演 算 ) 紧 随 其 后 ， 然 后 就 是 处 理 这 些 参 数 的 语句 。 从 更 高 的 级 别 讲 ，Lambda 表 达 式 
可 以 理解 为 : 

ArgumentsToProcess => StatementsToProcessThem 

如 果 不 使 用 LambdaExpressionsyntax() 方 法 ， 则 可 以 理解 为 : 

// "i" 就 是 我 们 的 参数 列表 

// (i % 2) == 0 就 是 处 理 "i" 的 表达 式 

List<int> evenNumbers = list.FindAll(i => (i % 2) == 0); 

Lambda 表 达 式 的 参数 既 可 以 是 显 式 类 型 化 的 ， 也 可 以 是 隐 式 类 型 化 的 。 现 在 ， 表 示 参 数 i 的 数据 
类 型 ( 整 型 ) 是 隐 式 类 型 化 的 。 编 译 器 可 以 根据 整个 Lambda 表 达 式 的 上 下 文 和 底层 委托 推断 出 i 是 一 
个 整 型 。 尽 管 如 此 ,我 们 也 可 以 显 式 定义 表达 式 的 每 一 个 参数 的 类 型 ， 如 下 用 括号 包围 数据 类 型 和 变 
量 名 即 可 : 
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// 现在 ， 我 们 显 式 定 义 参数 的 类 型 
List<int> evenNumbers = list.FindAll((int i) => (i % 2) == 0); 


你 可 能 已 经 发 现 , 如 果 一 个 Lambda 表 达 式 拥有 一 个 隐 式 类 型 化 的 参数 , 那么 参数 列表 中 的 括号 可 
以 被 省 略 。 如 果 想 以 一 致 的 方式 编写 Lambda 表 达 式 ， 那 么 你 仍然 可 以 使 用 括号 : 

List<int> evenNumbers = list.FindAll((i) => (i % 2) == 0); 

最 后 , 我们 并 没有 使 用 括号 包围 表达 式 ( 使 用 了 括号 包围 取 模子 表达 式 以 确保 它 先 于 相等 操作 符 
执行 )。Lambda 表 达 式 同样 允许 使 用 括号 包围 表达 式 ， 如 下 代码 : 


// 现在 ,我们 使 用 括号 包围 表达 式 
List<int> evenNumbers = list.FindAll((i) => ((i % 2) == 0)); 


至 此 你 已 经 看 到 了 编写 Lambda 表 达 式 的 多 种 方法 ,但 是 我 们 应 该 如 何 使 用 人 类 可 识别 的 语言 描述 
这 个 Lambda 语 句 呢 ? 请 看 〈 先 把 数学 术语 放 一 边 ): 


// 我 的 参数 列表 (一 个 整 型 i) 将 会 被 表达 式 (i % 2) == 0 处 理 
List<int> evenNumbers = list.FindAll((i) => ((i % 2) == 


10.7.2 ”使 用 多 个 语句 处 理 参 数 


我 们 的 第 一 个 Lambda 表 达 式 是 一 条 求 出 布尔 类 型 的 值 的 语句 ,但 是 我 们 知道 很 多 委托 目标 需要 执 
行 多 条 代码 语句 。 因 此 ，C# 人 允许 使 用 一 系列 代码 语句 来 定义 Lambda 表 达 式 。 当 表达 式 必须 使 用 多 行 
代码 处 理 参 数 时 ,你 可 以 使 用 一 对 花 括 号 确定 这 些 语句 的 范围 。 请 看 下 面 对 LambdaExpressionSyntax() 
方法 进行 更 新 的 代码 : 


static void LambdaExpressionSyntax() 


0)); 


// 创建 整 型 列表 
List<int> list = new List<int>(); 
list.AddRange(new int[] { 20, 1, 4, 8, 9, 44 }); 


// 现在 使 用 语句 块 编写 Lambda 表 达 式 
List<int> evenNumbers = list.FindAll((i) => 


Console.WritelLine("value of i is currently: {0}", i); 
bool isEven = ((i % 2) == 0); 
return isEven; 


2》 


Console.WritelLine("Here are your even numbers:"); 
foreach (int evenNumber in evenNumbers) 


Console.Write("{0}\t", evenNumber); 


Console.Writeline(); 


} 

现在 ,我 们 的 参数 列表 ( 整 型 i ) 被 一 系列 的 代码 语句 处 理 。 为 了 方便 阅读 ， 在 调用 Console. 
WriteLine() 之 后 ,我 们 把 取 模 操作 和 结果 返回 分 为 两 条 语句 。 假 设 每 个 方法 都 在 Main() 中 被 调用 : 

static void Main(string[] args) 


Console.Writeline("***** Fun with Lambdas *****\n"); 
TraditionalDelegateSyntax(); 
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AnonymousMethodSyntax(); 
Console.WriteLine(); 
LambdaExpressionSyntax(); 
Console.ReadLine(); 


} 


程序 输出 结果 如 下 所 示 : 
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currently: 20 
currently: 1 
currently: 4 
currently: 8 
currently: 9 
currently: 44 
even numbers: 
8 44 





源 代码 ”SimpleLambdaExpressions 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 





10.7.3 含有 多 个 (或 零 个 ) 参数 的 Lambda 表 达 式 


到 目前 为 止 ， 我 们 编写 的 Lambda 表 达 式 都 只 含有 一 个 参数 。 其 实 ，Lambda 表 达 式 可 以 处 理 多 个 
参数 或 者 不 提供 任何 参数 。 为 了 把 问题 说 明白 ,创建 一 个 新 的 控制 台 应 用 程序 LambdaExpressions- 
MultipleParams。 接 下 来 ,假设 simpleMath 有 如 下 更 新 : 

public class SimpleMath 


public delegate void MathMessage(string msg, int result); 
private MathMessage mmDelegate; 


public void SetMathHandler(MathMessage target) 
{mmDelegate 


= target; } 


public void Add(int x, int y) 


if (mmDelegate != null) 
mmDelegate.Invoke("Adding has completed!", x + y); 


} 


我 们 可 以 看 到 ， 委 托 MathMessage 需 要 两 个 参数 。 使 用 Lambda 表 达 式 的 Main() 如 下 所 示 : 


static void Main(string[] args) 


// 使 用 Lambda 表 达 式 注册 委托 
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SimpleMath m = new SimpleMath(); 
m.SetMathHandler((msg, result) => 
{Console.WriteLine("Message: {0}, Result: {1}", msg, result);}); 


// 执行 Lambda 表 达 式 
m.Add(10,10); 
Console.ReadLine(); 


这 里 , 为 了 简洁 并 没有 使 用 强 类 型 化 ， 因 此 需要 借助 类 型 推断 。 但 是 我 们 可 以 像 下 面 这 样 调用 方 
法 SetMathHandler(): 


m.SetMathHandler((string msg, int result) => 
{Console.WritelLine("Message: {0}, Result: {1}", msg, result);}); 


最 后 , 如 果 需 要 使 用 Lambda 表 达 式 与 一 个 没有 参数 的 委托 交互 , 可 以 使 用 空 括号 表示 表达 式 的 参 
数列 表 。 例 如 ， 假 设 我 们 定义 了 一 个 委托 类 型 : 

public delegate string VerySimpleDelegate(); 

你 可 以 这 样 处 理 调用 的 结果 : 

// 在 控制 台 输 出 "Enjoy your string!" 


VerySimpleDelegate d = new VerySimpleDelegate( () => {return "Enjoy your string!";} ); 
Console.WritelLine(d.Invoke()); 


源 代码 ”LambdaExpressionsMultipleParams 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 


10.7.4 使 用 Lambda 表 达 式 重新 编写 CarEvents 示 例 


推荐 使 用 Lambda 表 达 式 的 原因 是 它 为 我 们 提供 了 一 种 简洁 明了 的 方式 来 定义 匿名 方法 ( 因此 间接 
地 简化 了 关于 委托 的 编码 工作 )。 现 在 让 我 们 使 用 Lambda 表 达 式 重新 编写 第 10 章 的 PrimAndProper- 
CarEvents 项 目 。 下 面 是 项 目的 Program 类 的 简化 版 本 ， 它 使 用 Lambda 表 达 式 语法 ( 而 不 是 传统 的 委托 
语法 ) 挂 接 从 Car 对 象 发 送 的 每 个 事件 : 

static void Main(string[] args) 


Console.WritelLine("***** More Fun with Lambdas *****\n"); 


// 像 平常 一 样 创建 一 个 Car 对 象 
Car c1 = new Car("SlugBug", 100, 10); 


// 使 用 Lambda 表 达 式 挂 接 事 件 
c1.AboutToBlow += (sender, e) => { Console.Writeline(e.msg);}; 
c1.Exploded += (sender, e) => { Console.WriteLine(e.msg); }; 


// 加 速 (这 会 触发 事件 ) 
Console.WriteLine("\n***** Speeding UP *****"); 
for (int i = 0; i < 6; i++) 

c1.Accelerate(20); 


Console.ReadLine(); 
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至 此 , 我 希望 你 可 以 了 解 Lambda 表 达 式 的 整体 角色 和 它 是 如 何以 “函数 方式 ”与 匿名 方法 和 委托 
类 型 共同 工作 的 .尽管 你 可 能 需要 花 一 点 时 间 来 适应 新 的 Lambda 操 作 符 ( => ), 不 过 要 始终 记 住 Lambda 
表达 式 可 以 简化 为 如 下 简单 的 形式 : 

ArgumentsToProcess => StatementsToProcessThem 


需要 指出 的 是 ，LINQ 编 程 模型 使 用 了 许多 Lambda 表 达 式 来 简化 编码 。 第 12 章 将 会 探讨 LINQ。 


源 代码 ”CarEventsWithLambdas 项 目的 源 代码 位 于 Chapter 10 子 目录 下 。 


10.8 小结 


本 章 讨论 了 许多 可 以 让 多 个 对 象 共 同 参与 一 个 双向 对 话 的 方法 。 首 先 ， 我 们 讨论 了 C# delegate 
关键 字 ， 它 用 来 间接 构造 一 个 派生 自 System.MulticastDelegate 的 类 。 可 以 看 到 委托 对 象 保存 着 一 个 
方法 列表 ,可 以 在 需要 时 调用 这 些 方法 。 这 些 调用 可 能 是 同步 进行 的 (使 用 Invoke() 方 法 ), 也 可 能 是 
异步 的 (通过 BeginInvoke() 方 法 和 EndInvoke() 方 法 )。 还 要 说 明 的 是 ，.NET 委 托 类 型 的 异步 特性 在 
第 19 章 还 会 继续 介绍 。 

接 下 来 是 C#event 关 键 字 , 它 与 委托 类 型 一 起 使 用 , 可 以 简化 发 送 事 件 通知 到 调用 者 的 处 理 过 程 。 
通过 转换 成 的 CIL 可 以 看 出 ，.NET 事 件 模型 映射 为 对 System.Delegate/System.MulticastDelegate 类 型 
的 隐藏 调用 。 从 这 个 角度 来 说 ，C# event 关 键 字 纯粹 是 用 以 节省 键入 时 间 的 可 选 方案 。 

随后 ,本 章 讨论 了 一 个 称 为 匿名 方法 的 C# 语 言 特性 。 使 用 这 种 语法 构造 ， 可 以 直接 将 一 段 代码 与 
指定 事件 相关 联 。 我 们 已 经 看 到 ， 匿 名 方法 可 以 忽略 事件 发 送 的 参数 并 能 访问 定义 方法 的 外 部 变量 。 
最 后 我 们 讨论 了 一 种 注册 事件 的 简化 方法 一 一 使 用 方法 组 转换 。 

最 后 ， 我 们 研究 了 C# Lambda 操 作 符 =>。 这 个 语法 是 编写 匿名 方法 的 一 个 简化 形式 ， 可 以 把 一 堆 
参数 传人 语句 组 进行 处 理 。.NET 平 台中 接受 委托 对 象 参 数 的 任意 方法 都 可 以 用 相关 的 Lambda 表 达 式 
替换 ， 并 且 通 常 都 能 够 大 大 简化 代码 。 
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章 将 讨论 许多 高 级 的 语法 构造 以 加 深 大 家 对 C# 编 程 语言 的 理解 。 首 先 学 习 实 现 和 使 用 索引 
器 方法 。 这 个 C# 机 制 允 许 我 们 构建 能 够 以 类 似 访问 数组 的 语法 来 访问 内 部 子 类 型 的 自 定义 
类 型 。 当 学 会 如 何 构建 索引 器 方法 后 ， 接 下 来 讨论 如 何 重 载 各 种 操作 符 (+、-、<、> 等 )， 并 创建 自 
定义 显 式 类 型 转换 与 隐 式 类 型 转换 ， 同 时 将 介绍 为 什么 要 这 样 做 。 
接 下 来 ， 我 们 将 学 习 与 LINQ 相 关 的 API 中 非常 有 用 的 话题 ( 当然 也 可 以 在 LINQ 以 外 的 上 下 文中 
使 用 它们 ) 一 一 特别 是 扩展 方法 和 匿名 类 型 。 
最 后 ,我 们 会 学 习 如 何 创建 “不 安全 ”代码 来 直接 操纵 非 托管 指针 。 尽 管 C# 应 用 程序 很 少 使 用 指 
针 ， 但 在 一 些 复 杂 的 互 操 作 场景 中 ， 理 解 如 何 使 用 指针 还 是 非常 有 用 的 。 


11.1 索引 器 方法 
作为 程序 员 , 我 们 非常 熟悉 使 用 索引 操作 符 ([] ) 访问 包含 在 一 个 标准 数组 中 的 各 个 子 项 。 例 如 : 


static void Main(string[] args) 
// 使 用 索引 操作 符 遍 历 传 入 的 命令 行 参数 


for(int i = 0; i < args.Length; i++) 
Console.WriteLine("Args: {0}", args[i]); 


// 声明 一 个 局 部 整数 数组 
int[] myInts = { 10, 9, 100, 432, 9874}; 


// 使 用 索引 操作 符 访问 每 个 元 素 

for(int j = 0; j < myInts.Length; j++) 
Console.WriteLine("Index {0} = {1} ", j, myInts[j]); 

Console.ReadLine(); 


上 面 的 代码 绝 不 是 什么 新 鲜 事物 。C# 人 允许 构建 按照 标准 数组 方式 索引 的 自 定义 类 和 结构 。 顺 理 成 
章 地 能 以 这 种 方式 访问 子 项 的 方法 称 为 索引 器 方法 (indexer method )。 构 建 自 定义 集合 类 ( 泛 型 或 非 
泛 型 ) 时 ， 这 个 特殊 的 语言 功能 特别 有 用 。 

在 探索 如 何 实现 一 个 自 定义 索引 器 之 前 ， 让 我 们 来 看 一 个 运行 中 的 例子 。 假 定 要 在 第 9 章 ( 准 
确 地 说 ， 是 在 IssuesWithNonGenericCollection 项 目 ) 中 开发 的 自 定 义 类 型 PersonCollection 里 添加 
对 索引 器 方法 的 支持 。 尽 管 还 没 添 加 索引 器 ， 但 我 们 不 妨 先 考虑 新 控制 台 应 用 程序 SimpleIndexer 的 
用 法 : 
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// 索引 器 允许 我 们 以 访问 数组 的 方式 访问 各 个 子 项 
class Program 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Indexers *****\n"); 
PersonCollection myPeople = new PersonCollection(); 


// 使 用 索引 器 语法 添加 对 象 

myPeople[0] = new Person("Homer", "Simpson", 40); 
myPeople[1] = new Person("Marge"， "Simpson", 38); 
myPeople[2] = new Person("Lisa", "Simpson", 9); 
myPeople[3] = new Person("Bart", "Simpson", 7); 
myPeople[4] = new Person("Maggie", "Simpson", 2); 


// 现在 使 用 索引 器 获取 并 显示 每 个 子 项 
for (int i = 0; i «< myPeople.Count; i++) 


Console.WritelLine("Person number: {0}", i); 
Console.WriteLine("Name: {0} {1}", 

myPeople[i].FirstName, myPeople[i].LastName); 
Console.WriteLine("Age: {0}", myPeople[i].Age); 
Console.WritelLine(); 


} 
} 
可 见 ， 索 引 吉 允许 我 们 像 操作 一 个 标准 数组 那样 操作 内 部 子 对 象 集合 。 现 在 大 问题 就 来 了 : 如 何 配 
置 PersonCollection 类 (或 其 他 任何 自 定义 类 /结构 ) 使 它 支持 这 种 功能 呢 ? 索引 器 看 上 去 像 是 轻 量 级 的 修 
改过 的 C# 属 性 。 索 引 器 最 简单 的 创建 形式 是 使 用 this[] 语 法 。 为 此 ， 相 应 地 修改 PersonCollection 类 : 
// 给 现 有 的 类 定义 添加 索引 器 
public class PersonCollection : IEnumerable 


private ArrayList arPeople = new ArrayList(); 


// 类 的 自 定义 索引 器 
public Person this[int index] 


get { return (Person)arPeople[index]; } 
set { arPeople.Insert(index, value); } 
和 
除了 使 用 this 关 键 字 以 外 ， 索 引 器 看 上 去 和 任何 其 他 C# 属 性 声明 很 相似 。 例 如 ，get 作 用 域 会 把 
当前 对 象 返回 给 调用 者 。 在 这 里 ,我 们 其 实 是 使 用 ArrayList 对 象 的 索引 器 来 完成 的 ,就 像 该 类 支持 索 
引 需 一 样 。set 作 用 域 负 责 添 加 新 的 Person 对 象 ， 这 是 通过 调用 ArrayList 的 Insert() 方 法 来 完成 的 。 
索引 器 是 另 一 种 语法 便利 手段 ， 因 为 这 种 功能 也 可 以 使 用 普通 的 公共 方法 ( 如 AddPerson() 或 
GetPerson() ) 。 不 过 ,在 自 定义 集合 类 型 中 支持 索引 器 方法 后 ， 能 很 好 地 和 .NET 基 础 类 库 融 为 一 体 。 
虽然 在 构建 自 定义 集合 时 , 构建 索引 器 方法 很 常见 , 但 是 需要 记 住 , 泛 型 类 型 直接 支持 这 个 功能 。 
考虑 如 下 方法 ， 它 使 用 了 person 对 象 的 泛 型 List<T>。 注 意 ， 我 们 现在 就 可 以 直接 使 用 ListkT> 的 索引 
怖 了 ， 例 如 : 
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static void UseGenericListOfPeople() 


List<Person> myPeople = new List<Person>(); 
myPeople.Add(new Person("Lisa", "Simpson", 9)); 
myPeople.Add(new Person("Bart", "Simpson", 7)); 


// 改变 第 一 个 人 的 索引 器 
myPeople[0] = new Person("Maggie", "Simpson", 2); 


// 通过 索引 器 获取 和 显示 每 一 项 
for (int i = 0; i < myPeople.Count; i++) 


Console.WritelLine("Person number: {0}", i); 

Console.WriteLine("Name: {0} {1}", myPeople[i].FirstName, 
myPeople[i].LastName); 

Console.WriteLine("Age: {0}", myPeople[i].Age); 

Console.WriteLine(); 


} 





源 代码 ”SimpleIndexer 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 





11.1.1 使 用 字符 串 值 索 引 对 象 


现在 的 PersonCollection 类 定义 了 一 个 允许 调用 者 使 用 数值 识别 子 项 的 索引 器 。 不 过 要 知道 索引 
需 方 法 ,不 一 定 非 要 这 样 做 。 假 定 我 们 更 想 把 Person 对 象 放 到 一 个 System.Collections.Generic. 
DictionaryxTKey，TValue> 而 不 是 ArrayList 中 。 由 于 Dictionary 类 型 允许 使 用 字符 串 标记 (例如 一 个 
人 名 ) 来 访问 其 中 包含 的 类 型 ， 我 们 可 以 设 定 新 的 索引 器 如 下 : 

public class PersonCollection : IEnumerable 


private Dictionary<string, Person> listPeople = 
new Dictionary<string, Person>(); 


// 这 个 索引 器 基于 一 个 字符 囊 索 引 返 回 一 个 Person 
public Person this[string name] 


get { return (Person)1istPeople[name]; } 
set { listPeople[name] = value; } 


} 


public void ClearpPeople() 
{ listPeople.Clear(); } 


public int Count 
{ get { return listPeople.Count; } } 


IEnumerator IEnumerable.GetEnumerator() 
{ return listPeople.GetEnumerator(); } 


} 
调用 者 现在 可 以 与 包含 的 Person 对 象 交 互 ， 如 下 所 示 : 
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static void Main(string[] args) 
Console.WritelLine("***** Fun with Indexers *****\n"); 
PersonCollection myPeople = new PersonCollection(); 


myPeople["Homer"] = new Person("Homer", "Simpson", 40); 
myPeople["Marge"] = new Person("Marge", "Simpson", 38); 


// 获取 "Homer" 并 输出 数据 
Person homer = myPeople["Homer"]; 
Console.WriteLine(homer.ToString()); 


Console.ReadLine(); 


} 

如 果 要 直接 使 用 泛 型 Dictionary<Tkey，TValue> 类 型 ， 可 以 直接 获得 索引 器 方法 功能 ， 而 不 用 构 
建 一 个 自 定义 的 支持 字符 串 索 引 器 的 非 泛 型 类 。 不 过 ,一定 要 清楚 的 是 ,任何 索引 器 的 数据 类 型 都 取 
决 于 支持 的 集合 类 型 允许 调用 者 获取 子 项 的 方式 。 


源 代码 ”StringIndexer 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 


11.1.2” 重 载 索 引 器 方法 


索引 器 方法 可 以 在 单个 类 或 结构 上 被 重 载 。 因 此 ， 如 果 要 让 调用 者 通过 数字 索引 或 字符 串 值 访问 
子 项 ， 就 可 能 需要 为 一 个 字符 串 类 型 定义 多 个 索引 器 。 例 如 ， 在 ADO.NET 中 ( .NET 原 生 数 据 库 访问 
API ) ， 可 能 会 想起 DataSset 类 支持 一 个 叫 Tables 的 属性 ， 它 返回 的 是 强 类 型 的 DataTableCollection 类 
型 。 结 果 是 DataTableCollection 定 义 了 3 个 索引 器 来 获取 和 设置 DataTable 对 象 , 一 个 是 根据 顺序 位 置 ， 
其 他 两 个 是 根据 友好 字符 串 名 称 和 可 选 的 包含 命名 空间 ， 如 下 所 示 : 


public sealed class DataTableCollection : InternalDataCollectionBase 


// 重 载 的 索引 器 

public DataTable this[string name] { get; } 

public DataTable this[string name, string tableNamespace] { get; } 
public DataTable this[int index] { get; } 


基础 类 库 中 的 类 型 支持 索引 器 方法 是 非常 普遍 的 。 因 此 ， 即 使 当前 的 项 目 不 一 定 需要 为 类 和 结构 
构建 自 定义 索引 器 ， 但 很 多 类 型 已 经 支持 了 这 个 语法 。 


11.1.3 多维 的 索引 器 


如 果真 想 特 立 独行 ， 也 可 以 创建 一 个 传人 多 个 参数 的 索引 器 。 假 定 有 一 个 以 二 维 数组 方式 存储 子 
项 的 自 定 义 集合 ， 可 以 设 定 索引 器 方法 如 下 : 


public class SomeContainer 


private int[,] my2DintArray = new int[10, 10]; 
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public int this[int row, int column] 
{ /* 从 二 维 数组 中 取 值 或 赋值 */ ”} 


除非 要 构建 高 度 程式 化 的 自 定义 集合 类 ,否则 一 般 不 会 需要 构建 多 维 索引 器 .尽管 如 此 ,ADO.NET 
再 次 展示 了 这 种 构造 的 用 途 。ADO.NET 中 的 DataTable 实 际 上 是 行 和 列 的 集合 ， 很 像 是 方 格 纸 或 微软 
Excel 电 子 表格 的 一 般 结 构 。 

DataTable 对 象 通常 用 “数据 适配器 ”填充 ， 但 下 面 的 代码 演示 了 如 何 手动 在 内 存 中 创建 包含 3 列 
(名 、 姓 和 年 龄 ) 的 DataTable。 注 意 ， 在 向 DataTable 中 添加 一 行 时 ， 我 们 使 用 多 维 索引 器 访问 行 的 每 
一 列 〈 需 要 在 代码 文件 中 引入 System.Data 命 名 空间 )。 

static void MultiIndexerWithDataTable() 


{ 
// 创建 一 个 包含 3 列 的 简单 DataTable 
DataTable myTable = new DataTable(); 
myTable.Columns.Add(new DataColumn("FirstName")); 
myTable.Columns.Add(new DataColumn("LastName")); 
myTable.Columns.Add(new DataColumn("Age")); 


// 向 表 中 添加 一 行 
myTable.Rows.Add("Mel", "Appleby", 60); 


// 使 用 多 维 索 引 器 获取 第 一 行 中 的 详细 内 容 
Console.WritelLine("First Name: {0}", myTable.Rows[0][0]); 


Console.WriteLine("Last Name: {0}", myTable.Rows[0][1]); 
Console.WritelLine("Age : {0}", myTable.Rows[0][2]); 


我 们 将 在 第 21 章 中 详细 介绍 ADO.NET, 因此 不 要 担心 以 上 那些 不 熟悉 的 代码 。 该 示例 主要 用 来 说 
明 索 引 器 方法 支持 多 维 ， 并 且 如 果 使 用 正确 ， 可 以 简化 与 自 定 义 集 合 中 子 对 象 的 交互 。 


11.1.4 在 接口 类 型 上 定义 索引 器 


最 后 ， 要 知道 索引 器 可 以 在 指定 .NET 接 口上 定义 ， 这 样 实现 类 型 就 可 以 提供 自 定义 实现 。 
以 下 是 一 个 接口 的 简单 示例 ， 它 定义 了 使 用 数字 索引 器 获取 字符 串 对 象 的 协议 : 
public interface IStringContainer 
string this[int index] { get; set; } 
任何 实现 了 该 接口 的 类 和 结构 都 必须 支持 一 个 可 读 写 的 索引 器 ， 它 使 用 数字 值 操作 子 项 。 下 面 是 
一 个 这 种 类 的 部 分 实现 : 
class SomeClass : IStringContainer 
private List<string> myStrings = new List<string>(); 
ee string this[int index] 


get { return myStrings[index]; } 
set { myStrings.Insert(index, value); } 
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本 章 的 第 一 个 话题 到 这 里 就 结束 了 。 现 在 我 们 来 看 下 一 个 语言 特性 ， 它 可 以 使 你 构建 的 自 定义 类 
或 结构 响应 C# 的 内 置 操作 符 。 下 面 请 允许 我 介绍 操作 符 重 载 的 概念 。 


11.2 ”操作 符 重 载 


和 其 他 编程 语言 一 样 ，C# 有 一 组 用 来 完成 内 建 类 型 基本 操作 的 操作 符 。 例 如 ， 我 们 知道 + 操作 符 
可 以 用 于 两 个 整数 以 得 出 一 个 更 大 的 整数 : 


// 整数 间 的 + 操作 符 
int a = 100; 
int b = 240; 
int c =a+b; // c 现 在 是 340 


这 不 是 什么 新 鲜 事 物 ， 但 你 是 否 注意 过 同样 的 + 操作 符 可 被 用 于 大 多 数 内 建 的 C# 数 据 类 型 ? 举 个 
例子 ， 思 考 以 下 代码 : 
// 字符 囊 间 的 + 操作 符 


string s1 = "Hello"; 
string s2 = " world!"; 
string s3 = S1 + S2; // 53 现 在 是 "Hello world!" 


+ 操作 符 本 身 可 以 根据 所 提供 的 数据 类 型 ( 本 例 中 是 字符 串 和 整数 ) 不 同 而 有 不 同 的 功能 。 当 + 操 
作 符 被 用 于 数字 类 型 时 ， 结 果 就 是 操作 数 之 和 ; 而 当 + 操 作 符 用 于 字符 串 类 型 时 ， 结 果 就 是 字符 串 的 
串联 。 

C#i 语 言 允 许 我 们 构建 自 定义 类 型 和 结构 ,它们 也 能 对 同一 组 基本 操作 符 ( 如 + ) 做 出 不 同 的 反应 。 
尽管 并 非 所 有 的 C# 操 作 符 都 能 重 载 ， 但 大 多 数 都 是 可 以 的 ， 如 表 11-1 所 示 。 


表 11-1 C# 操 作 符 的 可 重 载 性 


C# 操 作 符 可 重 载 性 

+, -,，!, ~, ++, - -, true, false 这 组 一 元 操作 符 可 被 重 载 

和 = |, SS 这 组 二 元 操作 符 可 被 重 载 

= =, |=, <, >, 《=, >= 比较 操作 符 可 被 重 载 。C# 要 求 配套 的 操作 符 ( 即 < 和 >、<= 和 >=、== 和 !=) 
一 起 重 载 

[] [] 操 作 符 不 可 重 载 。 但 本 章 前 面 看 到 ， 索 引 器 构造 提供 了 同样 的 功能 

0 () 操 作 符 不 可 重 载 。 在 本 章 稍 后 将 会 看 到 , 自 定义 转换 方法 提供 了 同样 的 
功能 

+=，-=，*=，/=，%-=，8=，|=，^=,，<<=， >>= ”简写 赋值 操作 符 不 可 重 载 。 但 当 重 载 相关 的 二 元 操作 符 时 ， 它 们 也 能 随 
之 具有 相应 的 新 功能 


11.2.1 ” 重 载 二 元 操作 符 
为 说 明 重 载 二 元 操作 符 的 过 程 , 构建 新 的 控制 台 应 用 程序 OverloadedOps, 设想 其 中 定义 了 以 下 简 
单 的 Point 类 : 


// 仅 是 一 个 简单 的 C# 类 
public class Point 





public int X {get; set;} 
public int Y {get; set;} 


public Point(int xPos, int yPos) 


X = xPos; 
Y = yPos; 
} 


public override string ToString() 


return string.Format("[{0}, {1}]", this.X, this.Y); 
} 
} 
从 逻辑 上 讲 ， 把 Point 加 到 一 起 是 有 意义 的 。 例 如 ， 把 两 个 Point 变 量 加 到 一 起 ， 将 会 得 到 一 个 新 的 
Point, 它 是 X 和 Y 值 的 和 。 同样 ， 从 一 个 Point 中 减 去 男 一 个 也 是 有 用 的 。 理 想 情 况 下 ,可 能 写 出 如 下 代码 : 


// 加 减 两 个 Point 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Overloaded Operators *****\n"); 


// 创建 两 个 点 

Point ptOne = new Point(100, 100); 

Point ptTwo = new Point(40, 40); 
Console.WritelLine("ptOne = {0}", ptOne); 
Console.WriteLine("ptTwo = {0}", ptTwo); 


// 将 两 个 点 相 加 得 到 一 个 更 大 的 点 
Console.WritelLine("ptOne + ptTwo: {0} ", ptOne + ptTwo); 


// 将 两 个 点 相 减 得 到 一 个 更 小 的 点 
Console.WriteLine("ptOne - ptTwo: {0} ", ptOne - ptTwo); 
Console.ReadLine(); 


然而 ， 对 于 现在 的 Point ， 我 们 会 收 到 一 个 编译 时 错误 ， 因 为 point 类 型 不 知道 如 何 处 理 + 或 -操作 
符 。C# 提 供 operator 关 键 字 来 允许 自 定义 类 型 对 内 建 操作 符 作出 不 同 的 反应 ，operator 关 键 字 只 可 与 
static 关 键 字 联合 使 用 。 当 我 们 重 载 一 个 二 元 操作 符 (例如 + 与 - ) 时 ， 将 传人 与 指定 类 类 型 相同 的 两 
个 参数 ， 本 例 中 为 Point。 代 码 如 下 : 


// 更 加 智能 的 Point 类 型 
public class Point 


// 重 载 + 操作 符 
public static Point operator + (Point p1, Point p2) 
{ 
return new Point(p1.X + p2.X, pi.Y + p2.Y); 
// 重 载 -操作 符 
public static Point operator - (Point p1, Point p2) 


return new Point(p1.X - p2.X, p1.Y - p2.Y); 
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+ 操作 符 背 后 的 逻辑 很 简单 ， 仅 是 返回 一 个 基于 传人 Point 参 数字 段 分 别 相 加 的 全 新 Point 对 象 。 当 
写 pt1+pt2 的 时 候 ， 可 以 预想 它 将 隐 式 调用 静态 操作 符 + 方 法 ， 如 下 所 示 : 

// 伪 代 码 : Point p3 = Point.operator+ (p1，p2) 

Point p3 = p1 + p2; 

同 理 ，p1 - p2 映 射 如 下 所 示 : 

// 伪 代 码 : Point p4 = Point.operator- (p1，p2) 

Point p4 = p1 - p2; 

有 了 这 样 的 更 新 ， 程 序 就 可 以 编译 了 ， 现 在 我 们 会 发 现 可 以 加 或 减 Point 对 象 ， 输 出 结果 如 下 : 


ptone = [100, 100] 
ptTwo = [40，40] 
ptOne + ptTwo: [140，140] 

ptone - ptTwo: [60，60] 











如 果 我 们 正在 重 载 二 元 操作 符 ， 就 不 需要 传人 两 个 相同 类 型 的 参数 。 如 果 这 样 做 有 意义 ， 可 以 有 
一 个 参数 不 一 样 。 例 如 ， 这 里 是 重 载 后 的 + 操作 符 ， 它 允许 调用 者 根据 数值 的 差 值 来 获取 新 的 Point: 


public class Point 


public static Point operator + (Point p1i, int change) 


return new Point(p1.X + change, p1.Y + change); 


public static Point operator + (int change, Point p1) 


return new Point(p1.X + change，p1.Y + change); 


四 
注意 ， 如 果 你 希望 以 这 两 种 顺序 传递 参数 ， 就 需要 该 方法 的 两 个 版 本 ( 你 不 能 只 定义 其 中 一 个 方 

法 ， 而 希望 编译 器 自动 支持 另 一 个 )。 我 们 现在 就 可 以 如 下 使 用 新 版 本 的 + 操作 符 : 
// 输出 [110,110] 


Point biggerPoint = ptOne + 10; 
Console.WritelLine("ptOne + 10 = {0}", biggerPoint); 


// 输出 [120,120] 
Console.Writeline("10 + biggerPoint = {0}", 10 + biggerPoint); 
Console.WritelLine(); 


11.2.2 += 与 -= 操作 符 

如 果 你 是 由 C++ 背景 转 到 C# 来 的 , 可 能 会 因为 无 法 重 载 简写 赋值 操作 符 (+=、-= 等 ) 而 感到 遗憾。 
其 实在 C# 中 , 如 果 一 个 类 型 重 载 了 相关 的 二 元 操作 符 , 这 些 简写 赋值 操作 符 会 自动 具有 相应 的 新 功能 。 
因此 ， 因 为 point 结 构 已 经 重 载 了 + 和 -操作 符 ， 可 以 编写 如 下 代码 ， 


// 重 载 二 元 操作 符 时 ， 能 产生 新 的 简写 赋值 操作 符 
static void Main(string[] args) 
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// 自动 改变 功能 的 += 

Point ptThree = new Point(90, 5); 

Console.WritelLine("ptThree = {0}", ptThree); 
Console.WriteLine("ptThree += ptTwo: {0}", ptThree += ptTwo); 


// 自动 改变 功能 的 -= 

Point ptFour = new Point(0, 500); 

Console.WriteLine("ptFour = {0}", ptFour); 
Console.WriteLine("ptFour -= ptThree: {0}", ptFour -= ptThree); 
Console.ReadLine(); 


11.2.3” 重 载 一 元 操作 符 

C# 也 允许 我 们 重 载 各 种 一 元 操作 符 ， 例 如 ++ 与 --。 在 重 载 一 元 操作 符 时 ， 也 必须 使 用 static 关 键 
字 和 operator 关 键 字 ,在 本 例 中 我 们 只 传人 一 个 与 指定 类 /结构 相同 类 型 的 参数 。 例如， 如 要 用 下 列 重 
载 操 作 符 修改 Point: 


public class Point 


7/ 将 传 入 的 Point 的 X/Y 值 加 1 


} 


public static Point operator ++(Point p1) 


return new Point(p1.X+1, p1.Y+1); 


// 将 传 入 的 Point 的 X/Y 值 减 1 
public static Point operator --(Point p1) 


return new Point(p1.X-1，p1.Y-1); 


也 可 以 按 如 下 代码 增 减 Point 的 X 和 Y 值 : 


static void Main(string[] args) 


“77 向 point 应 用 ++ 和 -- 一 元 操作 符 


} 


Point ptFive = new Point(1, 1); 
Console.WriteLine("++ptFive = {0}", ++ptFive); // [2, 2] 
Console.WriteLine("--ptFive = {0}", --ptFive); // [1, 1] 


// 使 用 相同 的 操作 符 进行 后 递增 和 后 递减 

Point ptSix = new Point(20, 20); 
Console.WritelLine("ptSix++ = {0}", ptSix++); // [20, 20] 
Console.WritelLine("ptSix-- = {0}", ptSix--); // [21, 21] 
Console.ReadLine(); 


注意 在 之 前 的 代码 示例 中 , 我 们 以 两 种 独特 的 形式 应 用 了 自 定义 ++ 和 -- 操 作 符 。 在 C++ 中 , 可 以 
独立 重 载 前 /后 递增 /递减 操作 符 。 然 而 在 C# 中 不 行 ， 递 增 /递减 的 返回 值 会 自动 进行 正确 的 处 理 ( 即 
对 于 重 载 的 + 操作 符 ， 在 表达 式 中 pt++ 的 值 就 是 未 修改 的 对 象 的 值 ， 而 ++pt 就 在 表达 式 使 用 前 应 用 
了 新 值 。) 
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11.2.4” 重 载 相等 操作 符 

回想 一 下 第 6 章 ，System.0bject.Equals() 可 以 重 写 ,实现 引用 类 型 间 基 于 值 ( 而 不 是 基于 引用 ) 
的 比较 。 如 果 选 择 重 写 Equals() 方 法 和 与 之 密切 相关 的 System.0bject.GetHashCode() 方 法 ， 重 载 相 等 
操作 符 ( == 和 != ) 的 意义 不 大 。 为 便于 说 明 ， 下 面 是 修改 后 的 Point 类 型 ; 

// point 的 变 体 也 重 载 了 == 和 1= 操 作 符 

public class Point 

”public override bool Equals(object o) 


return o.ToString() == this.ToString(); 


public override int GetHashCode() 


return this.ToString().GetHashCode(); 


// 现在 ， 让 我 们 来 重 载 == 和 ! = 操作 符 
public static bool operator ==(Point p1i, Point p2) 


return p1.Equals(p2); 


public static bool operator !=(Point p1, Point p2) 
{ 
return !p1.Equals(p2); 


} 

注意 ，== 与 != 操 作 符 的 实现 仅仅 是 调用 重 写 的 Equals() 方 法 就 完成 了 大 部 分 工作 。 因 此 ， 我 们 可 
以 按 如 下 代码 修改 Point 类 : 

// 利用 重 载 的 相等 操作 符 


static void Main(string[] args) 


Console.WriteLine("ptOne == ptTwo : {0}", ptOne == ptTwo); 
Console.WriteLine("ptOne != ptTwo : {0}", ptOne != ptTwo); 
Console.ReadLine(); 


可 以 看 到 , 在 比较 两 个 对 象 时 ， 使 用 广为人知 的 == 和 != 操 作 符 而 不 是 调用 Object.Equals() 操 作 符 
是 相当 直观 的 。 如 果 为 一 个 指定 的 类 重 载 了 相等 操作 符 , 一 定 要 注意 C# 在 重 载 == 操 作 符 时 必须 同时 重 
载 != 操 作 符 ( 如 果 忘 记 这 样 做 ， 编 译 器 会 提示 你 ) 。 


11.2.5 ” 重 载 比较 操作 符 


在 第 8 章 里 ， 介 绍 了 一 个 类 如 何 实现 IComparable 接 口 ， 以 便于 比较 两 个 相似 对 象 之 间 的 关系 。 除 
此 之 外 ， 也 可 以 为 该 类 重 载 比 较 操 作 符 (<、>、<= 和 >= ) 。 和 相等 操作 符 一 样 ，C# 要 求 :， 如 果 要 重 载 
<， 则 也 必须 重 载 >。<= 与 >= 同 理 。 如 果 Point 类 型 重 载 了 这 些 比 较 操 作 符 ， 对 象 用 户 现在 就 可 以 比较 
Point， 如 下 所 示 : 
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// 使 用 重 载 的 < 与 》 操 作 符 
static void Main(string[] args) 


Console.WriteLine("ptOne < ptTwo : {0}", ptOne «< ptTwo); 
Console.WritelLine("ptOne > ptTwo : {0}", ptOne > ptTwo); 
Console.ReadLine(); 


如 果 已 经 实现 了 IComparable 接 口 (最 好 实现 其 等 价 的 泛 型 接口 ) ， 那么 重 载 比较 操作 符 就 很 容易 
了 。 下 面 是 修改 后 的 类 定义 : 


// Point 也 可 使 用 比较 操作 符 比 较 
public class Point : IComparable<Point> 


public int CompareTo(Point other) 


if (this.X > other.X && this.Y > other.Y) 
return 1; 

if (this.X < other.X && this.Y < other.Y) 
return -1; 

else 
return 0; 


} 


public static bool operator <(Point p1， Point p2) 
{ return (p1.CompareTo(p2) < 0); } 


public static bool operator >(Point p1, Point p2) 
{ return (p1.CompareTo(p2) > 0); } 


public static bool operator <=(Point p1, Point p2) 
{ return (p1.CompareTo(p2) <= 0); } 


public static bool operator >=(Point p1i, Point p2) 
{ return (p1.CompareTo(p2) >= 0); } 


11.2.6 操作 符 重 载 的 最 后 让 思 


可 以 看 到 ，C# 人 允许 我 们 构建 可 对 各 种 内 建 的 操作 符 做 出 不 同 反应 的 类 型 。 在 修改 所 有 的 类 使 它们 
支持 这 些 行为 之 前 ， 必 须 确保 要 重 载 的 操作 符 逻 辑 上 符合 日 常生 活 中 的 意义 。 

举 个 例子 , 假设 为 Minivan 类 重 载 了 乘法 操作 符 。 两 个 Minivan 对 象 相 乘 有 什么 意义 呢 ? 意义 不 大 。 
如 下 所 示 的 对 MiniVan 对 象 的 使 用 会 令 人 感到 困惑 。 


// 极 不 直观 
MiniVan newVan = myVan * yourVan; 


重 载 操作 符 通 常 仅 在 构建 原子 数据 类 型 时 才 有 用 。 文 本 、 点 、 和 矩形 、 分 数 和 六 边 形 都 是 操作 符 重 
载 的 很 好 候选 。 人 、 经 理 、 汽 车 、 数 据 库 连接 和 网 页 却 不 是 。 就 经 验 来 说 ， 如 果 一 个 重 载 操作 符 会 使 
用 户 更 难于 理解 该 类 型 的 功能 ， 那 就 别 用 它 。 要 谨慎 使 用 这 个 特性 。 








源 代码 ”OverloadedOps 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 
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现在 讨论 与 操作 符 重 载 紧密 相关 的 自 定义 类 型 转换 。 为 给 稍 后 的 讨论 做 好 铺垫 ,快速 回顾 一 下 数 
值 数 据 及 相关 类 类 型 之 间 显 式 和 隐 式 转换 的 概念 。 


11.3.1 回顾 : 数值 转换 


对 于 内 建 数值 类 型 ( sbyte 、int 、float 等 )， 如 果 在 较 小 容器 中 存储 较 大 数值 ， 就 需要 一 个 显 式 
转换 ， 因 为 这 可 能 导致 数据 丢失 。 这 实际 上 就 是 告诉 编译 器 :“ 别 理 我 , 我 知道 我 在 做 什么 。” 反 过 来 ， 
如 果 试 图 将 较 小 类 型 放 到 指定 目标 类 型 中 时 不 会 丢失 数据 ， 将 自动 进行 隐 式 转换 ; 

static void Main() 

int a = 1233 


long b = a; // 从 int 到 long 的 隐 式 转换 
int c = (int) bj // 从 long 到 int 的 显 式 转换 


11.3.2 回顾: 相关 的 类 类 型 间 的 转换 


在 第 6 章 中 我 们 看 到 ， 类 类 型 可 通过 传统 的 继承 关系 (“is-a” 关 系 ) 关联 起 来 。 这 时 ，C# 转 换 过 
程 允许 我 们 向 类 层次 结构 中 的 上 级 或 下 级 进行 强制 类 型 转换 。 例 如 , 一 个 派生 类 总 可 以 被 隐 式 强制 类 
型 转换 为 基 类 类 型 。 而 如 果 要 在 派生 变量 中 存储 基 类 类 型 必须 执行 显 式 强制 类 型 ， 如 下 所 示 : 


// 两 个 相关 的 类 类 型 
class Base{} 
class Derived : Base{} 


class Program 





static void Main(string[] args) 


{ 
// 派生 类 向 基 类 的 隐 式 强制 类 型 转换 
Base myBaseType; 
myBaseType = new Derived(); 


// 在 派生 类 型 中 存储 基 类 引用 必须 显 式 强制 类 型 转换 
Derived myDerivedType = (Derived)myBaseType; 
小 
这 个 显 式 强制 类 型 转换 之 所 以 行 之 有 效 ， 应 归功 于 Base 类 和 Derived 类 之 间 存 在 传统 的 继承 关系 。 
但 如 有 没有 公共 父 类 (除了 System.0bject ) 不 同 层 次 结构 中 的 两 个 类 需要 转换 ， 又 该 怎么 办 呢 ? 由 于 
它们 不 存在 继承 关系 ， 典 型 的 强制 类 型 转换 操作 于 事 无 补 。 
与 此 相关 ， 思 考 一 下 值 类 型 ( 结构 )。 假设 有 两 个 名 为 Square 和 Rectangle 的 .NET 结 构 。 由 于 结构 
不 能 使 用 传统 继承 ( 因为 它们 是 密封 的 )， 所 以 不 能 直接 强制 类 型 转换 这 些 看 起 来 差不多 的 类 型 。 
在 结构 中 构建 辅助 方法 ( 如 Rectangle.ToSquare() ) 的 同时 ，C# 人 允许 我 们 构建 能 使 用 户 类 型 响 
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应 () 操 作 符 的 自 定 义 强制 类 型 转换 例 程 。 因 此 ， 如 果 正 确 设 定 了 结构 ， 可 使 用 如 下 语法 显 式 转换 这 
些 结构 : 

// 将 和 矩形 转换 为 正方 形 

Rectangle rect; 

Tect .Width = 3; 


rect.Height = 10; 
Square sq = (Square)rect; 


11.3.3 创建 自 定 义 转换 例 程 

首先 创建 一 个 新 的 控制 台 应 用 程序 CustomConversions。C# 提 供 两 个 关键 字 explicit 和 implicit， 
可 用 来 控制 发 生 转 换 时 类 型 的 响应 方式 。 假 定 有 以 下 结构 定义 : 

public struct Rectangle 


public int Width {get; set;} 
public int Height {get; set;} 


public Rectangle(int w, int h) : this() 


Width = w; Height = h; 


public void Draw() 
for (int i = 0; i < Height; i++) 
for (int j = 0; j < Width; j++) 
Console.Write("*"); 
Console.WritelLine(); 
} 
public override string ToString() 
return string.Format("[Width = {0}; Height = {1}]", 
Width, Height); 
} 
public struct Square 
public int Length {get; set;} 
public Square(int 1) : this() 


Length = 1; 


public void Draw() 
for (int i = 0; i «< Length; i++) 


for (int j = 0; j < Length; j++) 
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Console.Write("*"); 
Console.WriteLine(); 


} 


public override string ToString() 
{ return string.Format("[Length = {0}]", Length); } 


// 算 形 可 显 式 转换 为 正方 形 
public static explicit operator Square(Rectangle 7) 


Square s = new Square(); 
s.Length = r.Height; 
return s; 


说 明 ”你 会 发 现在 Square 和 Rectangle 构 造 函 数 中 ,我 显示 链接 到 了 默认 构造 函数 。 原 因 是 如 果 结 
构 使 用 了 自动 属性 ( 如 本 例 所 示 )， 所 有 自 定义 构造 函数 都 必须 显 式 调用 默认 构造 函数 ， 来 
初始 化 私有 的 后 台 字 段 。 是 的 ， 这 是 C# 中 非常 怪异 的 规则 ， 但 毕竟 本 章 所 讲 的 是 “高 级 语 
言 特 性 “。 


注意 ，S$quare 类 型 的 这 个 版 本 定义 了 一 个 显 式 转换 操作 符 。 如 同 重 载 操作 符 过 程 一 样 ， 转 换 例 程 
使 用 C# operator 关 键 字 ( 结合 使 用 explicit 或 ijmplicit 关 键 字 ) 而 且 必 须 定 义 为 静态 的 。 传 人 参数 是 
要 转换 的 实体 ， 而 操作 符 类 型 是 转换 后 的 实体 。 

在 这 种 情况 下 ， 假 定 能 从 矩形 的 宽度 得 到 一 个 正方 形 ( 所 有 边 都 是 等 长 的 )。 这 样 也 就 可 以 自由 
转换 一 个 Rectangle 为 Square: 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Conversions *****\n"); 


// 创建 一 个 矩形 

Rectangle r = new Rectangle(15, 4); 
Console.Writeline(r.ToString()); 
r.Draw(); 


Console.WritelLine(); 


// 根据 矩形 的 宽度 将 T 转 换 为 正方 形 
Square s = (Square)r; 
Console.WriteLine(s.ToString()); 
s.Draw(); 

Console.ReadLine(); 


} 
输出 结果 如 下 所 示 。 
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玉米 冰冰 炒 Fun with Conversions 村 冰冰 沙沙 


[width = 15; Height = 4] 


来 来 来 来 来 来 来 来 来 求 来 来 来 来 来 
来 来 来 来 来 来 来 来 来 来 水 来 来 来 来 
来 来 来 来 水 冰 来 米 来 来 冰冰 来 闵 来 
闵 六 炒米 冰 冰 永 闵 六 冰冰 六 冰冰 水 
[Length = 4] 

来 来 炒 求 

六 六 冰冰 

六 六 冰冰 

来 来 来 来 






在 一 个 代码 段 内 转换 Rectangle 为 Square 可 能 意义 不 大 ， 假 定 有 一 个 参数 为 square 的 函数 : 
// 该 方法 需要 一 个 Square 类 型 
static void DrawSquare(Square sq) 


Console.WriteLine(sq.ToString()); 
sq.Draw(); 


在 Square 类 型 上 使 用 显 式 强制 类 型 转换 操作 ， 可 以 安全 传人 Rectangle 类 型 供 处 理 ， 如 下 所 示 : 


static void Main(string[] args) 


// 将 Rectangle 转 为 Square 来 调用 方法 
Rectangle rect = new Rectangle(10, 5); 
DrawSquare( (Square)rect); 
Console.ReadLine(); 


} 


11.3.4 Square 类 型 的 其 他 显 式 转换 


现在 可 以 显 式 转换 Rectangle 为 Square 了 ,让 我 们 讨论 其 他 一 些 显 式 转换 。 由 于 正方 形 每 对 边 都 是 
对 称 的 ， 提 供 一 个 显 式 转换 例 程 ， 允 许 调用 者 由 整 型 类 型 转 为 Square 类 型 也 是 有 意义 的 ( 当然 ， 将 有 
一 个 边 长 等 于 传人 的 整数 )。 如 果 要 修改 %gquare， 使 调用 者 可 转换 Square 为 int， 又 该 怎么 办 呢 ? 下 面 
是 调用 逻辑 : 


static void Main(string[] args) 


7/ 转换 int 为 Square 
Square sq2 = (Square)90; 
Console.WritelLine("sq2 = {0}", sq2); 


// 转换 Square 为 int 

int side = (int)sq2; 

Console.Writeline("Side length of sq2 = {0}", side); 
Console.ReadLine(); 


} 
下 面 是 修改 后 的 Square 类 : 
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public struct Square 


”public static explicit operator Square(int sideLength) 


Square newSq = new Square(); 
new9q.Length = sideLength; 
return newSsq; 


public static explicit operator int (Square s) 
{return s.Length;} 
} 


客观 来 讲 ， 将 Square 转 为 int 可 能 并 不 是 最 直观 (或 最 有 用 ) 的 操作 。 不 过 ,这 确实 让 我 们 发 现 关 
于 自 定 义 转换 例 程 非常 重要 的 一 点 : 只 要 代码 语法 书写 正确 ， 编 译 器 并 不 关心 由 什么 转换 成 什么 。 

同 使 用 重 载 操作 符 一 样 ， 仅 是 因为 可 以 为 指定 类 型 创建 一 个 显 式 强制 类 型 转换 操作 ， 并 不 意味 着 
应 该 这 样 做 。 由 于 结构 不 能 参与 可 以 自由 强制 类 型 转换 的 传统 继承 , 这 种 技术 在 大 家 创建 .NET 结 构 时 
很 有 用 。 


11.3.5 ”定义 隐 式 转换 例 程 
到 现在 为 止 ， 我 们 已 经 创建 了 各 种 显 式 转换 操作 。 但 是 ， 下 列 隐 式 转换 操作 又 会 如 何 呢 ? 


static void Main(string[] args) 


Square s3 = new Square(); 
s3.Length = 83; 


// 试图 创建 一 个 隐 式 强制 类 型 转换 吗 
Rectangle rect2 = s3; 


Console.ReadLine(); 


这 段 代 码 无 法 编译 ， 因 为 没有 为 Rectangle 类 型 提供 隐 式 转换 例 程 。 如 果 返 回 类 型 或 参数 都 相同 ， 
在 同一 类 型 中 定义 显 式 和 隐 式 转换 函数 是 非法 的 , 这 就 是 关键 所 在 。 这 看 起 来 好 像 是 一 个 限制 。 不 过 ， 
第 二 个 关键 点 在 于 , 当 一 个 类 型 定义 了 隐 式 转换 例 程 后 , 调用 者 使 用 显 式 强制 类 型 转换 语法 是 合法 的 ! 

困惑 了 吧 ? 为 清楚 起 见 , 我 们 使 用 C# implicit 关 键 字 给 Rectangle 结 构 添 加 一 个 隐 式 转换 例 程 ( 注 
意 ， 下 列 代 码 假设 Rectangle 的 长 度 是 由 Square 的 长 度 乘 2 计算 出 来 的 ): 


public struct Rectangle 


public static implicit operator Rectangle(Square s) 


Rectangle r = new Rectangle(); 
r.Height = s.Length; 


// 设 定 新 矩形 的 长 度 为 正方 形 长 度 乘 2 
r.Width = s.Length * 2; 
return r; 
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这 次 更 新 后 ， 就 可 以 按 如 下 代码 转换 两 种 类 型 了 : 


static void Main(string[] args) 


// 隐 式 强制 类 型 转换 成 功 

Square s3 = new Square(); 

s3.Length= 7; 

Rectangle rect2 = s3; 
Console.WriteLine("rect2 = {0}", rect2); 


// 显 式 强制 类 型 转换 语法 也 成 功 

Square s4 = new Square(); 

s4.Length = 3; 

Rectangle rect3 = (Rectangle)s4; 
Console.WritelLine("rect3 = {0}", rect3); 
Console.ReadLine(); 


我 们 将 结束 关于 定义 自 定义 转换 例 程 的 讨论 。 关 于 重 载 操作 符 ， 要 牢记 这 些 语法 仅 是 普通 成 员 函 
数 的 简写 表示 法 , 从 这 个 角度 来 说 它们 总 是 可 选 的 。 但 只 要 使 用 正确 , 可 以 更 自然 地 使 用 自 定义 结构 ， 
因为 可 以 将 它们 当成 是 与 继承 相关 联 的 真正 的 类 类 型 。 


源 代 码 CustomConversions 项 目的 源 代 码 位 于 Chapter 11 子 目录 下 。 
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.NET3.5 引 入 了 扩展 方法 ( extension method ) 的 概念 ， 它 允许 你 在 不 直接 修改 原始 类 型 的 情况 下 ， 
为 类 或 结构 添加 新 的 方法 或 属性 。 那 么 在 哪些 情况 下 可 以 用 到 这 个 特性 呢 ? 考虑 如 下 几 种 可 能 。 

首先 ， 假 设 我 们 给 定 了 一 个 产品 中 的 类 。 随 着 时 间 的 推移 ， 我 们 越 来 越 清 晰 地 发 现 该 类 应 该 支持 
一 些 新 的 成 员 。 如 果 直 接 修改 当前 的 类 定义 ,将 可 能 会 破坏 向 后 兼容 性 。 使 用 该 类 的 旧 代码 可 能 无 法 
通过 编译 。 一 种 确保 向 后 兼容 性 的 方式 是 创建 集成 现 有 父 类 的 新 派生 类 。 但 这 样 一 来 就 有 两 个 类 需要 
维护 。 众 所 周知 ， 代 码 维护 是 软件 工程 师 的 工作 描述 中 最 枯燥 无 聊 的 部 分 了 。 

现在 考虑 下 面 的 情形 。 假 设 有 一 个 结构 (或 封闭 类 ),， 我 们 希望 向 其 添加 新 的 成 员 以 在 系统 中 展 
现 其 多 态 性 。 由 于 结构 和 封闭 类 不 能 扩展 ， 我 们 只 能 再 一 次 面 对 向 后 兼容 的 风险 ， 向 类 型 中 添加 新 
成 员 。 

使 用 扩展 方法 ， 可 以 在 不 创建 子 类 和 直接 修改 类 型 的 情况 下 修改 类 型 。 当 然 ， 该 技术 本 质 上 是 镜 
像 原 理 。 如 果 要 在 当前 项 目 中 使 用 扩展 方法 ， 也 只 能 将 这 个 新 功能 应 用 于 类 型 。 


11.4.1 定义 扩展 方法 

当 定义 扩展 方法 时 ， 你 遇 到 的 第 1 个 限制 就 是 必须 把 方法 定义 在 静态 类 ( 参阅 第 5 章 ) 中 ， 因 此 每 一 
个 扩展 方法 也 必须 声明 为 静态 的 。 第 2 个 限制 就 是 所 有 的 扩展 方法 都 需要 使 用 this 关 键 字 对 第 一 个 参数 
(并 且 仅 对 第 一 个 参数 ) 进行 修饰 。 用 this 限 定 的 参数 表示 被 扩展 的 项 。 
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为 了 演示 ， 我 们 创建 一 个 新 的 控制 台 应 用 程序 ， 命 名 为 ExtensionMethods。 假 设 你 正在 编写 一 个 工具 
类 MyExtensions， 并 在 该 类 中 定义 了 两 个 扩展 方法 。 第 1 个 扩展 方法 允许 NET 基础 类 库 中 的 所 有 对 象 都 将 
使 用 全 新 的 方法 DisplayDefiningAssembly()，, 该 方法 将 使 用 命名 空间 System.Reflection 中 的 类 型 来 显示 
包含 指定 类 型 的 程序 集 的 名 称 。 


说 明 “我们 将 在 第 15 章 中 正式 介绍 反射 API。 如 果 你 对 其 不 其 了 解 ， 可 以 简单 地 理解 为 在 运行 时 发 现 
程序 集 、 类 型 及 类 型 成 员 的 一 种 方式 。 


第 2 个 扩展 方法 是 ReverseDigits() ， 人 允许 所 有 int 将 自己 的 值 倒 置 。 例 如 ， 整 型 1234 调 用 
ReverseDigits(), 返回 的 结果 是 4321。 考虑 下 面 的 类 实现 ( 确保 导入 了 System. Reflection 命 名 空间 ): 


static class MyExtensions 


// 本 方法 允许 任何 对 象 显 示 它 所 处 的 程序 集 
public static void DisplayDefiningAssembly(this object obj) 
{ 


Console.WriteLine("{0} lives here: => {1}\n", obj.GetType().Name, 
Assembly.GetAssembly(obj.GetType()).GetName().Name); 


// 本 方法 允许 任何 整 型 返回 倒置 的 副本 ， 例 如 56 将 返回 65 
public static int ReverseDigits(this int i) 


// 把 int 翻 译 为 string 然 后 获取 所 有 字符 
char[] digits = i.ToString().ToCharArray(); 


// 现在 反 转 数组 中 的 项 
Array.Reverse(digits); 


// 放 回 string 
string newDigits = new string(digits); 


// 最 后 以 int 返 回 修改 后 的 字符 串 
return int.Parse(newDigits); 
} 


注意 每 个 扩展 方法 的 第 1 个 参数 在 定义 参数 类 型 前 都 使 用 了 关键 字 this。 大 多 数 情况 下 ， 扩 展 方法 
的 第 一 个 参数 表示 被 扩展 的 类 型 。DisplayDefiningAssembly() 被 定义 为 用 于 扩展 System.0bject， 现 在 所 
有 程序 集中 的 类 型 都 拥有 这 一 新 成 员 ， 因 为 0bject 是 .NET 平 台所 有 类 型 的 父 类 。 尽 管 如 此 ，Reverse- 
Digits() 只 被 定义 为 用 于 扩展 整 型 类 型 ， 因 此 任何 非 整 型 对 象 尝 试 调 用 该 方法 都 会 产生 编译 错误 。 


说 明 还 需要 知道 的 是 ， 扩 展 方法 可 以 拥有 多 个 参数 ， 但 只 有 第 1 个 参数 可 以 使 用 关键 字 this 进 行 修 
饰 。 其 他 参数 将 被 视 为 供 方 法 使 用 的 普通 传 入 参数 。 


11.4.2 ”在 实例 层次 上 调用 扩展 方法 
现在 我 们 已 经 定义 了 扩展 方法 ， 下 面 看 看 下 面 的 Main() 方 法 : 
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static void Main(string[] args) 


Console.WriteLine("***** Fun with Extension Methods *****\n"); 


// 本 整 型 表示 一 个 新 的 身份 标识 
int myInt = 12345678; 
myInt. DisplayDefiningAssembly(); 


// 下 面 是 DataSet 
System.Data.DataSet d = new System.Data.DataSet(); 
d.DisplayDefiningAssembly(); 


// 下 面 是 SoundPlayer 

System.Media.SoundPlayer sp = new System.Media.SoundPlayer(); 
sp.DisplayDefiningAssembly(); 

// 使 用 整 型 的 新 功能 

Console.WriteLine("Value of myInt: {0}", myInt); 
Console.WritelLine("Reversed digits of myInt: {0}", myInt.ReverseDigits()); 


Console.ReadLine(); 


输出 结果 如 下 所 示 (去 除了 无 关 紧要 的 项 ): 





****** Fun with Extension Methods ***** 
Int32 lives here: => mscorlib 
DataSet lives here: => System.Data 


SoundPlayer lives here: => System 


Value of myInt: 12345678 
Reversed digits of myInt: 87654321 





11.4.3 ”导入 扩展 方法 


在 定义 包含 扩展 方法 的 类 时 , 毫 无 疑问 应 该 将 其 定义 在 .NET 命 名 空间 中 。 如 果 该 命名 空间 与 使 用 
扩展 方法 的 命名 空间 不 同 ， 就 需要 使 用 C# 的 using 关 键 字 。 这 样 一 来 ， 你 的 代码 文件 就 可 以 访问 被 扩 
展 类 型 的 所 有 扩展 方法 。 需 要 牢记 的 是 ,如果 没 有 显 式 导 人 正确 的 命名 空间 , 扩展 方法 对 当前 C# 代 码 
文件 不 可 用 。 

虽然 表面 上 扩展 方法 是 全 局 的 ,但 其 实 它们 受制 于 所 处 的 命名 空间 。 因 此 ， 如 果 我 们 把 静态 类 
MyExtensions 封 装 在 在 名 为 MyExtensionMethods 的 命名 空间 中 : 


namespace MyExtensionMethods 


static class MyExtensions 


A 
} 


这 个 项 目 中 的 其 他 命名 空间 都 需要 显 式 引 入 MyExtensionMethods 命 名 空间 以 获取 这 些 类 中 定义 的 
扩展 方法 。 
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说 明 ”不仅 将 扩展 方法 隔离 在 专门 的 NET 命 名 空间 ， 还 将 它们 放 到 专门 的 类 库 中 ， 这 种 操作 是 很 常 
见 的 。 这 样 一 来 ， 新 应 用 程序 可 以 “选择 ”通过 显示 引用 正确 的 库 来 进行 扩展 。 第 14 章 将 详 
细 介 绍 构 建 并 使 用 自 定 义 的 .NET 类 库 。 


11.4.4 ”扩展 方法 的 智能 感知 


由 于 扩展 方法 没有 真正 定义 在 要 扩展 的 类 型 之 中 ， 因 此 在 检查 既 有 代码 的 时 候 肯 定 会 很 困惑 。 例 
如 ,假如 导入 了 一 个 命名 空间 ,一 个 团队 成 员 在 其 中 定义 了 许多 扩展 方法 。 我 们 自己 在 编码 的 时 候 可 
能 会 创建 扩展 类 型 的 变量 ,使 用 点 操作 符 ， 然 后 会 找到 不 在 原始 类 定义 中 的 许多 新 方法 ! 

可 喜 的 是 ，Visual Studio 的 智能 感知 机 制 用 独 有 的 “向 下 ”箭头 图 标 标注 所 有 扩展 方法 (如 图 11-1 
所 示 )， 在 我 们 的 屏幕 上 会 是 蓝 色 。 





Program.cs” XX : . . - 
ExtensionMethods.Program ~ 人 Main(string[] args) > 
Console,.WNritelLine("***** Fun with Extension Methods *****\n"); 村 


AI The int has assumed a new identity! 
int myInt = 12345678; 
myInt.DisplayDefiningAssembly(); 


/1/ So has the DataSet! 
System.Data.Dataset d = new System,.Data,DataSet(); | 


d. dib isplayDefiningAssembly( ); 
1 入 DesplayBefimingAsser Nbly (edension) void object.DisplayDefiningAssembly0 | 
下 二 5 

sy © Dppse Ww System.Media.SoundPliayer(); 

sp S Disposed 了 





Z7 Use new integer functionality. 
spr EO Et EN Vate tl Wyn BD} 7 MY 
OO 


图 11-1 扩展 方法 的 智能 感知 
任何 标记 了 这 个 图 标的 方法 都 表明 这 个 方法 不 在 原始 类 中 定义 而 是 通过 扩展 方法 来 定义 。 





源 代码 ” ExtensionMethods 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 


11.4.5 ”扩展 实现 了 指定 接口 的 类 型 

至 此 ， 我 们 已 经 看 到 了 如 何 使 用 扩展 方法 为 类 ( 结构 也 使 用 相同 的 语法 ) 扩展 新 的 功能 。 我 们 还 
可 以 定义 扩展 方法 ， 让 它 只 能 扩展 实现 了 正确 接口 的 类 或 结构 。 例 如 ， 你 可 以 达到 “如 果 类 或 结构 实 
现 了 IEnumerable<T>， 即 可 得 到 新 成 员 ” 的 效果 。 当 然 ， 我 们 可 以 要 求 一 个 类 型 支持 全 部 接口 ， 包 括 
我 们 自己 定义 的 接口 。 
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为 了 演示 这 一 点 ， 新 建 一 个 控制 台 应 用 程序 InterfaceExtensions ， 我 们 的 目的 是 为 任何 实现 了 
IEnumerable 的 类 型 添加 一 个 新 方法 ， 这 些 类 型 包括 数组 和 很 多 非 泛 型 集合 类 ( 第 8 章 我 们 介绍 过 ,， 泛 
型 的 IEnumerablex<T> 接 口 扩展 了 非 泛 型 的 ITEnumerable 接 口 ) 。 在 新 项 目 中 添加 如 下 所 示 的 扩展 类 : 

static class AnnoyingExtensions 

public static void PrintDataAndBeep(this System.Collections.IEnumerable iterator) 


foreach (var item in iterator) 


Console.Writeline(item); 
Console.Beep(); 


} 
} 
由 于 PrintDataAndBeep() 方 法 可 用 于 任何 实现 了 IEnumerable 的 类 或 结构 ， 我 们 可 以 通过 下 面 的 
Main() 方 法 进行 测试 : 
static void Main( string[] args ) 


Console.WritelLine("***** Extending Interface Compatible Types *****\n"); 


// System.Array 实现 IEnumerable 

string[] data = { "Wow", "this", "is", "sort", "of", "annoying", 
"but", "in", "a", "weird", "way”， "fun!l"}; 

data.PrintDataAndBeep(); 


Console.WritelLine(); 


// List<T> 实现 IEnumerable 
List<int> myInts = new List<cint>() {10, 15, 20}; 
myInts.PrintDataAndBeep(); 


Console.ReadLine(); 


这 就 结束 了 我 们 对 C 圭 - 展 方 法 的 研究 。 记 住 , 在 多 态 想 扩 展 某 个 类 型 的 功能 , 但 却 不 想 创建 子 类 
(或 不 能 创建 子 类 ， 比 如 类 型 被 封闭 ) 的 时 候 ， 这 个 特殊 语言 特性 会 非常 有 用 。 另 在 本 书后 面 将 会 看 
到 ， 扩 展 方 法 在 LINQ API 中 有 着 十 分 重要 的 作用 。 事 实 上 ， 你 将 会 看 到 在 LINQ API 中 ， 最 常见 的 被 
扩展 项 是 实现 了 IEnumerable 泛 型 版 本 的 类 或 结构 ( 相当 出 人 意料 ) 。 


源 代码 ”InterfaceExtensions 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 


11.5 ”匿名 类 型 


作为 一 个 面向 对 象 的 程序 员 ， 你 应 该 知道 定义 类 来 表达 要 建 模 的 给 定 项 的 状态 和 功能 的 好 处 。 每 
当 需 要 定义 在 项 目 间 重 用 的 类 ， 同 时 这 些 类 需要 提供 一 系列 方法 、 事 件 、 属 性 和 自 定义 构造 函数 时 ， 
我 们 通常 创建 一 个 C# 类 。 

尽管 如 此 ， 有 时 候 你 可 能 需要 定义 类 来 封装 一 些 相关 数据 ,但 并 不 需要 任何 关联 的 方法 、 事 件 和 
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其 他 自 定义 的 功能 。 此 外 ,如果 定 义 的 类 型 只 会 被 程序 中 少量 方法 使 用 呢 ? 如 果 你 明确 知道 类 只 会 在 
少量 的 地 方 使 用 ,那么 像 下 面 这 样 定义 完整 的 类 定义 是 非常 麻烦 的 。 为 了 强调 这 一 点 ， 以 下 是 当 需 要 
创建 一 个 “简单 ”的 遵循 典型 基于 值 语 义 的 数据 类 型 时 ， 可 能 需要 编写 的 梗概 。 
class SomeClass 
ee 
// 创建 属性 来 封装 每 一 个 数据 成 员 
// 重 写 方法 ToString() 来 输出 关键 数据 成 员 
eh 


如 你 所 见 ， 这 并 不 简单 。 你 不 但 需要 编写 大 量 代 码 ， 而 且 系统 中 还 多 了 一 个 类 需要 维护 。 对 于 这 
样 的 临时 数据 ， 动 态 地 生成 一 个 自 定义 数据 类 型 将 是 非常 有 用 的 。 例 如 ,假设 你 需要 构建 一 个 接受 若 
干 传人 参数 的 自 定 义 方法 。 你 会 想 在 该 方法 作用 域内 使 用 这 些 参数 来 创建 一 个 新 的 数据 类 型 。 此 外 ， 
想 要 使 用 传统 的 Tostring() 方 法 快速 打印 数据 ， 或 者 使 用 System.0bject 的 其 他 成 员 。 你 可 以 使 用 匿 
名 类 型 语法 实现 这 些 操作 。 


11.5.1 定义 匿名 类 型 


当 定义 一 个 匿名 类 型 时 ， 你 需要 使 用 新 的 关键 字 var ( 见 第 3 章 ) 和 前 面 介绍 的 对 象 初始 化 语法 ( 见 
第 5 章 )。 我 们 必须 使 用 关键 字 var， 因为 编译 器 会 在 编译 时 自动 生成 新 的 类 定义 (我 们 永远 无 法 在 C# 代 码 
中 看 到 该 类 的 名 字 )。 初 始 化 语法 将 告诉 编译 器 为 新 创建 的 类 型 创建 私有 的 后 台 字段 和 ( 只 读 的 ) 属性 。 

创建 新 的 控制 台 应 用 程序 ， 命 名 为 AnonymousTypes。 然 后 ， 在 Program 类 中 添加 下 面 的 方法 ， 它 
将 使 用 传人 参数 再 动态 地 创建 一 个 新 的 类 型 : 


static void BuildAnonType( string make, string color, int currSp ) 


// 使 用 传 入 参数 构建 匿名 类 型 
var car = new { Make = make, Color = color, Speed = currSp }; 


// 注 意 ， 现 在 可 以 使 用 该 类 型 获取 属性 数据 
Console.WriteLine( "You have a {0} {1} going {2} MPH", 
car.Color, car.Make, car.Speed); 


// 匿名 类 型 包含 对 System.0bject 中 
// 每 个 虚 方 法 的 自 定义 实现 ， 例 如 : 
| Console.WritelLine("ToString() == {0}", car.ToString()); 
你 可 以 在 Main() 中 调用 该 方法 。 不 过 要 注意 的 是 ， 匿名 类 型 也 可 以 使 用 硬 编码 值 创建 ， 如 下 所 示 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Anonymous Types +*****\n"); 


// 构建 一 个 匿名 对 象 表示 一 辆 汽车 
var myCar = new { Color = "Bright Pink", Make = "Saab", CurrentSpeed = 55 }; 


// 显示 颜色 并 输出 
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Console.WriteLine("My car is a {0} {1}.", myCar.Color, myCar.Make); 


// 调用 辅助 方法 通过 实 参 创建 匿名 类 型 
BuildAnonType("BMW", "Black", 90); 


s Console.ReadLine(); 

此 时 ， 我 们 只 需要 了 解 匿名 类 型 允许 我 们 以 非常 小 的 开销 快速 建立 数据 的 “形状 "。 这 项 技术 只 
是 动态 地 创建 新 数据 类 型 的 一 种 方式 ， 它 支持 通过 属性 来 封装 骨架 ， 其 行为 符合 基于 值 的 语义 。 要 理 
解 最 后 这 一 点 ， 我 们 来 看 看 C# 编 译 器 如 何在 编译 时 构建 匿名 类 型 ， 以 及 如 何 重 载 System.0bject 的 
成 员 。 


11.5.2 ”匿名 类 型 的 内 部 表示 方式 


所 有 的 匿名 类 型 都 自动 继承 System.0bject, 因此 它们 都 支持 基 类 的 每 一 个 成 员 。 我 们 可 以 在 隐 式 
类 型 化 的 myCar 对 象 上 调用 方法 Tostring() 、GetHashCode() 、Equals() 或 者 GetType() 。 假 设 我 们 的 
Program 类 已 经 定义 了 以 下 的 静态 帮助 方法 : 


static void ReflectOverAnonymousType(object obj) 


Console.WritelLine("obj is an instance of: {0}", obj.GetType().Name); 
Console.WriteLine("Base class of {0} is {1}", 

obj.GetType().Name, 

obj.GetType().BaseType); 
Console.WriteLine("obj.ToString() == {0}", obj.ToString()); 
Console.WriteLine("obj.GetHashCode() == {0}", obj.GetHashCode()); 
Console.WritelLine(); 


现在 我 们 在 方法 Main() 中 调用 此 方法 ， 以 myCar 对 象 作为 参数 : 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Anonymous Types *****\n"); 


// 构建 一 个 匿名 类 型 表示 一 辆 汽车 
var myCar = new {Color = "Bright Pink", Make = "Saab", CurrentSpeed = 55}; 


// 使 用 反射 输出 编译 器 生成 的 内 容 
ReflectOverAnonymousType(myCar); 


Console.ReadLine(); 


程序 的 输出 结果 如 下 所 示 : 





米 炒 来 冰 玉 FUm with Anonymous TypeS ***** 


obj is an instance of: “>f_AnonymousType0`3 

Base class of <>f_ AnonymousType0 3 is System.0bject 

obj.ToString() = { Color = Bright Pink, Make = Saab, CurrentSpeed = 55 } 
obj.GetHashCode() = -439083487 


Pare Ae rte Te OT RE EE IDTV TR OD EGG ENT oss Ear NRE ee: FrereT CR cre C0 EEE FOO EN NAOTAE NBO te 
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首先 ,注意 在 上 面 的 例子 中 ,myCar 对 象 的 类 型 是 .>f_AnonymousType0`3( 你 的 版 本 也 许 有 所 不 同 )。 
匿名 类 型 的 类 型 名 完全 由 编译 器 决定 ， 我 们 不 能 编写 代码 对 此 进行 干涉 。 

最 为 重要 的 是 ,使 用 对 象 初始 化 语法 定义 的 每 一 个 名 称 / 值 对 分 别 被 映射 为 拥有 相同 名 字 的 只 读 属 
性 以 及 对 应 被 该 属性 封装 的 私有 数据 成 员 。 下 面 的 C# 代 码 大 体 上 表示 了 编译 器 生成 的 myCar 对 象 的 类 
定义 (同样 可 以 使 用 ildasm.exe 进 行 验 证 ): 


internal sealed class <>f AnonymousTypeO<<Color>j TPar, 
<Make>j_ TPar, <CurrentSpeed>j TPar> 


// 只 读 字 段 

private readonly <Color>j TPar <Color>i Field; 

private readonly <CurrentSpeed>j TPar <CurrentSpeed>i Field; 
private readonly <Make>j TPar <Make>i Field; 


// 默认 构造 函数 
public <>f_AnonymousType0(<Color>j_TPar Color， 
<Make>j_ TPar Make, <CurrentSpeed>j TPar CurrentSpeed); 
// 重 写 若干 方法 
public override bool Equals(object value); 
public override int GetHashCode(); 
public override string ToString(); 


// 只 读 属 性 

public <Color>j TPar Color { get; } 

public «CurrentSpeed>j TPar CurrentSpeed { get; } 
public <Make>j_TPar Make { get; } 


11.5.3 ”方法 ToString() 和 GetHashCode() 的 实现 


我 们 可 以 发 现 匿名 类 型 直接 继承 了 System.0bject， 并 且 重 写 了 方法 Equals() 、GetHashCode() 和 
ToString()。 其 中 Tostring() 根 据 每 个 名 称 / 值 对 ， 生 成 并 返回 一 个 字符 串 : 


public override string ToString() 





StringBuilder builder = new StringBuilder(); 
builder.Append("{ Color = 
builder. Append(this. <Color>i _ Field); 
builder.Append(", Make = "); 
builder. Append(this. <Make>i —Field); 
builder.Append(", CurrentSpeed = 
builder. Append(this. <CurrentSpeed>i Field); 
builder.Append(" }"); 
return builder. ToString(); 

} 


GetHashCode() 的 实现 使 用 每 个 匿名 类 型 的 成 员 变 量 计算 出 散 列 值 作为 System.Collections. 
Generic.EqualityComparer<T> 类 型 的 输入 。 使 用 GetHashCode() 的 实现 ， 如 果 (也 仅 当 ) 两 个 匿名 类 型 
有 相同 的 属性 并 且 被 赋予 了 相同 的 值 ， 就 会 产生 相同 的 散 列 值 。 有 了 这 个 实现 ， 匿 名 类 型 就 完全 可 以 
包含 在 Hashtable 容 器 中 。 
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11.5.4 ”匿名 类 型 的 相等 语义 


我 们 可 以 看 到 ， 方法 ToString() 和 GetHashCode() 的 重 写实 现 相当 简单 ， 现 在 你 可 能 想 知道 方法 
Equals() 是 如 何 被 重 写 的 。 例如， 如 果 你 定义 了 两 辆 “匿名 车 辆 ”变量 , 它们 定义 了 相同 的 名 称 / 值 对 ， 


那么 两 者 是 否 相 等 呢 ? 为 了 知道 结果 ， 首 先 需要 更 新 Program 类 型 : 


static void EqualityTest() 


{ 
// 构建 两 个 匿名 类 ， 拥 有 相同 的 名 称 / 值 对 


var firstCar = new { Color = "Bright Pink", Make = "Saab", CurrentSpeed = 55 }; 
var secondCar = new { Color = "Bright Pink", Make = "Saab", CurrentSpeed = 55 }; 


// 调用 Equals() 的 结果 是 什么 

if (firstCar.Equals(secondCar)) 
Console.WritelLine("Same anonymous object!"); 

else 
Console.WriteLine("Not the same anonymous object!"); 


// 使 用 == 操 作 符 进行 比较 的 结果 是 什么 
if (firstCar == secondCar) 
Console.WritelLine("Same anonymous object!"); 
else 
Console.WriteLine("Not the same anonymous object!"); 


// 两 个 对 象 的 类 型 是 否 相 同 

if (firstCar.GetType().Name == secondCar.GetType() .Name) 
Console.WritelLine("We are both the same type!"); 

else 
Console.Writeline("We are different types!"); 


// 显示 两 个 匿名 类 的 细节 
Console.WriteLine(); 
ReflectOverAnonymousType(firstCar); 
ReflectOverAnonymousType(secondCar); 


下 


假设 从 Main() 中 调用 了 EqualityTest() 方 法 ， 输 出 结果 将 如 下 所 示 (多少 有 些 令 人 吃惊 ): 





My car is a Bright Pink Saab. 
You have a Black BMW going 90 MPH 
ToString() == { Make = BMW, Color = Black, Speed = 90 } 


Same anonymous object! 
Not the same anonymous object! 
We are both the same type! 


obj is an instance of: <>f AnonymousType0 3 

Base class of “>f_AnonymousType0`3 is System.0bject 
obj.ToString() == { Color = Bright Pink, Make = Saab, CurrentSpeed 
obj.GetHashCode() == -439083487 


obj is an instance of: <>f_AnonymousType0 `3 

Base class of “>f_AnonymousType0`3 is System.0bject 
obj.ToString() == { Color = Bright Pink, Make = Saab, CurrentSpeed 
obj.GetHashCode() == -439083487 


55 } 


55 } 


re 
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当 运行 前 面 的 测试 代码 时 ， 你 可 以 看 到 在 第 1 个 条 件 测试 中 , 调用 Equals() 返 回 了 true， 因 此 屏幕 
输出 “Same anonymous object!”。 这 是 因为 编译 器 重 写 的 Equals() 在 判断 对 象 相等 时 使 用 了 基于 值 的 
语义 (例如 比较 两 个 对 象 的 每 一 个 数据 成 员 的 值 )。 

尽管 如 此 ， 第 2 个 条 件 测试 (使 用 C# 的 相等 操作 符 == ) 输出 了 “Not the same anonymous object!”， 
这 可 能 与 部 分 人 的 答案 有 所 不 同 。 输 出 的 结果 之 所 以 有 点 违反 常理 ， 是 因为 匿名 类 型 并 没有 重 载 C# 
的 相等 操作 符 ( == 和 != )。 因 此 当 测 试 两 个 匿名 对 象 是 否 相 等 时 ， 使 用 “==”( 而 不 是 Equals() 方 法 ) 
将 比较 两 者 的 引用 ， 而 不 是 指向 的 内 容 。 

最 后 的 条 件 测试 (我 们 比较 两 个 对 象 的 类 型 名 是 否 相 同 ) 的 结果 表明 两 个 对 象 的 类 型 是 一 样 的 (都 
为 <>f AnonymousType0`3 ), 这 是 因为 firstCar 和 secondCar 拥 有 相同 的 属性 ( Color、 Make 和 CurrentSpeed )。 

这 就 演示 了 一 个 重要 且 微 妙 的 一 点 ， 只 有 当 匿 名 类 型 包含 匿名 类 型 的 唯一 名 字 时 ,编译 器 才 会 生成 
一 个 新 的 类 定义 。 因 此 , 如 果 我 们 在 同一 程序 集中 声明 两 个 相同 的 匿名 类 型 ( 同样 , 也 就 是 相同 的 名 字 )， 
编译 器 只 会 生成 一 个 匿名 类 型 的 定义 。 


11.5.5 包含 匿名 类 型 的 匿名 类 型 


我 们 可 以 创建 一 个 由 匿名 类 型 组 成 的 匿名 类 型 。 例 如, 你 需要 构建 一 个 购买 订单 , 它 包 含 时 间 惟 、 
价格 和 被 购买 的 汽车 。 下 面 是 一 个 新 的 匿名 类 型 ( 稍微 有 点 复杂 )， 用 于 表示 这 个 实体 : 


// 创建 一 个 由 匿名 类 型 组 成 的 匿名 类 型 

var purchaseItem = new { 
TimeBought = DateTime.Now, 
ItemBought = new {Color = "Red", Make = "Saab", CurrentSpeed = 55}, 
Price = 34.000}; 


ReflectOverAnonymousType(purchaseItem); 

现在 ,你 应 该 十 分 了 解 定义 匿名 类 型 的 语法 了 , 但 可 能 还 不 清楚 这 种 新 语言 特性 的 主要 用 处 在 哪 
里 。 其 实 ， 我 们 应 该 谨慎 地 使 用 匿名 类 型 ， 尤 其 在 使 用 LINQ 技 术 时 ( 第 12 章 将 会 介绍 )。 你 永远 不 要 
因为 匿名 类 型 的 出 现 而 放弃 使 用 强 类 型 的 类 或 者 结构 。 要 知道 ， 匿 名 类 型 本 身 有 很 多 的 限制 。 

口 你 并 没有 控制 匿名 类 型 的 名 称 。 

口 匿名 类 型 继承 System.0bject。 

口 匿名 类 型 的 字段 和 属性 总 是 只 读 的 。 

口 匿名 类 型 不 支持 事件 、 自 定义 方法 、 自 定义 操作 符 和 自 定义 重 写 。 

口 匿名 类 型 是 隐 式 封闭 的 ( sealed )。 

口 匿名 类 型 的 实例 创建 只 使 用 默认 构造 函数 。 

但 是 ,在 使 用 LINQ 技 术 编程 时 ， 我 们 可 能 需要 快速 构建 一 个 实体 的 形状 而 不 需要 定义 其 功能 ， 
这 时 你 会 发 现 匿名 类 型 的 好 处 。 





源 代 码 AnonymousTypes 项 目的 源 代码 位 于 Chapter 11 子 目录 下 。 
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11.6 ”指针 类 型 
现在 介绍 本 章 最 后 一 个 话题 ， 它 可 能 是 众多 C# 特 性 中 使 用 频率 最 低 的 。 


说 明 ”在 下 面 的 示例 中 ,假设 你 有 C/C++ 指针 操作 基础 ( 如 果 没 有 相关 背景 ,可 以 完全 跳 过 这 个 主题 )。 
再 次 强调 ,使 用 指针 并 不 是 编写 大 多 数 C# 应 用 程序 的 常见 任务 。 


在 第 4 章 中 ， 我 们 学 到 了 .NET 平 台 定 义 了 两 种 主要 数据 类 别 : 值 类 型 和 引用 类 型 。 实 际 上 还 有 第 
三 种 : 指针 类 型 。 要 使 用 指针 类 型 ， 系 统 为 我 们 提供 了 特定 操作 符 和 关键 字 ， 可 以 绕 开 CLR 的 内 存 管 
理 机 制 ， 自 己 处 理 ( 如 表 11-2 所 示 )。 


表 11-2 ”指针 相关 的 C# 操 作 符 和 关键 字 


操作 符 /关键 字 作 “用 
* 该 操作 符 用 于 创建 一 个 指针 变量 ( 也 就 是 一 个 表示 直接 内 存 位 置 的 变量 ) 。 和 在 C/C++ 
中 一 样 ， 同 样 的 操作 符 用 于 指针 间接 寻 址 
& 该 操作 符 用 于 获取 内 存 中 变量 的 地 址 
-5 该 操作 符 用 于 访问 一 个 由 指针 表示 的 类 型 的 字段 ( C# 点 操作 符 的 不 安全 版 本 ) 


[] 在 不 安全 的 上 下 文中 ，[] 操 作 符 允 许 我 们 索引 由 指针 变量 指向 的 位 置 ( 回顾 C/C++ 中 
指针 变量 和 [] 操 作 符 的 相互 影响 ) 


科 = 在 不 安全 的 上 下 文中 ， 递 增 和 有 递减 操作 符 可 用 于 指针 类 型 

Rt = 在 不 安全 的 上 下 文中 ， 加 减 操作 符 可 用 于 指针 类 型 

==, |=, <, >, <=, => 在 不 安全 的 上 下 文中 ， 比 较 和 相等 操作 符 可 用 于 指针 类 型 

stackalloc 在 不 安全 的 上 下 文中 ，stackalloc 关 键 字 可 用 于 直接 在 栈 上 分 配 C# 数 组 

fixed 在 不 安全 的 上 下 文中 ，fixed 关 键 字 可 用 于 临时 固定 一 个 变量 以 使 它 的 地 址 可 被 找到 


在 深入 细节 之 前 ,我 将 指出 需要 使 用 指针 类 型 的 情况 很 少 。 尽 管 C# 人 允许 深入 指针 操作 层面 ,但 要 
知道 .NET 运 行 库 对 我 们 的 意图 一 无 所 知 。 如 果 我 们 对 一 个 指针 操作 不 当 ， 就 要 自己 为 此 负责 。 既 然 有 
上 面 这 些 警 告 ， 还 有 什么 场合 需要 使 用 指针 类 型 呢 ? 有 两 种 情形 。 

口 要 绕 过 CLR 管 理 直 接 操作 指针 以 优化 应 用 程序 的 特定 部 分 。 

口 要 调用 基于 C 的 .dl! 或 调用 需要 指针 作为 参数 的 COM 服 务 器 。 即 使 在 这 种 情况 下 ， 为 了 支持 

System.IntPtr 类 型 和 System.Runtime.InteropServices.Marshal 类 型 ， 也 可 以 不 使 用 指针 类 型 。 

在 确实 需要 使 用 这 项 C# 语 言 特性 的 情况 下 , 我 们 应 通过 允许 项 目 支持 不 安全 代码 , 告知 C# 编 译 器 
(csc.exe ) 我 们 的 意图 。 在 使 用 C# 命 令 行 编译 器 (csc.exe ) 时 ， 仅 需 提供 如 下 的 /unsafe 标 志 作 为 参数 
即 可 : 

csc /unsafe *.cs 

在 Visual Studio 中 , 需要 访问 Properties 页 并 在 Build 选 项 卡 中 启用 Allow Unsafe Code 选 项 ( 如 图 11-2 
所 示 )。 首 先 创建 一 个 新 的 控制 台 应 用 程序 UnsafeCode ， 它 支持 不 安全 代码 ， 然 后 确保 它 启 用 了 这 项 
设置 。 
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图 11-2 ”使 用 Visual Studio 启 用 不 安全 代码 


11.6.1 ” unsafe 关键 字 


当 要 使 用 C# 中 的 指针 时 ， 必 须 使 用 unsafe 关 键 字 特别 声明 一 个 代码 区 块 为 不 安全 代码 。 不 标记 
unsafe 的 任何 代码 都 自动 按 “ 安 全 ”代码 对 待 。 例 如 ， 下 面 的 Program 类 在 安全 的 Main() 方 法 中 声明 了 
一 组 不 安全 的 代码 : 


class Program 


{ 


static void Main(string[] args) 
unsafe 


// 在 此 处 理 指针 类 型 


, // 不 能 在 此 处 理 指针 类 型 
} 
除了 声明 代码 块 为 不 安全 代码 外 ， 还 可 构建 “不 安全 的 ”结构 、 类 、 类 型 成 员 和 参数 。 下 面 是 截 
取 的 部 分 示例 (不必 在 当前 项 目 中 声明 Node 和 Node2 ): 


// 整个 结构 都 是 不 安全 的 ， 仅 可 用 于 unsafe 上 下 文中 
unsafe struct Node 


public int Value; 
public Node* Left; 
public Node* Right; 


// 这 个 结构 是 安全 的 ， 但 Node2* 成 员 不 安全 
// 从 技术 上 来 讲 ， 可 以 在 unsafe 上 下 文 之 外 访问 "Value" 
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// 但 不 能 在 unsafe 上 下 文 之 外 访问 "Left" 或 "Right" 
public struct Node2 


public int Value; 


// 这 些 只 能 在 unsafe 上 下 文中 访问 
public unsafe Node2* Left; 
public unsafe Node2* Right; 

} 


静态 方法 或 实例 方法 均 可 被 标记 为 不 安全 。 举 个 例子 , 假定 你 知道 一 个 指定 静态 方法 将 使 用 指针 
逻辑 。 为 确保 该 方法 仅 可 自 不 安全 上 下 文 调用 ， 可 以 按 如 下 代码 定义 该 方法 : 


unsafe static void SquareIntPointer(int* myIntPointer) 
{ 
// 将 这 个 值 平方 后 以 供 测 试 
*myIntPointer *= *myIntPointer; 
这 个 构造 要 求 调用 者 这 样 调用 squareIntPointer() 方 法 ， 如 下 所 示 : 
static void Main(string[] args) 
unsafe 
int myInt = 10; 
// 因为 是 在 不 安全 上 下 文中 
SquareIntPointer(&myInt); 
Console.WritelLine("myInt: {0}", myInt); 
int myInt2 = 5; 
// 编译 器 错误 | 必须 在 不 安全 上 下 文 


SquareIntPointer(&myInt2); 
Console.WritelLine("myInt: {0}", myInt2); 


如 果 不 想 强制 调用 者 将 调用 封装 进 不 安全 上 下 文 ， 可 以 利用 unsafe 关 键 字 修改 Main()。 此 时 ,将 
编译 如 下 代码 : 
unsafe static void Main(string[] args) 
int myInt2 = 5; 


SquareIntPointer(&myInt2); 
Console.WriteLine("myInt: {0}", myInt2); 


} 
运行 该 Main() 方 法 ， 将 得 到 如 下 所 示 的 输出 结果 : 





myInt: 25 





11.6.2 * 和 8& 操 作 符 


建立 了 不 安全 上 下 文 之 后 ， 可 以 使 用 * 操 作 符 构建 数据 类 型 的 指针 ， 使 用 8 操作 符 获 取 被 指向 的 内 
存 的 地 址 。 和 C、C++ 不 同 ， 在 C# 中 ，* 操 作 符 仅 被 用 于 底层 类 型 ， 而 不 是 每 个 指针 变量 名 的 前 级 。 举 
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个 例子 ， 下 列 代码 声明 了 两 个 变量 ,分 别 说 明了 声明 整 型 变量 指针 的 正确 方法 和 错误 方法 : 
// 错误 ! 在 C# 中 这 是 不 合法 的 
int *pi, *pj; 
// 正确 ! 这 才 是 C# 的 用 法 
int* pi, pj; 
思考 下 列 的 不 安全 方法 : 
unsafe static void PrintValueAndAddress() 


int myInt; 


// 定义 一 个 整数 指针 并 将 myInt 的 地 址 分 配给 它 
int* ptrToMyInt = &myInt; 


// 使 用 指针 间接 寻 址 为 myInt 赋 值 
*ptrToMyInt = 123; 


// 输出 一 些 状态 
Console.WriteLine("Value of myInt {0}", myInt); 


Console.WritelLine("Address of myInt {0:X}", (int)&ptrToMyInt); 
} 


11.6.3 ”不 安全 (与 安全 ) 交换 功能 
当然 ， 给 本 地 变量 声明 指针 只 是 进行 简单 赋值 ( 如 在 上 面 示例 中 所 示 ) ， 这 没有 必要 而 且 没有 用 
处 。 为 便于 说 明 更 为 实际 的 不 安全 代码 示例 ， 假 定 要 使 用 指针 算法 实现 一 个 交换 功能 : 
unsafe public static void UnsafeSwap(int* i, int* j) 
int temp = *i; 
村 = 村 
*j = temp; 
是 不 是 很 像 C 语 言 ? 不 过 ， 大 家 通过 前 面 的 学 习 ， 应 该 意识 到 我 们 可 以 使 用 C# ref 关 键 字 写 出 下 
列 交换 算法 的 安全 版 本 : 
public static void SafeSwap(ref int i, ref int j) 
int temp = 从 


i=j; 
j = temp; 


两 个 方法 的 功能 都 是 一 样 的 ， 再 次 强调 ， 直 接 指 针 操作 并 不 是 C# 下 的 必要 任务 。 下 面 是 使 用 安全 
Main() 和 不 安全 上 下 文 的 调用 逻辑 : 


static void Main(string[] args) 
Console.WritelLine("***** Calling method with unsafe code *****"); 


// 以 备 交换 的 值 
int i = 10, j = 20; 
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// 安全 交换 两 个 值 

Console.WriteLine("\n***** Safe Swap *****"); 
Console.WriteLine("Values before safe swap: i = {0}, j = {1}", i, j); 
SafeSwap(ref i, ref j); 

Console.WriteLine("Values after safe swap: i = {0}, j = {1}", i, j); 


// 不 安全 交换 两 个 值 
Console.WriteLine("\n***** Unsafe swap *****"); 
Console.WriteLine("Values before unsafe swap: i = {0}, j = {1}", i, j); 


unsafe { UnsafeSwap(&i, &j); } 


Console.WriteLine("Values after unsafe swap: i = {0}, j = {1}", i, j); 
Console.ReadLine(); 


11.6.4 ”通过 指针 访问 字段 
假定 定义 了 一 个 Point 结 构 的 指针 : 
struct Point 


public int x; 
public int y; 


public override string ToString() 
return string.Format("({0}, {1})", x, y); 
} 
} 
如 果 声 明 一 个 Point 类 型 的 指针 , 就 需要 使 用 指针 字段 访问 操作 符 ( -> ) 来 访问 公共 成 员 。 如 表 11-2 
所 示 ， 这 是 标准 ( 安全 ) 的 点 操作 符 的 不 安全 版 本 。 事 实 上 ， 使 用 指针 间接 寻 址 操作 符 (* ) 来 解除 
指针 的 引用 ， 使 其 也 可 以 使 用 点 操作 符 访问 字段 。 看 看 下 面 的 不 安全 方法 : 


unsafe static void UsePointerToPoint() 


// 通过 指针 访问 成 员 

Point point; 

Point* p = &point; 

p->x = 100; 

p->y = 200; 
Console.WriteLine(p->ToString()); 


// 通过 指针 间接 寻 址 访问 成 员 

Point point2; 

Point* p2 = &point2; 

(*p2) .xX = 100; 

(*p2).y = 200; 

Console.WritelLine((*p2).ToString()); 
} 


11.6.5 ”stackalloc 关 键 字 
在 不 安全 上 下 文中 ,可 能 需要 声明 一 个 直接 从 调用 栈 分 配 内 存 (不 受制 于 .NET 垃 圾 收集 器 ) 的 本 
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地 变量 。C# 提 供 了 与 C 运 行 库 函数 alloca 等 效 的 stackalloc 关 键 字 来 满足 这 个 要 求 。 简 单 示例 如 下 : 
unsafe static void UnsafeStackAlloc() 


char* p = stackalloc char[256]; 
for (int k = 0; k < 256; k++) 
p[k] = (char)k; 


11.6.6 ”使 用 fixed 关 键 字 固定 类 型 


在 前 一 个 示例 中 看 到 , 通过 使 用 stackalloc 关 键 字 , 在 不 安全 上 下 文中 分 配 一 大 块 内 存 非常 方便 。 
从 这 个 操作 的 本 意 来 说 ， 由 于 被 分 配 的 内 存 是 从 栈 中 获得 的 ， 当 分 配方 法 返回 的 时 候 ， 被 分 配 的 内 存 
立即 被 清理 。 再 思考 一 个 更 为 复杂 的 示例 。 在 我 们 讨论 -> 操作 符 的 时 候 ， 创 建 了 名 为 Point 的 值 类 型 。 
和 其 他 值 类 型 一 样 ， 分 配 的 内 存在 执行 代码 块 终止 后 将 出 栈 。 为 了 讨论 方便 ， 假 定 Point 被 定义 为 一 
个 引用 类 型 : 

class PointRef // 重 命名 和 重新 定义 类 型 后 的 <= 

| public int x; 


public int y; 
public override string ToString() 


return string.Format("({0}, {1})", x, y); 

} 

要 注意 ， 如 果 调 用 者 声明 了 一 个 Point 类 型 的 变量 ， 内 存 将 被 分 配 在 垃圾 收集 堆 上 。 这 时 严重 的 
问题 出 现 了 ， 如 果 一 个 不 安全 上 下 文 要 与 这 个 对 象 ( 或 这 个 堆 上 的 任何 对 象 ) 交互 ， 又 该 怎么 办 呢 ? 
由 于 垃圾 收集 可 随时 发 生 ， 设 想 一 下 恰好 在 清理 堆 的 时 候 访问 Point 成 员 ， 该 是 多 么 痛苦 啊 ! 理论 上 
来 讲 , 不 安全 上 下 文 能 够 进行 交互 的 成 员 包 括 : 不 再 允许 访问 的 成 员 或 堆 上 经 清扫 后 已 被 重 置 的 成 员 ， 
但 这 很 明显 有 问题 。 

为 了 将 不 安全 上 下 文 内 存 中 的 引用 类 型 变量 固定 ，C# 提 供 了 人 有 xed 关键 字 。fixed 语 句 设 置 指向 托 
管 类 型 的 指针 并 在 代码 执行 过 程 中 固定 该 变量 。 由 于 垃圾 收集 器 将 在 不 可 预知 的 情况 下 重 置 变 量 ， 没 
有 fixed 的 话 ， 托 管 变量 的 指针 将 没有 多 大 用 处 。 (事实 上 ， 除 了 在 fixed 语 句 中 ，C# 编 译 器 不 允许 设 
置 指向 托管 变量 的 指针 。 ) 

不 过 , 如果 创 建 了 一 个 Point 类 型 并 想 与 它 的 成 员 交互 , 必须 写 下 列 代码 , 否则 将 收 到 编译 器 错误 : 

unsafe public static void UseAndPinPoint() 

PointRef pt = new PointRef (); 


pt.x = 5; 
pt.y = 6; 


// 在 适当 位 置 固定 pt 以 免 GC 除 去 
fixed (int* p = &pt.x) 


6 
、 // 在 此 使 用 int* 变 量 


// pt 现 未 被 固定 ， 在 该 方法 完成 后 可 被 GC 清除 





352 “第 11 章 高 级 C# 语 言 特性 
Console.WriteLine ("Point is: {0}", pt); 


简 而 言 之 ，fixed 关 键 字 允许 我 们 构建 锁定 内 存 中 引用 变量 的 语句 ， 这 样 一 来 ， 在 该 语句 的 执行 过 
程 中 , 该 变量 地 址 保持 不 变 。 是 的 , 任何 时 候 在 不 安全 代码 上 下 文中 与 引用 类 型 交互 , 都 要 固定 该 引用 。 


11.6.7 ”sizeof 关键 字 


最 后 一 个 不 安全 相关 的 C# 关 键 字 是 sizeof。 和 C/C++ 相 比 而 言 ，C# 的 sizeof 关 键 字 用 来 获取 值 类 
型 (不 是 引用 类 型 ) 的 字 节 大 小 , 它 仅 可 被 用 在 不 安全 上 下 文中 。 与 基于 C 的 非 托管 API 交 互 时 ,这 种 
能 力 非常 有 用 。 它 的 用 法 很 简单 : 


unsafe static void UseSizeOfOperator() 


Console.WritelLine("The size of short is {0}.", sizeof(short)); 
Console.WriteLine("The size of int is {0}.", sizeof(int)); 
Console.WriteLine("The size of long is {0}.", sizeof(long)); 


sizeof 可 计算 任何 System.ValueType 派 生 实 体 的 字 节 数 , 也 可 以 获取 自 定义 结构 的 大 小 。 例 如 , 假 
设 将 point 结构 传人 sizeof : 


unsafe static void UseSizeOfOperator() 


Console.MWriteLine("The size of Point is {0}.", sizeof(Point)); 


源 代码 ”UnsafeCode 项 目的 源 代码 位 于 Chapter 12 子 目录 下 。 


本 章 介 绍 了 C# 编 程 语言 中 一 些 更 加 高 级 的 特性 。 为 了 证 明 我 们 是 在 一 条 船上 ， 我 必须 再 次 说 明 ， 
大 多 数 .NET 项 目 都 不 需要 直接 使 用 这 些 特性 ( 特别 是 指针 )。 然 而 我 们 将 在 下 一 章 看 到 , 在 使 用 LINQ 
API 时 ， 一 些 特性 是 非常 有 用 的 ， 特 别 是 扩展 方法 和 匿名 类 型 。 


11.7 小结 


本 章 的 目的 在 于 加 深 大 家 对 C# 编 程 语言 的 理解 。 首 先 , 我 们 讨论 了 各 种 高 级 类 型 的 构造 技巧 ( 索 
引 咒 方法 、 重 载 操作 符 和 自 定义 转换 例 程 )。 

接 下 来 我们 学 习 了 扩展 方法 和 匿名 类 型 的 作用 。 下 一 章 中 你 将 看 到 ， 这 些 特性 在 LINQ 相 关 的 
API 中 十 分 有 用 ( 当然 你 可 以 在 任何 地 方 使 用 这 些 特 性 ,并 且 它 们 也 十 分 有 用 )。 匿 名 方法 可 以 快速 构 
建 类 型 的 “轮廓 ”"， 扩 展 方法 可 以 为 类 型 添加 新 的 功能 (不 需要 创建 子 类 )。 

最 后 学 习 了 如 何 使 用 原始 的 指针 类 型 ， 同 时 介绍 了 一 些 不 为 人 知 的 关键 字 ( sizeof 和 unsafe 等 )。 
绝 大 多 数 C# 应 用 程序 都 没 必要 使 用 指针 类 型 。 





LINQ to Object 





尽管 使 用 NET 平 台 创建 何 种 应 用 程序 ， 都 需要 在 执行 时 访问 某 种 形式 的 数据 , 如 XML 文件 、 
关系 数据 库 、 内 存 中 的 集合 、 基 元 数组 等 。 数 据 是 无 处 不 在 的 。 过 去 ， 根 据 数据 位 置 的 
不 同 , 程序 员 需 要 使 用 不 同 且 不 相关 的 API。.NET3.5 引 入 了 语言 集成 查询 (LINQ ), 它 提供 了 一 种 
简明 的 、 对 称 的 、 强 类 型 的 方式 访问 各 种 各 样 的 数据 存储 。 本 章 将 开始 研究 LINQ， 首 先 关 注 的 是 
LINQ to Object-。 
在 介绍 LINQ to Object 之 前 ， 本 章 将 快速 浏览 C# 中 与 LINQ 相 关 的 关键 语言 结构 。 在 学 习 本 章 时 ， 
你 会 发 现 隐 式 类 型 本 地 变量 、 对 象 初始 化 语法 、Lambda 表 达 式 、 扩 展 方 法 以 及 匿名 类 型 都 是 非常 有 用 
的 ( 当然 我 指 的 不 是 为 了 用 而 用 )。 
回顾 了 支持 的 基础 设施 之 后 ， 本 章 余 下 的 内 容 将 向 你 展示 LINQ 编 程 模型 和 它 在 .NET 平 台中 的 作 
用 。 还 有 ， 你 将 开始 学 习 查 询 操 作 符 和 查询 表达 式 的 作用 ， 这些 东西 允许 你 定义 语句 来 对 数据 源 进行 
查询 ， 获 取 所 请 求 的 结果 集 。 与 此 同时 ， 你 将 构建 许多 LINQ 例 程 ， 与 包含 在 数组 和 集合 类 型 ( 包括 
泛 型 和 非 泛 型 ) 里 的 数据 交互 。 此 外 ,你 还 会 学 到 程序 集 、 命名 空间 和 表示 LINQ to ObjectAPI 的 类 型 。 





说 明 本 章 所 涵盖 的 内 容 是 其 他 LINQ 技 术 的 基础 ， 如 LINQ to XML (参见 第 24 章 ) 、 并 行 LINQ ( 参 
见 第 19 章 ) 和 LINQ to Entity ( 参见 第 23 章 ) 。 





12.1 LINQ 特有 的 编程 结构 


从 宏观 上 看 ，LINQ 可 以 理解 为 直接 艇 人 C#i 滞 法 的 强 类 型 查询 语言 。 使 用 LINQ， 可 以 构建 与 数 
据 库 SQL 查询 类 似 的 表达 式 。 但 LINQ 查 询 可 以 用 于 多 种 数据 存储 ,甚至 与 关系 型 数据 库 完全 无 关 的 


说 明 尽管 LINQ 查 询 看 起 来 与 SQL 查询 很 像 ， 但 语法 却 并 不 相同 。 实 际 上 ,很 多 LINQ 查 询 的 格式 看 
上 去 与 类 似 的 数据 库 查 询 完全 相反 ! 如 果 要 将 LINQ 直 接 映射 为 SQL， 你 肯定 会 很 肖 豆 。 为 了 
保持 清醒 ， 我 建议 你 尽量 把 LINQ 查 询 看 成 是 独特 的 语句 ， 它 只 是 “碰巧 看 上 去 ” 像 SQL 而 已 。 


当 .NET 3.5 平 台 首次 引入 LINQ 时 , C# 和 VB 语言 为 了 支持 LINQ 技 术 集 , 扩展 了 大 量 新 的 编程 结构 。 
其 中 C# 使 用 了 如 下 与 LINQ 相 关 的 特性 : 
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口 隐 式 类 型 本 地 变量 

口 对 象 /集合 初始 化 语法 

口 Lambda 表 达 式 

口 扩展 方法 

口 匿名 类 型 

本 书 已 经 在 不 同 章节 中 详细 介绍 了 这 些 特性 。 但 为 了 确保 已 经 掌握 了 这 些 特性 ,我 们 先 对 它们 进 
行 一 次 快速 的 浏览 。 


12.1.1 隐 式 类 型 本 地 变量 


我 们 在 第 3 章 中 学 习 了 C# 的 var 关 键 字 。 它 允许 你 定义 不 显 式 指定 实际 数据 类 型 的 本 地 变量 。 不 过 
由 于 编译 器 将 根据 初始 值 推断 其 数据 类 型 ， 所 以 该 变量 仍然 是 强 类 型 的 。 回 忆 一 下 第 3 章 中 的 这 个 
示例 : 
static void DeclareImplicitVars() 
// 隐 式 类 型 本 地 变量 
var myInt = 0; 


var myBool = true; 
var myString = "Time, marches on..."; 


// 打印 实际 类 型 

Console.WriteLine("myInt is a: {0}", myInt.GetType().Name); 

Console.WritelLine("myBool is a: {0}", myBool.GetType().Name); 

Console.WriteLine("myString is a: {0}", myString.GetType().Name); 
} 


在 使 用 LINQ 时 , 这 项 语言 特性 十 分 有 帮助 , 并 且 常 常 是 强制 性 的 。 在 本 章 中 你 将 看 到 , 许多 LINQ 
查询 返回 的 序列 只 有 在 编译 时 才能 确定 其 数据 类 型 。 由 于 只 有 在 应 用 程序 编译 之 后 才能 知道 其 实际 的 
数据 类 型 ， 所 以 显然 无 法 显 式 地 声明 变量 。 


12.1.2 ”对 象 和 集合 初始 化 语法 


第 5 章 介 绍 了 对 象 初始 化 语法 的 作用 ， 它 允许 我 们 在 创建 类 或 结构 变量 的 同时 设置 其 属性 。 最 终 
得 到 的 是 紧凑 的 ( 且 易 读 的 ) 语法 和 创建 好 的 对 象 。 同 样 回忆 第 9 章 ，C# 语 言 还 允许 我 们 使 用 非常 类 
似 的 语法 初始 化 集合 对 象 。 考虑 下 面 的 代码 段 , 它 使 用 集合 初始 化 语法 填充 Rectangle 对 象 的 List<T>， 
其 中 每 个 Rectangle 包 含 两 个 Point 对 象 ， 表 示 (x, y) 坐 标 : 


List<Rectangle> myListOfRects = new List<Rectangle> 


new Rectangle {TopLeft = new Point { X = 10, Y = 10 }, 
BottomRight = new Point { X = 200, Y = 200}}, 

new Rectangle {Topleft = new Point { X= 2, Y= 2 }, 
BottomRight = new Point { X = 0 ;Y= 100}}, 

new Rectangle {TopLeft = new Point { X= 5, Y= 5 }, 
BottomRight = new Point { X = 证 了 二 滞 扩 


$3 , 
尽管 没有 要 求 必 须 使 用 集合 /对 象 初始 化 语法 , 但 这 样 可 以 得 到 更 紧凑 的 代码 结构 。 此 外 ， 当 它们 
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与 隐 式 类 型 本 地 变量 相 结 合 时 ， 可 以 声明 匿名 类 型 ， 这 在 创建 LINQ 投 影 时 也 是 十 分 有 用 的 。 本 章 稍 
后 将 学 习 LINQ 投 影 。 


12.1.3 ” Lambda 表达 式 

我 们 在 第 10 章 中 充分 介绍 了 C# Lambda 操 作 符 ( => )， 它 可 以 用 来 构建 Lambda 表 达 式 ， 并 且 在 调 
用 以 强 类 型 的 委托 作为 参数 的 方法 时 ， 也 十 分 有 用 。Lambda 大 大 简化 了 .NET 委 托 的 使 用 , 减少 了 需 
要 手工 输入 的 代码 。Lambda 表 达 式 的 用 法 如 下 : 

(ArgumentsToProcess) => {StatementsToProcessThem} 

在 第 10 章 中 , 我 使 用 了 3 种 不 同 的 方法 与 泛 型 List<T> 类 的 FindA11() 方 法 进行 交互 。 在 使 用 原始 的 
Predicate<T> 委 托 和 C# 甘 名 方法 之 后 , 我 们 使 用 Lambda 表 达 式 得 到 了 如 下 所 示 的 (极其 简洁 的 ) 迭 代 : 


static void LambdaExpressionSyntax() 


// 建 一 个 整数 列表 
List<int> list = new List<int>(); 
list.AddRange(new int[] { 20, 1, 4, 8, 9, 44 }); 


// C# Lambda 表 达 式 
List<int> evenNumbers = list.FindAll(i => (i % 2) == 0); 


Console.WriteLine("Here are your even numbers:"); 
foreach (int evenNumber in evenNumbers) 


Console.Write("{0}\t", evenNumber); 
Console.WritelLine(); 
在 使 用 LINQ 对 象 模型 时 ，Lambda 是 非常 有 用 的 。 稍 后 你 会 发 现 ，C# LINQ 查 询 操 作 符 是 调用 


System.Linq.Enumerable 类 中 方法 的 简便 方式 。 这 些 方 法 通常 都 使 用 委托 ( 如 Func<> 委 托 ) 作为 参数 ， 
用 来 处 理 数据 以 生成 正确 的 结果 集 。 使 用 Lambda 表 达 式 可 以 精简 代码 ,并 且 让 编译 器 来 推断 实际 的 委托 。 


12.1.4 扩展 方法 


C# 扩 展 方法 不 使 用 子 类 就 能 够 向 已 知 类 中 添加 新 的 功能 。 同样 , 它 还 可 以 向 不 能 有 子 类 的 密封 类 
和 结构 中 添加 新 的 功能 。 回 忆 第 11 章 ， 在 编写 扩展 方法 时 ， 第 一 个 参数 必须 使 用 this 限 定 符 ， 用 来 表 
示 被 扩展 的 类 型 。 扩 展 方法 只 能 定义 在 静态 类 中 ,并且 必 须 使 用 static 关 键 字 声明 为 静态 方法 。 例如 : 
namespace MyExtensions 


static class ObjectExtensions 


站 
// 为 System.0bject 定 义 扩展 方法 
public static void DisplayDefiningAssembly(this object obj) 


Console.WriteLine("{0} lives here:\n\t->{1}\n", obj.GetType().Name, 
Assembly.GetAssembly(obj.GetType())); 
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要 使 用 该 扩展 ， 应 用 程序 必须 导入 定义 扩展 的 命名 空间 ( 可 能 需要 设置 到 外 部 程序 集 的 引用 )。 
然后 ， 引 入 定义 的 命名 空间 ,编写 如 下 代码 : 


static void Main(string[] args) 


{ 

// 由 于 任何 类 型 部 扩展 自 System.0bject， 因 此 所 有 类 和 结构 都 可 以 使 用 该 扩展 方法 
int myInt = 12345678; 
myInt.DisplayDefiningAssembly(); 


System.Data.DataSet d = new System.Data.DataSet(); 
d.DisplayDefiningAssembly(); 
Console.ReadLine(); 


在 使 用 LINQ 时 ， 很 少 需要 手工 构建 扩展 方法 。 但 在 创建 LINQ 查 询 表达 式 时 ， 你 实际 上 是 在 使 用 
微软 已 经 定义 的 大 量 扩 展 方 法 。 其 实 ， 每 个 C# LINQ 查 询 操作 符 都 是 一 种 简便 记 法 ， 用 来 调用 定义 在 
System.Linq.Enumerable 工 具 类 中 的 扩展 方法 。 


12.1.5 ”匿名 类 型 


最 后 一 个 要 快速 浏览 的 C# 滞 言 特性 是 匿名 类 型 ,这 已 经 在 第 11 章 中 进行 了 完整 的 介绍 。 该 特性 可 
以 快速 建立 数据 的 “结构 "” ， 编 译 器 将 根据 名 称 / 值 对 的 集合 在 编译 时 生成 新 的 类 。 该 类 型 是 基于 值 的 
语义 构建 的 ,因此 System.0bject 中 的 每 个 虚 方法 都 要 重 写 。 要 定义 一 个 匿名 类 型 ， 可 以 声明 一 个 隐 式 
类 型 变量 ， 并 使 用 对 象 初始 化 语法 指定 数据 的 结构 : 


// 创建 一 个 由 匿名 类 型 组 成 的 匿名 类 型 

var purchaseItem = new { 
TimeBought = DateTime.Now, 
ItemBought = new {Color = "Red", Make = "Saab", CurrentSpeed = 55}, 
Price = 34.000}; 


LINQ 经 常 使 用 匿名 类 型 在 运行 时 投影 新 的 数据 形式 。 例 如 ， 假 设 我 们 有 一 个 Person 对 象 的 集合 ， 
希望 使 用 LINQ 获 得 年 龄 和 社会 保险 号 码 的 信息 。 使 用 LINQ 投 影 ， 可 以 使 编译 器 生成 新 的 包含 这 些 信 
息 的 匿名 类 型 。 


12.2 LINQ 的 作用 


我 们 介绍 完了 能 够 使 LINQ 如 此 神奇 的 C## 滞 言 特性 。 但 是 ，LINQ 为 什么 如 此 重要 呢 ?” 作 为 软件 开 
发 人 员 ， 很 难 否 认 我 们 很 大 一 部 分 编程 时 间 都 是 花 在 获取 和 操作 数据 上 的 。 说 到 “数据 ”， 大 概 就 会 
自然 而 然 地 想到 包含 在 关系 数据 库 里 的 信息 。 另 一 个 很 流行 的 数据 格式 是 XML 文 档 ， 例 如 *.config 文 
件 、 保 存在 本 地 的 Dataset 、 从 WCF 服 务 返回 的 内 存 中 的 数据 等 。 

除了 这 两 个 常见 的 信息 来 源 外 ,还 能 在 许多 地 方 找到 数据 。 例 如 ， 如果 你 有 个 List<T> 泛 型 ,内 含 
300 个 整数 ， 你 要 获取 满足 某 个 给 定 条 件 〈 例 如 ， 仅 奇数 或 偶数 ， 仅 质数 ， 仅 大 于 50 的 不 重复 数字 等 ) 
的 子 集 。 或 者 ， 你 也 许 要 利用 反射 API， 从 一 个 Type 数组 中 只 想得到 从 一 个 特定 父 类 继承 而 来 的 每 个 
类 型 的 元 数据 描述 。 显 而 易 见 ， 数 据 随 处 可 见 。 

在 .NET3.5 之 前 的 版 本 中 , 与 特定 类 型 的 数据 打交道 时 , 程序 员 要 使 用 不 同 的 API。 例如 ,考虑 一 
下 表 12-1， 它 列 出 了 操作 各 种 数据 类 型 的 常见 API (我 确定 你 可 以 想到 很 多 其 他 示例 )。 
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表 12-1 操作 各 种 数据 的 方式 





我 们 想 要 的 数据 得 到 这 些 数 据 的 方式 
关系 数据 System.Data.d11 和 System.Data.SqlClient.d11 等 
XML 文档 数据 System.Xm1l.d]1 
元 数据 表 System.Reflection 命 名 空间 
对 象 集合 System.Array 和 System.Collections/System。 


Collections .Generic 命 名 空间 


当然 ， 这 些 操作 数据 的 方法 一 点 也 没 问 题 。 实 际 上 ， 你 肯定 会 直接 使 用 ADO.NET、XML 命 名 空 
间 、 反 射 服务 以 及 各 种 集合 类 型 。 但 是 ， 基 本 的 问题 在 于 ， 这 些 API 的 每 一 种 本 身 只 是 孤岛 ， 提 供 极 
少 的 集成 方式 。 没 错 ， 例 如 ， 你 能 把 ADO.NET DataSet 保 存 成 XML， 然 后 通过 System.Xml 命 名 空间 来 
操作 。 但 尽管 如 此 ， 目 前 的 数据 操作 依然 相当 不 对 称 。 

LINQ ( 语言 级 集成 查询 ) API 的 意图 是 提供 一 种 统一 且 对 称 的 方式 ， 让 程序 员 在 广义 的 数据 上 得 
到 和 操作 “数据 "。 通 过 使 用 LINQ ， 我 们 能 够 在 C# 编 程 语 言 内 直接 创建 被 称 为 查询 表达 式 (query 
expression ) 的 实体 。 这 些 查询 表达 式 是 基于 许多 查询 操作 符 ( query operator ) 的 ， 而 且 是 有 意 设计 成 
类 似 SQL 表 达 式 的 。 

但 不 同 之 处 在 于 , 查询 表达 式 可 以 被 用 来 与 许多 种 数据 类 型 交互 ， 即 使 是 那些 与 关系 数据 库 毫 无 
关系 的 数据 。 具 体 来 说 ，LINQ 是 用 来 描述 数据 访问 总 体 方式 的 术语 。 根 据 LINQ 查 询 应 用 的 场景 ， 可 
以 分 为 以 下 几 个 部 分 。 

口 LINQ to Object: 针对 数组 和 集合 使 用 的 LINQ 查 询 。 

口 LINQ to XML: 使 用 LINQ 来 操纵 和 查询 XML 文档 。 

口 LINQ to DataSet: 针对 ADO.NET DataSet 对 象 使 用 的 LINQ 查 询 。 

口 LINQ to Entity: 对 ADO.NET Entity Framework ( EF ) API 使 用 的 LINQ 查 询 。 

口 Parallel LINQ ( PLINQ ): 并 行 处 理 LINQ 查 询 返 回 的 数据 。 

可 以 肯定 的 是 , 微软 致力 于 在 .NET 编 程 环 境 中 集成 对 于 LINQ 的 支持 。 如 今 ，LINQ 已 经 成 为 .NET 
基础 类 库 、 托 管 语言 和 Visual Studio 不 可 分 割 的 一 部 分 。 


12.2.1 LINQ 表 达 式 是 强 类 型 的 


需要 特别 指出 的 是 ，LINQ 查 询 表 达 式 〈( 跟 传统 的 SQL 语句 有 所 不 同 ) 是 强 类 型 的 。 所 以 ，C# 编 
译 融 会 让 我 们 老 老实 实地 保证 这 些 表 达 式 在 语法 上 是 合法 的 。 另 外 需要 注意 的 是 ,查询 表达 式 在 利用 
它们 的 程序 集中 拥有 对 应 的 元 数据 表示 ， 因 为 C# LINQ 查 询 表达 式 总 是 构建 丰富 的 基本 对 象 模型 。 像 
Visual Studio 这 样 的 工具 可 以 使 用 这 个 元 数据 来 提供 诸如 智能 感知 、 自 动 完 成 等 有 用 的 功能 。 


12.2.2 ”核心 LINQ 程 序 集 


第 2 章 提 到 过 ，Visual Studio 的 New Project 对 话 框 中 有 一 个 选项 ， 我 们 可 以 使 用 下 拉 框 来 选择 希望 
编译 针对 的 .NET 平 台 版 本 。 如 果 选 择 针对 .NET 3.5 或 者 更 高 版 本 编译 ， 每 一 个 项 目 模板 都 会 自动 引用 
LINQ 程 序 集 ( 它们 可 以 通过 Solution Explorer 查 看 )。 表 12-2 描 述 了 核心 LINQ 程 序 集 的 作用 。 但 是 在 本 
书 其 他 部 分 ， 你 会 遇 到 其 他 LINQ 库 。 
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表 12-2 ”核心 LINQ 程 序 集 





程 序 集 内 容 描述 
”System.Core.dll 定义 了 代表 核心 LINQ API 的 类 型 。 如果 你 想 使 用 任何 LINQ API ( 包括 ， 
LINQ to Object )， 这 是 你 必须 访问 的 程序 集 
System.Data.DataSetExtensions .d]11 定义 了 许多 类 型 来 将 ADO.NET 类 型 融入 LINQ 编 程 范式 ( LINQ to 
DataSet ) 
System.Xm1l.Linq.dl1 提供 了 使 用 LINQ 处 理 XML 文档 数据 所 需 的 功能 (LINQ to XML ) 


为 了 使 用 LINQ to Object， 我 们 必须 确保 每 个 包含 LINQ 查 询 的 代码 文件 都 导入 System.Linq 命 名 空 
间 ( 主要 定义 在 System.Core.dll 中 )。 否 则 将 会 出 现 很 多 问题 。 按 经 验 来 说 ,将 会 出 现 类 似 下 面 的 编译 
器 错误 : 


RNG 


Error 1 Could not find an implementation of the query pattern for source type 'int[]'. 
"Where” not found. Are you missing a reference to 'System.Core.dll' or a using directive 
for 'System.Linq'? 








而 此 时 你 的 C# 文 件 中 很 可 能 没有 下 面 的 using 指 令 ( 赁 经 验 来 说 ): 


using System.Linq; 


12.3 将 LINQ 查询 应 用 于 原始 数组 


为 开始 研究 LINQ to Object， 让 我 们 先 建立 一 个 应 用 程序 ， 其 中 会 将 LINQ 查 询 应 用 于 各 种 数组 对 
象 。 创 建 一 个 名 为 LinqOverArray 的 控制 台 应 用 程序 ， 在 Program 类 里 定义 一 个 名 为 QueryOverStrings() 
的 静态 辅助 方法 。 在 这 个 方法 里 ,创建 一 个 字符 串 数组 ， 内 含 大 约 6 个 你 喜欢 的 字符 串 ( 这 里 ， 我 列 
出 了 几 个 我 目前 试图 完成 的 电视 游戏 )。 要 确保 至 少 有 两 项 包含 数字 ， 一 些 项 包含 空格 。 


static void QueryOverStrings() 


{ 
// 假定 我 们 有 一 个 字符 串 数组 
string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 
} 


最 后 ， 更 新 Main() 来 调用 QueryOverStrings(): 
static void Main(string[] args) 
Console.WriteLine("***** Fun with LINQ to Objects *****\n"); 


QueryOverStrings(); 
Console.ReadLine(); 


当 你 有 任意 一 组 数据 时 ， 你 经 常会 根据 给 定 的 要 求 提取 一 个 数据 项 子 集 。 也 许 你 只 想得到 内 含 数 
字 的 子 项 (例如 ，System Shock 2、Uncharted 2 和 Fallout 3 )， 或 者 长 度 大 于 某 个 数目 的 子 项 ， 或 者 不 
含 空格 的 子 项 ( 例如 ，Morrowind 或 Daxter )。 虽 然 你 可 以 使 用 System.Array 类 型 的 成 员 方法 来 完成 这 
样 的 工作 ,但 肯定 会 费 点 劲 ， 而 LINQ 查 询 表 达 式 却 能 极 大 地 简化 这 个 过 程 。 
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再 假设 你 只 想 从 数组 中 得 到 包含 空格 的 项 ， 并 让 它们 按照 字母 顺序 排序 ,我 们 可 以 建立 下 面 这 样 
的 查询 表达 式 : 


static void QueryOverStrings() 


// 假定 我 们 有 一 个 字符 串 数 组 
string[] currentVideoGames = {"Morrowind", "Uncharted 2 ， 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 构建 一 个 查询 表达 式 ， 来 代表 数组 中 有 一 个 空格 的 项 
IEnumerable<string> subset = from g in currentVideoGames 
where g.Contains(" ") orderby g select g; 


// 输出 结果 
foreach (string s in subset) 
Console.WriteLine("Item: {0}", s); 


注意 ， 刚 建立 的 查询 表达 式 利用 了 from、in、where、orderby 和 select 这 几 个 LINQ 查 询 操作 符 。 
我 们 不 久 就 会 深入 探究 查询 表达 式 的 完整 句法 ,但 即使 现在 ， 你 应 该 也 能 将 这 个 语句 分 析 成 “把 那些 
名 字 中 包含 空格 的 currentVideoGames 中 的 项 按 字 母 表 顺序 排序 ”。 

在 这 里 ， 符 合 这 个 条 件 的 项 命名 为 “g”( “游戏 ”的 英文 game 中 的 首 字母 )。 但 是 ， 任 何 合法 的 
C# 变 量 名 都 可 以 用 在 这 里 ， 例 如 : 


IEnumerablex<string> subset = from game in currentVideoGames 
where game.Contains(" ") orderby 
game select game; 


最 后 请 注意 ,“ 结 果 集 ”是 由 一 个 实现 了 IEnumerable<T> 泛 型 版 本 的 对 象 来 表示 的 ， 这 里 T 是 
System.String 类 型 ( 我 们 毕 况 是 在 查询 一 个 字符 串 数 组 )。 在 得 到 结果 集 后 ,我 们 可 以 使 用 标准 的 
foreach 语 句 简 单 地 输出 每 个 字符 串 项 。 如 果 运 行 应 用 程序 ， 得 到 的 输出 结果 如 下 所 示 : 





****** Fun with LINO to Objects ***** 
Item: Fallout 3 

Item: System Shock 2 

Item: Uncharted 2 





12.3.1 再 一 次 ， 不 使 用 LINQ 


要 知道 ，LINQ 永 远 都 不 是 强制 使 用 的 。 如 果 不 使 用 LINQ， 而 使 用 if 语 句 、for 循 环 之 类 的 编程 基 
元 ， 也 可 以 得 到 相同 的 结果 。 下 面 的 方法 能 够 产生 和 Query0verStrings() 方 法 相同 的 结果 ， 只 不 过 更 
加 烦琐 : 

static void QueryOverStringsLongHand() 

{ 

// 假定 我 们 有 一 个 字符 囊 数组 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


string[] gamesWithSpaces = new string[5]; 
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for (int i = 0; i < currentVideoGames.Length; i++) 


if (currentVideoGames[i].Contains(" ")) 
gamesWithSpaces[i] = currentVideoGames[i]; 


// 排序 
Array.Sort(gamesWithSpaces); 


// 打印 结果 
foreach (string s in gamesWithSpaces) 


if( s != null) 
Console.WritelLine("Item: {0}", s); 


Console.WritelLine(); 


我 知道 上 面 的 方法 还 可 以 进一步 调整 和 简化 ， 但 无 法 改变 一 个 事实 ， 即 用 LINQ 查 询 从 数据 源 中 
提取 数据 子 集 要 容易 得 多 。 只 要 创建 了 恰当 的 LINQ 查 询 ，C# 编 译 器 就 可 以 为 我 们 执行 那些 脏 活 累 活 ， 
如 构建 诅 套 循环 、 复 杂 的 if/else 逻 辑 、 临 时 数据 类 型 等 。 


12.3.2 ”反射 LINQ 结 果 集 


现在 假定 Program 类 定义 了 另外 一 个 辅助 函数 叫 ReflectOverQueryResults(), 该 函数 将 输出 LINQ 结 
果 集 的 种 种 细节 ( 注意 ,方法 参数 是 一 个 System.0bject， 用 来 处 理 各 种 结果 集 ): 


static void ReflectOverQueryResults(object resultSet) 


Console.WritelLine("***** TInfO about your query *****"); 

Console.WriteLine("resultSet is of type: {0}", resultSet.GetType().Name); 

Console.WritelLine("resultSet location: {0}", 
resultSet.GetType().Assembly.GetName().Name); 


假定 你 在 输出 得 到 的 子 集 之 后 ， 在 Query0verSstrings() 内 调用 了 这 个 方法 ， 如 果 你 运行 该 应 用 的 
话 ， 将 看 到 这 个 子 集 实 际 上 是 一 个 0rderedEnumerable<TElement,Tkey> 泛 型 类 型 的 实例 ( 是 由 
0rderedSsequence 2 这 样 的 CIL 代 码 来 表示 的 )， 该 类 型 位 于 System.Core.dl1 程 序 集中 : 





****** TInfO about your query ***** 


resultSet is of type: OrderedEnumerable 2 
resultSet location: System.Core 





说 明 很 多 表示 LINQ 结 果 的 类 型 都 被 Visual Studio 对 象 浏览 器 隐藏 了 。 这 些 底层 类 型 设计 出 来 并 不 是 
要 在 你 的 应 用 程序 中 直接 使 用 的 。 
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12.3.3 ”LINQ 和 隐 式 类 型 本 地 变量 


尽管 当前 示例 程序 可 以 相对 容易 地 确定 结果 集 是 string 对 象 的 枚 举 ( 如 IEnumerable<string> ), 但 我 
猜 你 可 能 并 不 清楚 subset 实 际 上 也 是 0rderedEnumerable<TElement，TKey> 类 型 。 

由 于 LINQ 结 果 集 可 以 用 很 多 来 自 LINQ 命 名 空间 的 类 型 来 表示 ， 定 义 确 切 的 类 型 来 接受 结果 集会 
是 非常 枯燥 乏味 的 ， 因 为 在 很 多 情形 下 底层 的 类 型 可 能 并 不 那么 明显 或 者 不 能 从 代码 库 直 接 访问 (有 
时 这 个 类 型 是 在 编译 时 生成 的 )。 

为 进一步 强调 这 一 点 ,考虑 一 下 这 个 在 Program 类 中 定义 的 另外 一 个 辅助 方法 ( 假定 你 会 在 Main() 
方法 中 调用 它 ): 


static void QueryOverInts() 
int[] numbers = {10, 20, 30, 40, 1, 2,3,，8}; 


// 只 输出 小 于 10 的 项 
IEnumerable<int> subset = from i in numbers where i «< 10 select i; 


foreach (int i in subset) 
Console.WritelLine("Item: {0}", i); 
ReflectOverQueryResults(subset); 
} 
在 这 种 情况 下 ，subset 变 量 是 完全 不 同 的 实际 类 型 。 这 时 实现 IEnumerable<int> 接 口 的 类 型 是 低 


级 别 的 WhereArrayIterator<T> 类 : 





Item: 


下 
Item: 2 
Item: 3 
Item: 8 


冰冰 炒 半 半 InfO about your query ***** 
resultSet is of type: WhereArrayIterator 1 
resultSet location: System.Core 





由 于 LINQ 查 询 提取 的 实际 类 型 不 是 很 明显 , 所 以 第 一 个 示例 中 用 IEnumerable<T> 变 量 来 表示 查询 
结果 ， 其 中 T 为 返回 序列 中 的 数据 类 型 ( string 、int 等 )。 但 这 仍然 显得 很 笨重 。 更 糟 的 是 ， 由 于 
IEnumerable<T> 扩 展 了 非 泛 型 的 ILEnumerable 接 口 ， 你 还 可 以 像 下 面 这 样 获取 LINQ 查 询 的 结果 : 


System.Collections.IEnumerable subset = 
from i in numbers where i «< 10 select ij; 


幸好 在 处 理 LINQ 查 询 时 ， 隐 式 类 型 可 以 极 大 地 简化 代码 : 
static void QueryOverInts() 
int[] numbers = {10, 20, 30, 40, 1, 2, 3, 8}; 


// 使 用 隐 式 类 型 
var subset = from i in numbers where i «< 10 select i; 


// 这 里 也 使 用 隐 式 类 型 
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foreach (var i in subset) 
Console.WritelLine("Item: {0} ", i); 
ReflectOverQueryResults(subset); 


一 般 来 说 ， 在 获取 LINQ 查 询 的 结果 集 时 ， 应 该 总 是 使 用 隐 式 类 型 。 但 要 记 住 的 是 ， 在 绝 大 多 数 
情况 下 ， ni me i 

至 于 该 类 型 究竟 是 什么 (0rderedEnumerable<TElement，TKey> 、WhereArrayIterator<T> 等 ) 是 没 
有 关系 的 ， 而 且 也 没有 必要 知道 。 如 上 例 所 示 ， 你 可 以 在 foreach 结 构 中 简单 地 使 用 var 关 键 字 对 获取 


的 数据 进行 迭代 。 


12.3.4 LINQ 和 扩展 方法 


虽然 当前 的 例子 不 需要 你 编写 任何 扩展 方法 ， 但 事实 上 ， 你 却 在 背后 无 颖 地 使 用 了 它们 。 回 想 一 
下 ,LINQ 查 询 表 达 式 可 以 用 来 在 实现 了 泛 型 ITEnumerable<T> 接 口 的 数据 容器 上 做 迭代 操作 ,但 是 , .NET 
System.Array 这 个 类 ( 可 以 用 来 表示 字符 串 数组 和 整数 数组 ) 并 没有 实现 这 个 行为 : 


// System.Array 类 型 看 上 去 并 没有 实现 查询 表达 式 所 需 的 正确 接口 
public abstract class Array : ICloneable, IList, ICollection, 
IEnumerable, IStructuralComparable, IStructuralEquatable 


{ 

虽然 System.Array 并 没有 直接 实现 IEnumerablex<T> 接 口 , 但 它 通过 静态 的 System.Linq. Enumerable 
类 类 型 间接 地 得 到 了 该 类 型 所 需 的 功能 ， 同 时 还 得 到 了 许多 其 他 的 与 LINQ 相 关 的 成 员 。 

这 个 工具 类 定义 了 许多 泛 型 的 扩展 方法 ( 像 Aggregate<T>()、First<T>()、Max<T>() 等 )， 这 些 都 
是 System.Array ( 和 其 他 类 型 ) 在 幕后 获得 的 扩展 方法 。 因 此 ， 如 果 你 在 currentVideoGames 本 地 变量 
上 应 用 点 操作 符 的 话 ， 你 会 发 现 很 多 在 System.Array 类 的 正式 定义 里 找 不 到 的 成 员 (参见 图 12-1 )。 








programc 1 X ©0000 0 SB 
%, LinqOverArray.pregram ~ ®, QueryOverStringsO 和 
// that have an embedded space. 幸 
IEnumerasble<string> subset = from 8 in currentVideoGames <^ 
where g.Contains(” ") 
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onsole.WriteLine("***"" Infe about your query ™****" ); 
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图 12-1 System.Array 类 型 已 被 system.Linq.Enumerable 的 成 员 扩 充 
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12.3.5 延迟 执行 的 作用 


有 关 LINQ 查 询 表 达 式 男 一 个 重要 的 地 方 是 在 我 们 迭代 内 容 之 前 ， 它 们 不 会 真正 进行 运算 。 严 格 
地 说 ， 这 叫做 延迟 执行 。 这 种 方式 的 好 处 在 于 可 以 为 相同 的 容器 多 次 应 用 相同 的 LINQ 查 询 ， 而 始终 
可 以 获得 最 新 的 最 好 的 结果 。 考 虑 对 Query0verInts() 方 法 的 如 下 更 新 : 

static void QueryOverInts() 


int[] numbers = { 10, 20, 30; 40; 1, 2, 3 8 3 


// 获取 小 于 10 的 数 
var subset = from i in numbers where i «< 10 select i; 


// LINQ 语 身 在 这 里 运算 

foreach (var i in subset) 
Console.WriteLine("{0} < 10", i); 

Console.WriteLine(); 


// 修改 数组 中 的 一 些 数据 
numbers[0] = 4; 


// 再 一 次 运算 


foreach (var j in subset) 
Console.WriteLine("{0} < 10", j); 


Console.WriteLine(); 
ReflectOverQueryResults(subset); 


再 次 运行 该 程序 ， 将 得 到 以 下 输出 结果 。 注 意 ， 第 二 次 对 序列 进行 迭代 时 ， 会 多 出 一 个 成 员 ， 因 
为 你 在 数组 头 部 添加 了 一 个 小 于 10 的 项 : 
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Visual Studio 一 个 很 有 用 的 方面 是 ， 如 果 在 运算 LINQ 查 询 之 前 设置 断 点 ， 就 可 以 在 调试 会 话 中 查 
看 内 容 。 只 需要 把 我 们 的 鼠标 光标 放 在 LINQ 结 果 集 变量 的 位 置 ( 图 12-2 中 的 subset ) ， 就 可 以 通过 展 
开 Result View 选 项 来 运算 查询 。 
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图 12-2 ”调试 LINQ 表 达 式 


12.3.6 ”立即 执行 的 作用 


如 果 和 硕 望 在 foreach 逻 辑 外 部 运算 LINQ 表 达 式 ， 可 以 调用 由 Enumerable 类 型 定义 的 许多 扩展 方法 
来 完成 。Enumerable 定 义 了 诸如 ToArray<T>()、ToDictionary<TSource，TKey>() 以 及 ToList<T>() 在 内 
的 许多 扩展 方法 。 在 调用 这 些 方法 的 同时 将 执行 LINQ 查 询 ， 以 获取 数据 快照 。 然 后 ， 这 些 数据 快照 
就 可 以 独立 进行 操作 了 : 


static void ImmediateExecution() 


{ 


int[] numbers = { 106; 20; 305 40y 4; 2 3 8 为 


// 立即 获取 数据 为 int[] 
int[] subsetAsIntArray = 
(from i in numbers where i «< 10 select i).ToArray<int>(); 


// 立即 获取 数据 为 List<int> 
List<int> subsetAsListOfInts 
(from i in numbers where i «< 10 select i).ToList<int>(); 
有 


注意 ， 整 个 LINQ 表 达 式 用 圆 括号 括 起 来 ， 这 样 就 能 将 它 强制 转换 为 正确 的 实际 类 型 来 调用 
Enumerable 的 扩展 方法 。 

第 9 章 提 到 过 ，C# 编 译 器 可 以 准确 检测 泛 型 项 的 类 型 参数 ， 我 们 不 需要 指定 类 型 参数 。 因 此 ， 我 
们 可 以 按 如 下 代码 调用 ToArray<T>() (或 ToList<T>() ) : 


int[] subsetAsIntArray = 
(from i in numbers where i «< 10 select i).ToArray(); 


当 你 要 对 外 部 调用 者 返回 LINQ 查 询 时 ， 立 即 执行 的 好 处 就 显而易见 了 。 这 正 是 本 章 的 下 一 个 





源 代码 ”LinqOverArray 项 目的 源 代 码 位 于 Chapter 12 子 目录 下 。 
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12.4 返回 LINQ 查询 的 结果 


你 可 以 在 类 (或 结构 ) 中 定义 一 个 字段 ， 使 其 值 为 LINQ 查 询 的 结果 。 但 这 样 就 不 能 使 用 隐 式 类 
型 了 (因为 var 关 键 字 不 能 用 于 字段 )， 并 且 LINQ 查 询 的 目标 也 不 能 是 实例 数据 ， 因 此 必须 是 静态 的 。 
由 于 这 些 限制 ， 我 们 通常 不 会 编写 以 下 代码 : 

class LINOBasedFieldsAreClunky 


private static string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 不 能 使 用 隐 式 类 型 | 必须 知道 subset 的 类 型 
private IEnumerable<string> subset = from g in currentVideoGames 
where g.Contains(" ") orderby g select g; 


public void PrintGames() 
foreach (var item in subset) 
Console.WritelLine(item); 


} 
} 


LINQ 查 询 通常 都 定义 在 方法 或 属性 作用 域内 。 此 外 ， 为 了 简化 编程 ， 用 于 保存 结果 集 的 变量 往 
往 用 var 关 键 字 声明 为 隐 式 类 型 本 地 变量 。 现 在 ， 回 忆 第 3 章 所 描述 的 内 容 ， 隐 式 类 型 变量 不 能 用 来 定 
义 类 和 结构 的 参数 、 返 回 值 或 字段 。 

那么 , 如 何 向 外 部 调用 者 返回 查询 结果 呢 ? 答案 是 视 情 况 而 定 。 如 果 结 果 集 由 强 类 型 数据 组 成 ( 如 
字符 串 数组 或 Car 的 ListcT> )， 可 以 使 用 恰当 的 IEnumerable<Ty> 或 IEnumerable 类 型 ( 同样 ， 
IEnumerable<T> 扩 展 自 IEnumerable )， 而 不 用 var 关 键 字 。 下 面 的 示例 来 自 新 建 的 名 为 LinqRetValues 的 


Console Application: 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** [LINO Transformations *****\n"); 
IEnumerable<string> subset = GetStringSubset(); 


foreach (string item in subset) 


Console.WritelLine(item); 


Console.ReadLine(); 
$ 
static IEnumerable<string> GetStringSubset() 


string[] colors = {"Light Red", "Green", 
"Yellow", "Dark Red", "Red", "Purple"}; 


// 注意 ，Ssubset 是 IEnumerable<string> 兼 容 的 对 象 
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IEnumerable<string> theRedColors = from c in colors 
where c.Contains("Red") select cj; 


return theRedColors; 


3: 
输出 结果 如 下 : 





Light Red 
Dark Red 
Red 





通过 立即 执行 返回 LINQ 结 果 


由 于 GetStringSubset() 的 返回 值 和 它 内 部 的 LINQ 查 询 都 是 强 类 型 的 ， 所 以 该 示例 可 以 如 期 运行 。 
如 果 使 用 var 关 键 字 定义 subset 变 量 , 则 只 有 在 该 方法 仍然 定义 返回 IEnumerablexstring> (并 且 隐 式 类 
型 本 地 变量 与 指定 的 返回 类 型 兼容 ) 时 ， 才 允许 返回 值 。 

你 可 以 通过 立即 执行 来 避免 操作 IEnumerable<T> 带 来 的 不 便 。 例 如 ， 如 果 你 将 序列 转换 为 强 类 型 
数组 ， 就 可 以 简单 地 返回 string[] ， 而 不 必 返 回 TEnumerablekstring>。 以 下 这 个 Program 类 的 新 方法 实 
现 了 这 样 的 功能 : 

static string[] GetStringSubsetAsArray() 


string[] colors = {"Light Red", "Green", 
"Yellow", "Dark Red", "Red", "Purple"}; 


var theRedColors = from c in colors 
where c.Contains("Red") select cj; 


// 将 结果 映射 为 数组 
return theRedColors.ToArray(); 


这 样 , 调用 者 很 乐意 不 知道 得 到 的 结果 是 否 来 自 LINQ 查 询 , 它们 只 需要 简单 地 操作 string 数 组 即 
可 。 如 下 面 的 代码 : 


foreach (string item in GetStringSubsetAsArray()) 


Console.Writeline(item); 


在 返回 LINQ 投 影 的 结果 时 ， 立 即 执行 也 是 十 分 关键 的 。 本 章 稍 后 将 讨论 该 话题 。 不 过 接 下 来 我 
们 先 来 看 看 如 何 对 泛 型 和 非 泛 型 集合 对 象 使 用 LINQ 查 询 。 


源 代码 ”LinqRetValues 项 目的 源 代 码 位 于 Chapter 12 子 目录 下 。 
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12.5 将 LINQ 查询 应 用 到 集合 对 象 


除了 从 简单 的 数据 数组 里 抽出 结果 以 外 ,LINQ 查 询 表 达 式 也 可 以 操作 System.Collections. Generic 
命名 空间 中 的 成 员 类 型 的 数据 , 例如 List<T> 类 型 。 创建 一 个 名 为 LinqOverCustomObjects 的 新 控制 台 项 
目 ， 定 义 一 个 基本 的 Car 类， 内 含 当 前 的 速度 、 颜 色 、 型 号 和 上 昵称， 代码 如 下 : 


class Car 


public string PetName {get; set;} 
public string Color {get; set;} 
public int Speed {get; set;} 
public string Make {get; set;} 


现在 ， 在 你 的 Main() 方 法 里 定义 一 个 类 型 为 Car 的 局 部 List<T> 变 量 , 使 用 新 的 对 象 初始 化 语法 给 
这 个 表 填 充 几 个 新 的 Car 对 象 : 


static void Main(string[] args) 
Console.WriteLine("***** LINO over Generic Collections *****\n"); 


// 生成 一 系列 Car 对 象 

List<Car> myCars = new List<Car>() { 
new Car{ PetName = "Henry", Color = "Silver", Speed = 100, Make = "BMW"}, 
new Car{ PetName = "Daisy", Color = "Tan", Speed = 90, Make = "BMW"}, 
new Car{ PetName = "Mary", Color = "Black", Speed = 55, Make = "VW"}, 
new Car{ PetName = "Clunker", Color = "Rust", Speed = 5, Make = "Yugo"}, 
new Car{ PetName = "Melvin", Color = "White", Speed = 43, Make = "Ford"} 


了 


Console.ReadLine(); 


12.5.1 访问 包含 的 子 对 象 

对 泛 型 容 需 使 用 LINQ 查 询 与 简单 的 数组 没有 什么 区 别 ， 因 为 LINQ to Object 可 以 用 于 任何 实现 了 
IEnumerable<T> 的 类 型 。 我 们 这 一 次 的 目标 是 构建 一 个 查询 表达 式 ， 选 择 myCars 列 表 中 速度 大 于 55 的 
Car 对 象 。 

在 得 到 子 集 后 ， 通 过 调用 petName 属 性 打印 每 个 Car 对 象 的 名 称 。 假 设 Main() 中 调用 了 如 下 的 辅助 
方法 ( 以 List<Car> 作 为 参数 ): 


static void GetFastCars(List<Car> myCars) 


// 找到 List<> 中 所 有 Speed 大 于 55 的 Car 对 象 
Var fastCars = from c in myCars where c.Speed > 55 select ci; 


foreach (var car in fastCars) 


Console.WriteLine("{0} is going too fast!", car.PetName); 
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注意 ， 我 们 的 查询 表达 式 只 从 List<T> 里 抓 取 Speed 属 性 大 于 55 的 那些 项 。 如 果 运 行程 序 ， 我 们 会 
发 现 只 有 Henry 和 Daisy 两 项 符合 搜索 条 件 。 

如 果 我 们 要 建 一 个 复杂 的 查询 ， 也 许 会 想 只 找 那些 速度 超过 90 的 宝马 车 。 要 这 人 么 做 的 话 ， 只 要 使 
用 C# 的 8& 操 作 符 建 一 个 复杂 的 布尔 语句 即 可 : 

static void GetFastBMWs(List<Car> myCars) 

[入 到 六 全 转业 坊间 


var fastCars = from ¢ in myCars where c.Speed > 90 && c.Make == "BMW" select c; 
foreach (var car in fastCars) 


Console.WritelLine("{0} is going too fast!", car.PetName); 
} 
} 
在 这 个 情形 下 ， 输 出 的 昵称 只 有 Henry。 


12.5.2 ”将 LINQ 查 询 应 用 于 非 泛 型 集合 


回想 一 下 ，LINQ 的 查询 操作 符 是 设计 用 于 任何 实现 了 IEnumerable<T> 接 口 的 类 型 的 ， 无论 是 直接 
地 还 是 通过 扩展 方法 间接 实现 的 。 鉴 于 System.Array 已 经 具备 了 这 些 必需 的 基础 结构 ， 
System.Collections 中 传统 的 非 泛 型 容器 类 却 没有 这 些 结构 ， 这 也 许 会 让 你 感到 惊讶 。 谢 天 谢 地 ， 我 
们 还 可 以 用 泛 型 Enumerable.0fType<T>() 方 法 来 对 包含 在 这 些 非 泛 型 集合 里 的 数据 进行 迭代 操作 。 

0fTypexT>() 方 法 没 扩展 泛 型 类 型 ， 它 是 Enumerable 中 少数 几 个 这 样 的 成 员 之 一 。 当 对 一 个 实现 了 
IEnumerable 接 口 ( 例如 ArrayList ) 的 非 泛 型 容器 类 调用 这 个 成 员 方法 时 ， 只 需 指 定 容 器 中 项 的 类 型 
就 可 以 提取 一 个 兼容 于 IEnumerable<T> 的 对 象 。 在 代码 中 ， 可 以 使 用 隐 式 类 型 变量 来 存储 该 数据 点 。 

考虑 下 面 的 新 方法 ， 它 使 用 一 组 Car 对 象 填充 ArrayList ( 要 在 Program.cs 文 件 中 引入 System. 
Collections 命 名 空间 )。 

static void LINOOverArrayList() 


Console.Writeline("***** [INQ over ArrayList *****"); 


// 这 是 个 非 泛 型 的 车 集合 

ArrayList myCars = new ArrayList() { 
new Car{ PetName = "Henry", Color = "Silver", Speed = 100, Make = "BMW"}, 
new Car{ PetName = "Daisy", Color = "Tan", Speed = 90, Make = "BMW"}, 
new Car{ PetName = "Mary", Color = "Black", Speed = 55, Make = "VW"}, 
new Car{ PetName = "Clunker", Color = "Rust", Speed = 5, Make = "Yugo"}, 
new Car{ PetName = "Melvin", Color = "White", Speed = 43, Make = "Ford"} 


2» 


// 把 ArTayList 转 换 成 一 个 兼容 于 IEnumerable<T> 的 类 型 
var myCarsEnum = myCars.0fType<Car>(); 


// 建立 兼容 类 型 的 查询 表达 式 
Var fastCars = from c in myCarsEnum where c.Speed > 55 select c; 


foreach (var car in fastCars) 


Console.WriteLine("{0} is going too fast!", car.PetName); 
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与 前 面 的 示例 类 似 , 从 Main() 方 法 调用 这 个 方法 时 , 根据 LINQ 查 询 的 格式 , 将 只 显示 名 字 "Henry” 
和 “Daisy”。 


12.5.3 ”使 用 ofTypex<T>() 筛 选 数据 


你 知道 ， 非 泛 型 类 型 可 包含 任何 类 型 的 项 ， 因 为 这 些 容器 类 ( 再 以 ArrayList 作 例子 ) 的 成 员 的 原 
型 是 接受 System. 0bjects 的 。 例 如 ， 假 定 一 个 ArrayList 内 包含 好 几 个 项 ， 只 有 一 些 是 数字 。 假 如 我 们 
要 得 到 只 含 数 字 类 型 数据 的 子 集 , 可 以 使 用 OofType<T>() ,因为 它 会 过 滤 出 那些 类 型 不 同 于 迭代 操作 中 
所 指定 类 型 的 元 素 : 


static void OfTypeAsFilter() 


// 从 ArTrayList 中 提取 整数 

ArrayList myStuff = new ArrayList(); 

myStuff.AddRange(new object[] { 10, 400, 8, false, new Car(), "string data" }); 
var myInts = myStuff.0fType<int>(); 


// 输出 10、400 和 8 
foreach (int i in myInts) 


l Console.WritelLine("Int value: {0}", i); 
} 
到 目前 为 止 ， 我 们 已 经 对 数组 、 泛 型 集合 和 非 泛 型 集合 使 用 了 LINQ 查 询 。 这 些 容器 包含 了 基本 
类 型 ( 整 型 、 字 符 串 数据 等 ) 和 自 定义 类 。 下 面 我 们 来 学 习 其 他 的 LINQ 操 作 符 ， 它 们 用 于 构建 更 加 
复杂 和 有 用 的 查询 。 


源 代码 ”LinqOverArrayList 例 程 的 源 代 码 位 于 Chapter 12 子 目录 下 。 


12.6”C# LINQ 查询 操作 符 
C# 定 义 了 很 多 查询 操作 符 ， 表 12-3 只 定义 了 其 中 的 几 个 操作 符 。 


说 明 .NET Framework 4.5 SDK 文 档 提 供 了 有 关 每 一 个 C# LINQ 操 作 符 的 细节 。 更 多 信息 请 参阅 
“LINQ General Progamming Guide” 的 主题 。 


表 12-3 ”各 种 LINQ 查 询 操作 符 


查询 操作 符 含义 
from、in 用 于 定义 任何 LINQ 表 达 式 的 主干 ， 允 许 从 合适 的 容器 中 提取 数据 子 集 
where 用 于 定义 从 一 个 容器 里 取出 哪些 项 的 限制 条 件 


select 用 于 从 容器 中 选择 一 个 序列 
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( 续 ) 





查询 操作 符 


join、 on、equals、into 


orderby、 ascending、 descending 


group、 by 


含义 
基于 指定 的 键 来 做 关联 操作 。 记 住 , 这 些 “ 关 联 ” 不 必 与 关系 数据 库 的 数 
据 有 什么 关系 
允许 结果 子 集 按 升序 或 降序 排序 
用 特定 的 值 来 对 数据 分 组 后 得 到 一 个 子 集 


除了 上 面 表 12-3 中 列 出 的 部 分 操作 符 外 ，System.Linq.Enumerable 类 还 提供 了 一 套 没有 直接 的 C# 
查询 操作 符 简 化 符号 ， 而 是 以 扩展 方法 呈现 的 方法 。 可 以 调用 这 些 泛 型 方法 以 各 种 方式 来 对 一 个 结果 
集 进 行 转换 ( Reverse<>()、ToArray<>()、ToList<>() 等 )。 其 中 的 一 些 方法 用 于 从 一 个 结果 集 提取 单 
例 ， 也 有 一 些 方 法 是 对 结果 集 进行 集 操作 (Distinct<>()、Union<>()、Intersect<>() 等 )， 还 有 一 些 
方法 是 对 结果 集 进 行 聚合 操作 ( Count<>()、Sum<>()、Min<>()、Max<>() 等 )。 


class ProductInfo 


{ 


public string Name {get; set;} 


public string Description {get; set;} 
public int NumberInStock {get; set;} 


public override string ToString() 


return string.Format("Name={0}, Description={1}, Number in Stock={2}", 
Name, Description, NumberInStock); 


} 
j} 


现在 在 Main() 方 法 中 用 ProductInfo 对 象 填充 数组 : 


static void Main(string[] args) 


Console.WritelLine("***** Fun with Query Expressions *****\n"); 


// 这 个 数组 将 是 测试 的 基础 


ProductInfo[] itemsInStock = new[] { 
new ProductInfo{ Name = "Mac's Coffee", 


Description 


"Coffee with TEETH", 


NumberInStock = 24}, 
new ProductInfo{ Name = "Milk Maid Milk"， 


Description 


"Milk cow's love", 


NumberInStock = 100}, 
new ProductInfo{ Name = "Pure Silk Tofu", 


Description 


"Bland as Possible", 


NumberInStock = 120}, 
new ProductInfo{ Name = "Cruchy Pops", 


Description 


"Cheezy, peppery goodness", 


NumberInStock = 2}, 

new ProductInfo{ Name = "RipOff Water"， 
Description = "From the tap to your wallet", 
NumberInStock = 100}, 

new ProductInfo{ Name = "Classic Valpo Pizza", 


Description 


"Everyone loves pizzal!", 


NumberInStock = 73} 


交 


12.6 C# LINQ 查询 操作 符 371 


// 这 里 我 们 将 调用 各 种 方法 
Console.ReadLine(); 


} 


12.6.1 基本 的 选择 语法 

因为 LINQ 查 询 表达 式 是 在 编译 时 校 验 的 ， 记 住 这 些 操作 符 的 次 序 是 至 关 重 要 的 。 简 单 地 说 ， 每 
个 LINQ 查 询 表 达 式 都 是 使 用 from、in 和 select 操 作 符 来 建立 的 ， 如 下 所 示 

var result = from matchingItem in container select matchingItem; 

from 操 作 符 后 面 的 项 匹配 LINQ 查 询 条 件 , 其 名 称 可 以 任意 选择 。in 操 作 符 后 面 的 项 表示 要 查询 的 


数据 容器 ( 数组、 集合 或 XML 文档 )。 
在 此 ,我 们 的 查询 表达 式 不 过 是 从 容器 里 挑选 出 每 个 项 而 已 ， 类 似 Select *SQL 语 句 。 考 虑 下 面 的 


代码 : 
static void SelectEverything(ProductInfo[] products) 


// 得 到 所 有 的 对 象 

Console.WritelLine("All product details:"); 

var allProducts = from p in products select p; 
foreach (var prod in allProducts) 


Console.WriteLine(prod.ToString()); 


} 
其 实 ， 这 个 查询 表达 式 并 不 是 很 有 用 ， 因 为 我 们 的 子 集 与 传人 的 参数 中 的 数据 是 一 模 一 样 的 。 如 
果 我 们 愿意 的 话 ， 可 以 使 用 传人 的 参数 ， 通 过 使 用 下 面 的 选择 语法 来 只 提取 每 个 car 对 象 的 Name 值 。 


static void ListProductNames(ProductInfo[ ] products) 
// 只 提取 产品 的 名 字 
Console.WriteLine("Only product names:"); 
var names = from p in products select p.Name; 
foreach (var n in names) 


Console.WritelLine("Name: {0}", n); 


» 


12.6.2 ”获取 数据 子 集 


为 了 从 数据 容器 里 得 到 特定 的 子 集 ， 可 以 使 用 where 操 作 符 。 这 么 做 时 ， 总 的 语法 模板 成 为 下 面 
这 样 : 

var result = from item in container where BooleanExpression select item; 

注意 ，where 操 作 符 预期 一 个 运算 结果 是 布尔 值 的 表达 式 。 例 如 ， 要 从 ProductInfo[] 参 数 中 提取 
库存 量 大 于 25 的 项 ， 可 以 编写 如 下 代码 : 

static void GetOverstock(ProductInfo[] products) 
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Console.WritelLine("The overstock items!"); 


// 只 获取 库存 量 大 于 25 的 项 
var overstock = from p in products where p.NumberInStock > 25 select p; 


foreach (ProductInfo c in overstock) 
Console.WritelLine(c.ToString()); 
} 
} 
本 章 前 面 介绍 过 ， 当 构建 一 个 where 子 句 的 时 候 ， 人 允许 利用 任意 合法 的 C# 操 作 符 来 构建 复杂 的 表 
达 式 。 例 如 ， 考 虑 下 面 这 个 只 提取 那些 速度 超过 每 小 时 100 英 里 的 BMW 的 查询 : 
// 得 到 连 度 最 少 是 每 小 时 100 英 里 的 BMW 


var onlyFastBMWs = from c¢ in myCars 
where c.Make == "BMW" && c.Speed >= 100 select cj; 


foreach (Car c in onlyFastBMWs) 
{ 


Console.WriteLine("{0} is going {1} MPH"，c.PetName，c.Speed); 


12.6.3 ”投影 新 数据 类 型 


从 现 有 的 数据 源 投影 出 新 的 数据 形式 也 是 可 能 的 。 让 我 们 假定 你 想 从 传人 的 ProductInfo[ ] 参 数 中 
得 到 一 个 只 有 产品 的 名 字 和 描述 的 结果 集 。 可 以 定义 一 个 select 语 句 ， 动 态 生 成 一 个 新 的 匿名 类 型 : 


static void GetNamesAndDescriptions(ProductInfo[] products) 


Console.WritelLine("Names and Descriptions:"); 
var nameDesc = from p in products select new { p.Name, p.Description }; 


foreach (var item in nameDesc) 


// 也 可 以 直接 使 用 Name 和 Description 属 性 
Console.WriteLine(item.ToString()); 


. 

要 记 住 在 使 用 了 投影 的 LINQ 查 询 中 ， 你 无 法 知道 实际 的 数据 类 型 ， 因 为 它 是 在 编译 时 决定 的 。 
在 这 种 情况 下 ， 就 必须 使 用 var 关 键 字 。 同 样 ， 你 不 能 在 创建 方法 时 返回 隐 式 类 型 ， 因 此 以 下 方法 不 
能 编译 : 


static var GetProjectedSubset(ProductInfo[] products) 


var nameDesc = from p in products select new { p.Name, p.Description }; 
return nameDesc; // 不 行 


在 向 调用 者 返回 投影 的 数据 时 ， 可 以 使 用 ToArray() 扩 展 方法 将 查询 结果 转换 为 .NET 
System. Array 对 象 。 因 此 ， 可 以 这 样 更 新 查询 表达 式 : 


// 现在 返回 Array 
static Array GetProjectedSubset(ProductInfo[] products) 
{ 
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var nameDesc = from p in products select new { p.Name, p.Description }; 


// 将 匿名 对 象 集 映射 为 Array 对 象 
return nameDesc.ToArray(); 


在 Main() 中 可 以 像 下 面 这 样 调用 和 处 理 数据 : 


Array objs = GetProjectedSubset(ItemsInStock); 
foreach (object o in objs) 


Console.WriteLine(0); // 对 每 个 匿名 对 象 调用 ToString() 


注意 ， 你 需要 使 用 字面 的 System.Array 对 象 ， 而 不 能 使 用 C# 数 组 声明 语法 ， 因 为 你 不 知道 编译 器 
生成 的 匿名 类 的 实际 类 型 。 同 样 ， 我 们 没有 指定 泛 型 方法 ToArray<T>() 的 类 型 参数 ， 因 为 直到 编译 时 
我 们 才能 知道 实际 的 数据 类 型 ， 而 这 已 经 太 晚 了 。 

显然 , 由 于 Array 对 象 中 的 项 为 0bject 类 型 ， 你 无 法 继续 享有 强 类 型 的 优势 。 此 外 , 在 需要 返回 投 
影 操 作 的 LINQ 结 果 集 时 ， 也 必须 将 数据 转换 为 Array 类 型 ( 或 通过 Enumerable 类 型 的 其 他 成 员 转 换 为 
合适 的 容器 )。 


12.6.4 使 用 Enumerable 获 取 总 数 


在 投影 一 批 新 的 数据 时 ， 你 可 能 需要 知道 究竟 有 多 少 项 返回 到 了 序列 中 。 如 果 要 获取 LINQ 查 询 
表达 式 返 回 的 项 数 ， 可 以 简单 地 使 用 Enumerable 类 的 扩展 方法 Count()。 例 如 ， 下 面 的 方法 将 查找 本 地 
数组 中 长 度 大 于 6 个 字符 的 string 对 象 : 

static void GetCountFromQuery() 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 获取 查询 出 的 总 数 


int numb = 
(from g in currentVideoGames where g.Length > 6 select g).Count(); 


// 打印 项 数 


Console.WriteLine("{0} items honor the LINQ query.", numb); 


} 


12.6.5 反 转 结果 集 
你 可 以 简单 地 使 用 Enumerable 类 中 的 扩展 方法 Reverse<T>() 对 结果 集中 的 项 进行 反 转 。 例 如 ， 下 
面 的 方法 对 传人 的 ProductInfo[ ] 参 数 的 所 有 项 进行 反 转 : 
static void ReverseEverything(ProductInfo[] products) 
Console.WritelLine("Product in reverse:"); 
var allProducts = from p in products select p; 


foreach (var prod in allProducts.Reverse()) 


Console.Writeline(prod.ToString()); 


374 第 12 章 LINQ to Object 


12.6.6 ”对 表达 式 进行 排序 

在 本 章 最 开始 的 示例 中 ， 查 询 表 达 式 使 用 orderby 操 作 符 通过 一 个 指定 的 值 对 子 集 中 的 项 进行 排 
序 。 上 默认 为 正 序 。 因 此 对 字符 串 的 排序 为 按 字母 顺序 ， 对 数字 数据 的 排序 为 从 小 到 大 。 如 果 要 观察 逆 
序 排列 的 结果 ， 可 以 使 用 descending 操 作 符 。 考 虑 下 面 的 方法 : 


static void AlphabetizepProductNames(ProductInfo[] products) 


// 按 字母 顺序 获取 产品 的 名 称 
var subset = from p in products orderby p.Name select p; 


Console.WriteLine("Ordered by Name:"); 
foreach (var p in subset) 


Console.WritelLine(p.ToString()); 


} 

尽管 默认 为 正 序 ， 你 也 可 以 使 用 ascending 操 作 符 ， 这 样 意图 会 更 明确 : 
var subset = from p in products orderby p.Name ascending select p; 

如 果 要 使 项 逆序 排列 ， 就 使 用 descending 操 作 符 : 


var subset = from p in products orderby p.Name descending select p; 


12.6.7 维 恩 图 工具 

Enumerable 类 提供 了 一 些 扩展 方法 ， 可 以 对 两 个 (或 多 个 ) LINQ 查 询 的 数据 进行 合并 ( union )、 
比较 ( difference )、 连 接 (concatenation ) 和 交叉 ( intersection )。 首 先 ， 考虑 Except() 扩 展 方法 ， 它 返 
回 包含 两 个 容器 不 同 之 处 的 LINQ 结 果 集 。 在 下 例 中 ,该 值 为 “Yugo”: 

static void DisplayDiff() 


List<string> myCars = new List<String> {"Yugo", "Aztec", "BMW"}; 
List<string> yourCars = new List<String>{"BMW", "Saab", "Aztec" }; 


var carDiff =(from c in myCars select c) 
.Except(from c2 in yourCars select c2); 


Console.WriteLine("Here is what you don't have, but I do:"); 


foreach (string s in carDiff) 
Console.WritelLine(s); // 打印 Yugo 


Intersect() 方 法 返回 两 个 容器 中 共同 的 数据 项 。 例 如 ， 下 面 的 方法 返回 的 序列 为 “Aztec” 和 
“BMW”。 


static void DisplayIntersection() 


List<string> myCars = new List<String> { "Yugo", "Aztec", "BMW" }; 
List<string> yourCars = new List<String> { "BMW", "Saab", "Aztec"” }; 


// 获得 共同 的 成 员 
var carIntersect = (from c in myCars select c) 
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.Intersect(from c2 in yourCars select c2); 


Console.WriteLine("Here is what we have in common:"); 
foreach (string s in carIntersect) 
Console.WritelLine(s); // 打印 Aztec 和 BMW 
} 


如 你 所 想 ，Union() 方 法 返回 的 是 多 个 LINQ 查 询 中 的 所 有 成 员 。 与 严格 意义 上 的 合并 一 样 ， 如 
果 相 同 的 成 员 出 现 多 次 ,将 只 能 返回 一 个 。 因 此 ， 下 面 的 方法 将 打印 “Yugo”、“Aztec”、“BMW” 
和 “Saab”: 


static void DisplayUnion() 


t 
List<string> myCars = new List<String> { "Yugo", "Aztec", "BMW" }; 
List<string> yourCars = new List<String> { "BMW", "Saab", "Aztec" }; 


// 合并 这 两 个 容器 
var carUnion = (from c in myCars select c) 
.Union(from c2 in yourCars select c2); 


Console.WriteLine("Here is everything:"); 
foreach (string s in carUnion) 
Console.WritelLine(s); // 打印 所 有 公共 成 员 


最 后 ，Concat() 扩 展 方法 将 返回 直接 连接 的 LINQ 结 果 集 。 例 如 ， 下 面 的 方法 将 打印 “Yugo”、 
“Aztec”"、“BMW”、“BMW”、“Saab” 和 “Aztec”: 


static void DisplayConcat() 


List<string> myCars = new List<String> { "Yugo", "Aztec", "BMW" }; 
List<string> yourCars = new List<String> { "BMW", "Saab", "Aztec" }; 


var carConcat = (from c in myCars select c) 
.Concat(from c2 in yourCars select c2); 


// 打印 Yugo Aztec BMW BMW Saab Aztec 


foreach (string s in carConcat) 
Console.Writeline(s); 
} 


12.6.8” 移 除 重复 


在 调用 Concat() 扩 展 方法 时 , 最 终 得 到 的 很 可 能 是 匈 余 的 结果 。 某 些 情况 下 这 就 是 你 想 要 的 ， 
但 某 些 情况 下 你 可 能 希望 移 除数 据 中 的 重复 条 目 。 你 可 以 简单 地 调用 Distinct() 扩 展 方法 ， 如 下 
所 示 : 

static void DisplayConcatNoDups() 


List<string> myCars = new List<String> { "Yugo", "Aztec", "BMW" }; 
List<string> yourCars = new List<String> { "BMW", "Saab", "Aztec" }; 


var carConcat = (from c in myCars select c) 
.Concat(from c2 in yourCars select c2); 


// 打印 Yugo Aztec BMW Saab Aztec 
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foreach (string s in carConcat.Distinct()) 
Console.WritelLine(s); 


12.6.9 ” LINQ 聚合 操作 


LINQ 查 询 可 以 对 结果 集 执行 不 同 的 聚合 操作 。Count() 扩 展 方法 就 是 聚合 的 一 个 示例 。 其 他 类 似 
的 还 有 获取 平均 值 .最 大 值 .最 小 值 .总 值 的 Average()、Max() .Min()、Sum() 方 法 ,它们 都 位 于 Enumerable 
类 中 。 例 如 : 


static void AggregateOps() 
{ 
double[] winterTemps = { 2.0，-21.3，8，-4，0，8.2 }; 
// 不 同 的 聚合 示例 
Console.WriteLine("Max temp: {0}", 
(from t in winterTemps select t).Max()); 


Console.WriteLine("Min temp: {0}", 
(from t in winterTemps select t).Min()); 


Console.WritelLine("Avarage temp: {0}", 
(from t in winterTemps select t+).Average()); 


Console.WritelLine("Sum of all temps: {0}", 
(from t in winterTemps select t).Sum()); 


这 些 示例 可 以 使 你 充分 地 了 解构 建 LINQ 查 询 表 达 式 的 过 程 。 还 有 一 些 操 作 符 没有 在 本 章 介绍 ， 
我 们 将 在 本 书 其 他 LINQ 技 术 相 关 的 章节 中 提供 进一步 的 示例 。 本 章 最 后 将 深入 介绍 C#LINQ 查 询 操作 
符 和 实际 对 象 模型 的 细节 。 


源 代 码 ”FunWithLinqExpressions 项 目的 源 代码 位 于 Chapter 12 子 目录 下 。 





12.7 LINQ 查询 语句 的 内 部 表示 


至 此 ， 你 对 使 用 各 种 C# 查 询 操作 符 ( 例如 from、in、where 、orderby 和 select ) 来 建立 查询 表 
达 式 的 概念 也 有 了 初步 的 了 解 。 同 时 ， 你 还 了 解 了 LINQ to Object API 的 一 些 功 能 只 能 通过 调用 
Enumerable 类 中 的 扩展 方法 来 访问 。 然 而 实际 上 ， 在 编译 时 ，C# 编 译 器 将 所 有 C# LINQ 操 作 符 都 翻译 
为 对 Enumerable 类 中 方法 的 调用 。 如 果 你 不 怕 麻 烦 ， 完 全 可 以 只 用 实际 的 对 象 模型 来 构建 LINQ 语 句 。 

Enumerable 的 许多 方法 的 原型 都 是 把 委托 (delegate ) 作为 参数 。 特 别 是 很 多 方法 都 要 求 一 个 名 为 
Func<> 的 泛 型 委托 (在 第 9 章 将 泛 型 委托 时 介绍 过 ) 作为 参数 。 例 如 ， 当 使 用 C# where LINQ 查 询 操作 
符 时 ， 将 调用 Enumerable 的 Where() 方 法 : 


// Enumerable.Where<T>() 方 法 的 重 载 版 本 

// 注意 第 二 个 参数 的 类 型 为 System.Func<> 

public static IEnumerable<TSource> Where<TSource>(this IEnumerable<TSource> source, 
System.Func<TSource, int,bool> predicate) 


式 。 
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public static IEnumerable<TSource> Where<TSource>(this IEnumerable<TSource> source, 
System.Func<TSource,bool> predicate) 


这 个 Fun<> 委 托 〈 顾名思义 ) 代表 了 一 个 接受 一 串 ( 最 多 16 个 ) 参数 和 一 个 返回 值 的 给 定 函数 的 模 
假如 你 用 Visual Studio 对 象 浏览 器 检查 这 个 类 型 的 话 ， 会 注意 到 Func<> 委 托 有 很 多 形式 如 下 所 示 : 


// Func<> 委 托 的 各 种 格式 
public delegate TResult Func<T1,T2,T3,T4,TResult>(T1 arg1，T2 arg2, T3 arg3, T4 arg4) 


public delegate TResult Func<T1,T2,T3,TResult>(T1 arg1, T2 arg2, T3 arg3) 
public delegate TResult Func<T1,T2,TResult>(T1 arg1, T2 arg2) 
public delegate TResult Func<T1,TResult>(T1 arg1) 


public delegate TResult Func<TResult>() 


鉴于 System.Linq.Enumerable 的 许多 成 员 都 要 求 一 个 委托 作为 输入 ， 在 调用 它们 时 ， 我 们 可 以 手 


工 创建 一 个 新 的 委托 类 型 ,编写 所 需 的 目标 方法 ,并 使 用 C# 的 匿名 方法 , 或 者 也 可 以 定义 一 个 合适 的 
Lambda 表 达 式 。 不 管 你 用 什么 方法 ， 最 终结 果 是 完全 一 样 的 。 





使 用 C#LINQ 查 询 操作 符 来 构建 一 个 LINQ 查 询 表达 式 是 最 简单 的 方法 。 若 这 是 正确 的 , 那么 我 们 


来 分 析 一 下 这 些 可 行 的 方法 ， 来 看 一 下 C# 查 询 操 作 符 和 基础 的 Enumerable 类 型 之 间 的 联系 。 
12.7.1 用 查询 操作 符 建立 查询 表达 式 ( 复 习 ) 


首先 ， 创 建 一 个 名 为 LinqUsingEnumerable 的 新 LINQ 控 制 台 应 用 程序 。Program 类 将 定义 一 系列 的 


静态 辅助 方法 都 将 在 Main() 方 法 中 被 调用 ) 来 示范 我 们 建立 查询 表达 式 的 各 种 方式 。 


第 1 个 方法 QueryStringsWithOperators() 是 建立 查询 表达 式 最 直截了当 的 方式 ， 跟 我 们 前 面 的 


LinqOverArray 例 子 里 的 代码 完全 一 样 ， 如 下 所 示 : 


static void QueryStringWithOperators() 
Console.WriteLine("***** Using Query Operators *****"); 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


var subset = from game in currentVideoGames 
where game.Contains(" ") orderby game select game; 


foreach (string s in subset) 
Console.WriteLine("Item: {0}", s); 


使 用 C# 查 询 操作 符 来 建立 查询 表达 式 的 明显 好 处 是 ， 既 看 不 到 Funcc> 委 托 ， 也 不 用 考虑 对 


Enumerable 类 型 的 调用 ， 因 为 做 此 类 翻译 是 C# 编 译 器 的 任务 。 二 良 置疑 的 是 ， 使 用 各 种 查询 操作 符 
(from、in、where 、orderby 等 ) 来 建立 LINQ 表 达 式 是 最 常见 和 最 直截了当 的 方式 。 


12.7.2 ”使 用 Enumerable 类 型 和 Lambda 表 达 式 来 建立 查询 表达 式 


记 住 , 这 里 使 用 的 LINQ 查 询 操 作 符 只 不 过 是 调用 由 Enumerable 类 型 定义 的 各 种 扩展 方法 的 速记 版 
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本 而 已 。 下 面 这 个 QueryStringsWithEnumerableAndLambdas() 方 法 直接 使 用 了 Enumerable 扩 展 方法 来 处 
理 局 部 的 字符 串 数 组 : 
static void QueryStringsWithEnumerableAndLambdas() 


Console.WriteLine("***** Using Enumerable / Lambda Expressions *****"); 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 用 通过 Enumerable 类 型 赋予 Array 的 扩展 方法 建立 查询 表达 式 
var subset = currentVideoGames.Where(game => game.Contains(" ")) 
.OrderBy(game => game).Select(game => game); 


// 输出 结果 

foreach (var game in subset) 
Console.WritelLine("Item: {0}", game); 

Console.WriteLine(); 


这 里 , 我 们 对 currentVideoGames 字 符 串 数组 调用 了 Where() 扩 展 方法 。 Array 类 可 以 通过 Enumerable 
中 的 扩展 方法 实现 该 操作 。Enumerable.Nhere() 方 法 要 求 System.Func<T1,TResult> 委 托 类 型 的 参数 。 
该 委托 的 第 一 个 类 型 参数 表示 与 IEnumerable<T> 兼 容 的 数据 ( 本 例 中 为 字符 串 数 组 ) ， 第 二 个 类 型 参 
数 表示 方法 的 结果 数据 ， 它 是 Lambda 表 达 式 中 的 单一 语句 所 返回 的 。 

在 该 代码 示例 中 , Where() 方 法 的 返回 值 被 隐藏 了 , 但 在 后 台 我 们 操作 的 是 0rderedEnumerable 类 型 。 
对 该 类 型 调用 泛 型 orderBy() 方 法 ,该 方法 同样 要 求 Func<> 委 托 参 数 。 这 次 ,我 们 通过 一 个 适合 的 Lambda 
表达 式 简单 地 依次 传递 各 项 。 调 用 OrderBy() 方 法 的 最 终结 果 是 一 个 对 原始 数据 重新 排序 的 新 序列 。 

最 后 ， 对 0rderBy() 返 回 的 序列 调用 Select() 方 法 ， 最 终 的 数据 集 保存 在 隐 式 类 型 变量 subset 中 。 

的 确 ， 这 种 LINQ 查 询 的 “普通 写法 ”要 比 之 前 的 C# 查 询 操作 符 示 例 复杂 一 些 。 毫 无 疑问 ， 一 部 
分 复杂 性 是 使 用 点 操作 符 调用 方法 链 造成 的 。 下 面 的 代码 将 查询 拆 分 为 多 个 语句 ， 可 以 得 到 相同 的 
结果 : 

static void QueryStringsWithEnumerableAndLambdas2() 


Console.WriteLine("***** Using Enumerable / Lambda Expressions *****"); 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 拆 分 

var gamesWithSpaces = currentVideoGames.Where(game => game.Contains(" ")); 
var orderedGames = gamesWithSpaces.OrderBy(game => game); 

var subset = orderedGames.Select(game => game); 


foreach (var game in subset) 
Console.WritelLine("Item: {0}", game); 
Console.WritelLine(); 


你 也 许 同 意 , 与 使 用 C# 查 询 操作 符 相 比 , 直接 使 用 Enumerable 类 的 方法 来 建立 一 个 LINQ 查 询 表达 
式 比较 烦琐 。 还 有 ，Enumerable 的 方法 要 求 委 托 作 为 参数 ， 你 需要 经 常 编写 Lambda 表 达 式 来 提供 将 由 
底层 委托 目标 处 理 的 输入 数据 。 
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12.7.3 ”使 用 Enumerable 类 型 和 匿名 方法 来 建立 查询 表达 式 


鉴于 C# Lambda 表 达 式 只 是 用 于 操作 匿名 方法 的 简化 符号 ， 我 们 考虑 一 下 QuerySstringsWith- 
AnonymousMethods() 辅 助 函 数 里 定义 的 第 3 种 查询 表达 式 : 


static void QueryStringsWithAnonymousMethods() 
{ 


Console.WriteLine("***** Using Anonymous Methods *****"); 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 使 用 匿名 方法 建立 所 需 的 Func<> 委 托 
Func<string, bool> searchFilter = 
delegate(string game) { return game.Contains(" "); }; 
Func<string, string> itemToProcess = delegate(string s) { return s; }; 


// 把 委托 传递 给 Enumerable 的 方法 
var subset = currentVideoGames.Where(searchFilter) 
.OrderBy(itemToProcess).Select(itemToProcess); 


// 输出 结果 

foreach (var game in subset) 
Console.WritelLine("Item: {0}", game); 

Console.WritelLine(); 


} 
这 个 查询 表达 式 的 做 法 更 加 烦琐 ,因为 我 们 手工 编写 了 Enumerable 类 的 Where() 方 法 、0rderBy() 方 法 
和 Select() 方 法 所 使 用 的 Func<> 委 托 。 但 从 好 的 方面 来 看 ， 匿 名 方法 的 句法 确实 把 所 有 的 委托 处 理 都 
包含 在 单一 方法 定义 中 了 。 然 而 ， 这 个 方法 在 功能 上 与 前 面 的 QueryStringsWithEnumerable- 
AndLambdas() 方 法 和 QueryStringsWithOperators() 方 法 完全 等 同 。 


12.7.4 用 Enumerable 类 型 和 原始 委托 建立 查询 表达 式 
最 后 , 如果 我 们 真 要 使 用 非常 烦琐 的 方式 来 建立 一 个 查询 表达 式 , 可 以 避免 使 用 Lambda 或 匿名 方 2 
法 句法 ， 而 是 直接 创建 每 个 Func<> 类 型 的 委托 目标 。 这 是 最 后 一 次 介绍 查询 表达 式 ， 我 们 在 一 个 名 为 
VeryComplexQueryExpression 的 新 类 中 为 其 建 模 ， 如 下 所 示 : 
class VeryComplexQueryExpression 
public static void QueryStringsWithRawDelegates() 
Console.WritelLine("***** Using Raw Delegates *****"); 


string[] currentVideoGames = {"Morrowind", "Uncharted 2", 
"Fallout 3", "Daxter", "System Shock 2"}; 


// 建立 所 需 的 Func<> 委 托 
Func<string, bool> searchFilter = new Func<string，bool>(Filter); 
Func<string, string> itemToProcess = new Func<string,string>(ProcessItem); 


// 把 委托 传递 给 Enumerable 的 方法 
var subset = currentVideoGames 
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.Where(searchFilter) .OrderBy(itemToprocess).Select(itemToprocess); 


// 输出 结果 

foreach (var game in subset) 
Console.WritelLine("Item: {0}", game); 

Console.WriteLine(); 


// 委托 目标 
public static bool Filter(string game) {return game.Contains(" ");} 
public static string ProcessItem(string game) { return game; } 


可 以 按 如 下 所 示 在 Program 类 的 Main() 方 法 中 调用 这 个 方法 来 测试 字符 串 处 理 的 迭代 : 

VeryComplexQueryExpression.QueryStringsWithRawDelegates(); 

如 果 现 在 运行 程序 来 测试 各 个 可 能 的 做 法 ,你 就 不 应 该 奇怪 , 不管 走 了 哪 条 路 ,它们 的 输出 都 是 
一 样 的 。 请 将 下 面 关 于 LINQ 查 询 表 达 式 在 底层 如 何 表 示 的 要 点 记 在 心里 。 

口 查询 表达 式 是 用 各 种 C# 查 询 操作 符 建立 的 。 

口 查询 操作 符 只 是 调用 由 System.Linq.Enumerable 类 型 定义 的 扩展 方法 的 简化 符号 。 

口 Enumerable 的 许多 方法 要 求 委托 ( 特别 是 Func<> ) 作为 参数 。 

口 任何 要 求 委 托 参数 的 方法 都 可 以 传人 一 个 Lambda 表 达 式 。 

口 Lambda 表 达 式 是 伪装 的 匿名 方法 (这 提高 了 可 读 性 )。 

口 匿名 方法 是 指派 一 个 原始 委托 ， 然 后 手工 建立 一 个 委托 目标 方法 的 简化 符号 。 

这 也 许 比 你 想 要 知道 的 更 深入 了 一 点 ， 但 我 希望 这 个 讨论 能 帮 你 理解 C# 查 询 操作 符 背 后 的 工作 
原理 。 





说 明 LinqUsingEnumerable 项 目的 源 代码 位 于 Chapter 12 子 目录 下 。 


12.8 小结 


LINQ 是 一 系列 相关 的 技术 ， 试 图 提供 一 个 单一 的 、 对 称 的 方式 来 与 各 种 形式 的 数据 交互 。 就 像 
本 章 所 解释 的 那样 , LINQ 可 以 与 任何 实现 了 IEnumerable<T> 接 口 的 类 型 交互 , 这 些 类 型 包括 简单 数组 、 
泛 型 的 和 非 泛 型 数据 集合 。 

你 已 经 看 到 ，LINQ 技 术 是 通过 使 用 几 个 新 的 C# 语 言 特 性 实现 的 。 例 如 ， 由 于 LINQ 查 询 表达 式 可 
以 返回 任意 数目 的 结果 集 ， 使 用 var 这 个 关键 字 来 代表 底层 数据 类 型 是 很 常见 的 。 此 外 ，Lambda 表 达 
式 、 对 象 初始 化 语法 以 及 匿名 类 型 都 可 用 来 建立 函数 式 的 、 紧 凑 的 LINQ 查 询 。 

更 重要 的 是 ，C# LINQ 查 询 操作 符 只 是 System.Linq.Enumerable 类 型 静态 方法 调用 的 快捷 形式 。 我 
们 看 到 ,大 多 数 Enumerable 的 成 员 都 操作 Func<T> 委 托 类 型 , 它 可 以 接受 方法 地 址 .匿名 方法 或 者 Lambda 
表达 式 作 为 输入 来 计算 查询 。” 


Q@ 进一步 深入 学 习 LINQ， 推 荐 阅读 《LINQ 实 战 》( 人民 邮 电 出 版 社 ，2009 ) 一 书 。 一 一 编者 注 
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二 二 一 章 讲述 了 怎样 用 C# 创 建 自 定义 类 类 型 。 本 章 将 介绍 CLR 怎 样 通过 垃圾 回收 ( garbage 

有 J collection ) 来 管理 已 分 配 的 类 实例 ( 又 称 为 对 象 )。C# 程 序 员 从 来 不 直接 从 内 存 中 删除 一 个 
托管 对 象 ( 回忆 一 下 ， 在 C# 语 言 中 没有 delete 关 键 字 )。 相 反 ，.NET 对 象 被 分 配 到 一 块 叫做 托管 堆 
( managed heap ) 的 内 存 区 域 上 ， 在 那里 它们 会 在 “将 来 的 某 一 时 刻 ” 被 垃圾 回收 器 自动 销毁 。 

了 解 了 回收 过 程 的 核心 细节 之 后 , 你 将 会 明白 怎样 使 用 System.GC 类 类 型 通过 编程 使 用 垃圾 回收 器 
(在 大 多 数 .NET 项 目 中 你 都 不 必 这 么 做 )。 接 着 我 们 将 分 析 怎 样 用 System.0bject.Finalize() 虚 方法 和 
IDisposable 接 口 建立 类 ， 而 这 些 类 能 够 可 预测 地 、 及 时 地 释放 内 部 非 托 管 资 源 。 

我 们 还 将 深入 介绍 .NET 4.0 引 入 的 一 些 关于 垃圾 回收 器 的 新 功能 ， 包 括 后 台 垃 圾 回收 和 使 用 
System.Lazy《> 泛 型 类 实现 的 延迟 实例 化 。 通 过 本 章 ， 你 将 会 牢固 地 掌握 CLR 是 怎样 管理 NET 对 象 的 。 


13.1 ， 类、 对象 和 引用 


为 了 说 清 本 章 要 研究 的 主题 ， 进 一 步 前 明 类 、 对 象 和 引用 变量 之 间 的 不 同 是 很 重要 的 。 类 只 是 一 
个 蓝图 ， 它 描述 了 这 个 类 型 的 实例 在 内 存 中 看 起 来 是 什么 样子 。 当 然 ， 类 是 定义 在 一 个 代码 文件 中 的 
( 按 习 惯 , 在 C# 中 通常 带 *.cs 扩 展 名 )。 看 看 下 面 定义 在 名 为 SimpleGC 的 新 控制 台 应 用 程序 项 目 中 的 简 
单 类 Car: 

// Car.cs 

public class Car 


public int CurrentSpeed {get; set;} 
public string PetName {get; set;} 


public Car(){} 
public Car(string name, int speed) 


PetName = name; 
CurrentSpeed = speed; 


public override string ToString() 


return string.Format("{0} is going {1} MPH", 
PetName, CurrentSpeed); 
} 
} 
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定义 了 一 个 类 后 ， 就 可 以 使 用 C# 的 new 关 键 字 分 配 任意 数量 的 对 象 。 但 是 ， 要 理解 new 关 键 字 返 回 的 
是 一 个 指向 堆 上 对 象 的 引用 , 而 不 是 真正 的 对 象 本 身 。 如 果 在 方法 作用 域 中 将 引用 变量 声明 为 本 地 变量 ， 
这 个 引用 变量 保存 在 栈 内 ， 以 供应 用 程序 以 后 使 用 。 当 想 调 用 对 象 中 的 成 员 时 ， 可 以 使 用 点 操作 符 : 
class Program 
static void Main(string[] args) 
Console.WriteLine("***** GC Basics *****"); 


// 在 托管 堆 上 创建 一 个 新 的 Car 对 象 。 返 回 了 一 个 对 这 个 对 象 的 引用 ('refToMyCar') 
Car refToMyCar = new Car("Zippy", 50); 


// 用 C# 的 点 操作 符 (.) 来 调用 使 用 了 引用 变量 的 对 象 的 成 员 


Console.WriteLine(refToMyCar.ToString()); 
Console.ReadLine(); 


} 
图 13-1 说 明了 类 、 对 象 和 引用 的 关系 。 


托管 堆 
栈 


refloMyCar 一 一 一 一 一 Car 对 象 


图 13-1 对 托管 堆 上 对 象 的 引用 


说 明 ”第 4 章 介 绍 过 ， 结 构 是 值 类 型 ， 它 直接 分 配 在 栈 上 ， 而 从 来 不 会 放 在 .NET 托 管 堆 上 。 只 有 在 创 
建 类 的 实例 时 ， 才 会 产生 堆 的 分 配 。 


13.2 ”对 象 生 命 周 期 的 基础 


当 创 建 C# 应 用 程序 时 , 尽 可 以 放心 ,你 无 需 对 托管 堆 进 行 直 接 操 作 , 它 将 自动 管理 .事实 上 ,在 .NET 
上 我 们 进行 内 存 管 理 的 规则 非常 简单 。 


规则 ”使 用 new 关 键 字 将 一 个 类 实例 分 配 在 托管 堆 上 ， 然 后 就 不 用 再 管 。 


实例 化 结束 后 , 垃圾 回收 器 将 会 在 对 象 不 再 需要 时 将 其 销毁 。 当 然 , 紧 接着 就 出 现 男 一 个 问题 了 : 
垃圾 回收 器 如 何 判断 一 个 对 象 什么 时 候 不 再 需要 呢 ? 简短 ( 也 就 是 不 完全 ) 的 回答 是 : 只 有 在 一 个 对 
象 从 代码 库 的 任何 部 分 都 不 可 访问 时 ， 垃 圾 回收 器 就 会 从 堆 中 删除 它 。 假 设 已 有 一 个 分 配 局 部 Car 对 
象 的 Program 类 : 
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static void MakeACar() 


// 如 果 myCar 只 引用 Car 对 象 ， 当 方法 返回 的 时 候 它 可 能 会 被 销毁 
Car myCar = new Car(); 


} 

注意 ，Car 引 用 (myCar ) 直接 在 MakeACar() 方 法 中 创建 ， 并 没有 被 传 到 该 方法 的 定义 作用 域 之 外 
(通过 返回 值 或 ref/out 参 数 )。 因 此 ， 这 个 方法 调用 结束 后 ，myCar 引 用 就 再 也 不 访问 ， 相 关联 的 Car 对 
象 现 在 就 是 垃圾 回收 的 候选 目标 。 然 而 ， 要 理解 一 点 : 不 能 保证 这 个 对 象 会 在 MakeACar() 完 成 后 立即 从 
内 存 中 回收 。 但 可 以 肯定 的 是 ， 当 CLR 进 行 下 一 次 垃圾 回收 时 ，myCar 对 象 将 被 安全 地 销毁 。 

你 肯定 会 发 现 ， 在 有 垃圾 回收 的 环境 中 编程 ， 将 大 大 地 简化 应 用 程序 的 开发 。 这 和 C++ 中 的 编程 
形成 鲜明 的 对 比 ， 在 那里 如 果 手 工 删除 分 配 在 堆 上 的 对 象 失败 ， 内 存 泄漏 ?就 是 迟早 的 事 。 事 实 上 ， 
跟踪 寻找 内 存 泄 露 是 用 非 托管 语言 编程 最 耗 时 间 的 方面 之 一 。 通 过 允许 垃圾 收集 器 负责 销毁 对 象 ， 内 
存 管理 的 麻烦 都 交 给 CLR 了 。 


13.2.1 ”CIL 的 new 指 令 


当 C# 编 译 器 遇 到 new 关 键 字 时 , 它 会 在 方法 的 实现 中 加 入 一 条 CIL newobj 指 令 。 如 果 编 译 上 面 的 示 
例 代码 并 使 用 ildasm.exe 查 看 生成 的 程序 集 ， 将 在 MakeACar() 方 法 中 发 现下 面 的 CIL 语 句 : 


.method private hidebysig static void MakeACar() cil managed 


// 代码 尺寸 为 8(0x8) 
.maxstack 1 
.locals init ([0] class SimpleGC.Car myCar) 
IL 0000: nop 
IL 0001: newobj instance void SimpleGC.Car::.ctor() 
IL 0006: stloc.0 
IL 0007: ret 
}// Program: :MakeACar 方 法 结束 


在 研究 有 关 对 象 何 时 从 托管 堆 删 除 的 严格 规则 之 前 ， 让 我 们 更 详细 地 探讨 一 下 CIL 的 newobj 指 令 
的 作用 。 首先, 要 理解 托管 堆 不 只 是 一 个 由 CLR 访 问 的 随机 内 存 块 。 .NET 垃 圾 回收 器 是 堆 的 “清洁 工 ”， 
它 会 压缩 空 的 内 存 块 来 实现 优化 ( 必要 的 时 候 )。 为 了 辅助 这 一 行为 ， 托 管 堆 保存 着 一 个 指针 ”( 常 称 
为 下 一 个 对 象 的 指针 或 新 对 象 指针 )， 它 精确 地 指示 下 一 个 对 象 将 被 分 配 的 位 置 。 
此 外 ，newobj 指 令 通知 CLR 执 行 下 面 的 核心 任务 。 
口 计算 分 配对 象 所 需要 的 总 内 存 数 ( 包含 数据 成 员 和 基 类 所 需 的 内 存 )。 
口 检查 托管 堆 ， 确 保有 足够 的 空间 来 放置 要 分 配 的 对 象 。 如 果 空 间 足 够 ， 调 用 类 型 的 构造 函 
数 ， 最 终 将 内 存 中 新 对 象 的 引用 返回 给 调用 者 ， 它 的 地 址 恰好 是 下 一 个 对 象 的 指针 的 上 一 
个 位 置 。 
口 最 后 ， 在 将 引用 返回 给 调用 者 之 前 ， 移 动 下 一 个 对 象 的 指针 ， 指 向 托管 堆 上 的 下 一 个 可 用 的 
位 置 。 
基本 过 程 如 图 13-2 所 示 。 


中 未 及 时 释放 内 存 而 导致 内 存 无 法 再 次 使 用 ， 从 而 造成 了 浪费 。 一 一 译 者 注 
@ pointer， 是 用 于 表示 内 存单 元 地 址 的 变量 。 一 一 译 者 注 
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托管 堆 





static void Main(string[ ] args) 
{ 


Car c1 = New Car(): 
Car c2 = New Car(): 
} 


下 一 个 对 象 指针 


图 13-2 在 托管 堆 上 分 配对 象 的 细节 
因为 我 们 经 常 需要 在 应 用 程序 中 频繁 地 分 配对 象 ， 托 管 堆 上 的 空间 最 终 会 用 完 。 当 人 处理 newobj 指 


令 时 ， 如 果 CLR 判 定 托 管 堆 没 有 足够 的 空间 来 分 配 所 请 求 的 类 型 ， 它 会 执行 一 次 垃圾 回收 来 尝试 释放 
内 存 。 因 此 ， 垃 圾 回收 的 下 一 个 规则 非常 简单 。 


规则 如 果 托 管 堆 没有 足够 的 内 存 来 分 配 所 请 求 的 对 象 ， 就 会 进行 垃圾 回收 。 


但 垃圾 回收 具体 是 如 何 发 生 的 , 取决 于 应 用 程序 正在 使 用 的 .NET 平 台 的 版 本 。 本章 将 会 介绍 这 些 
不 同 之 处 。 


13.2.2 ”将 对 象 引用 设置 为 空 


C/C++ 程序 员 通 常 将 指针 变量 设置 为 null 来 确保 不 再 引用 非 托 管内 存 。 因 此 ， 在 C# 中 你 可 能 会 想 
知道 ， 将 对 象 引用 赋值 为 hull 会 怎么 样 。 例 如 ,假设 MakeACar() 子 程序 被 更 新 为 如 下 : 
Ep void MakeACar() 


Car myCar = new Car(); 
myCar = null; 


如 果 我 们 将 对 象 引 用 赋值 为 nul1， 编 译 器 会 生成 CIL 代 码 来 确保 引用 (这 里 是 myCar ) 不 再 指向 任 
何 对 象 。 如 果 我 们 再 使 用 ildasm.exe 来 查看 修改 后 的 MakeACar() 的 CIL 代 码 , 将 会 发 现 1dnull 操 作 码 (在 
虚拟 执行 栈 中 产生 一 个 null 值 )， 之 后 是 stloc.o 操 作 码 ( 它 用 于 设置 nu11 引 用 ): 


.method private hidebysig static void MakeACar() cil managed 


// 代码 大 小 : 10(0xa) 
.maxstack 1 
.locals init ([0] class SimpleGC.Car myCar) 
IL 0000: nop 
IL 0001: newobj instance void SimpleGC.Car::.ctor() 
IL 0006: stloc.0 
IL 0007: ldnull 
IL 0008: stloc.0 
IL 0009: ret 
}// Program: :MakeACar 方 法 结束 


不 管 怎 么 样 ， 我 们 必须 知道 ， 将 引用 赋值 为 nul1 并 不 意味 着 强制 垃圾 回收 器 立即 启动 并 把 对 象 从 
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堆 上 移 除 。 我 们 完成 的 唯一 事情 就 是 显 式 取消 引用 和 之 前 引用 所 指向 对 象 之 间 的 连接 。 因 此 ， 和 其 他 
C 系 列 的 语言 相 比 ,在 C# 中 将 引用 设置 为 nu11 意 义 就 不 大 了 , 不管 怎 么 样 , 这样 做 也 不 会 有 什么 害处 。 


13.3 ”应 用 程序 根 的 作用 


现在 讨论 垃圾 回收 器 怎样 确定 什么 时 候 “ 不 再 需要 ”一 个 对 象 。 为 了 理解 细节 ， 你 需要 明白 应 用 
程序 根 (application root ) 的 概念 。 简 单 地 说 ， 根 (root ) 就 是 一 个 存储 位 置 ， 其 中 保存 着 对 托管 堆 上 
一 个 对 象 的 引用 。 严 格 地 说 ， 根 可 以 属于 下 面 任何 一 个 类 别 : 

口 全 局 对 象 的 引用 〈 虽然 在 C# 中 不 允许 ， 但 是 CIL 代 码 的 确 允 许 分 配 全 局 对 象 ) 

口 静态 对 象 /静态 字段 的 引用 ; 

口 应 用 程序 代码 库 中 局 部 对 象 的 引用 ; 

口 传递 进 一 个 方法 的 对 象 参 数 的 引用 ; 

口 等 待 被 终结 ( finalize， 本 章 后 面 将 讲述 ) 的 对 象 的 引用 ; 

口 任何 引用 对 象 的 CPU 寄存 器 。 

在 一 次 垃圾 回收 过 程 中 ,运行 库 将 检查 托管 堆 上 的 对 象 ， 判 断 应 用 程序 是 否 仍 然 可 访问 它们 ， 即 
是 否 还 是 有 根 的 ( rooted )。 为 此 ，CLR 将 建立 一 个 对 象 图 ， 代 表 堆 上 可 达 的 每 一 个 对 象 。 在 我 们 讨论 
对 象 序列 化 时 会 再 次 看 到 对 象 图 ( 见 第 20 章 )。 现 在 ， 只 要 理解 对 象 图 是 用 来 说 明 所 有 可 访问 对 象 的 
即 可 。 还 要 明白 , 垃圾 回收 器 从 来 不 会 在 对 象 图 中 让 同一 个 对 象 出 现 两 次 , 这 样 就 避免 了 COM 编 程 中 
令 人 讨厌 的 循环 引用 计数 ( circular reference count )。 

假设 托管 堆 包含 一 个 由 A、B 、C、D 、E、F 和 G 对 象 组 成 的 集合 。 在 一 次 垃圾 回收 中 ， 检 查 这 些 
对 象 (和 它们 可 能 包含 的 任何 内 部 对 象 引 用 ) 是 否 有 活动 根 。 一 旦 构造 好 图 ， 不 可 访问 的 对 象 (我们 
假设 是 对 象 C 和 F ) 就 被 标记 为 垃圾 。 图 13-3 就 是 对 应 于 上 述 情景 的 一 个 可 能 的 对 象 图 ( 带 方向 的 箭头 
表示 依赖 或 需求 ， 例 如 ,“E 依 赖 G， 并 间接 依赖 B”,“A 不 依赖 任何 对 象 " ， 等 等 )。 





下 一 个 对 象 指针 





图 13-3 ”建立 对 象 图 来 确定 哪些 对 象 不 能 由 应 用 程序 根 访问 


一 个 对 象 被 标记 为 终结 后 ( 这 里 是 C 和 F， 因 为 在 对 象 图 中 没有 表示 它们 )， 它 们 就 会 从 内 存 中 清 
除 。 这 时 ， 堆 上 剩余 的 空间 被 压缩 ， 继 而 引起 CLR 修 改 活 动 应 用 程序 根 的 集合 ( 和 隐 含 的 指针 )， 指 
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向 正确 的 内 存 位 置 ( 这 些 都 是 自动 并 且 透 明 ? 地 完成 的 )。 最 后 ， 下 一 个 对 象 的 指针 被 重新 调整 以 指向 
下 一 个 可 用 的 位 置 。 图 13-4 说 明了 重新 调整 的 结果 。 





说 明 ”准确 地 说 ， 垃 圾 回收 器 使 用 了 两 个 不 同 的 堆 ， 一 个 专门 用 来 存储 非常 大 的 对 象 。 这 个 扒 在 回 
收 周期 中 较 少 顾及 ， 因 为 要 重新 定位 8 大 对 象 的 性 能 开销 很 大 。 尽 管 如 此 ， 认 为 “托管 堆 ” 是 
一 个 内 存 区 域 一 般 并 没有 什么 问题 。 


13.4 ”对 象 的 代 


当 CLR 试 图 寻找 不 可 访问 的 对 象 时 ， 它 不 会 逐个 检查 托管 堆 上 的 每 一 个 对 象 。 很 明显 ， 这 样 做 将 
花费 大 量 时 间 ， 尤 其 是 在 大 一 些 〈 即 实际 ) 的 应 用 程序 中 。 

为 了 帮助 优化 这 个 过 程 , 堆 上 的 每 一 个 对 象 被 指定 为 属于 某 “ 代 ”( generation )。 代 的 设计 思路 很 
简单 : 对 象 在 堆 上 存在 的 时 间 越 长 ， 它 就 更 可 能 应 该 保留 。 例 如 ， 定 义 桌面 应 用 程序 主 窗口 的 类 将 一 
直 停 留 在 内 存 中 直到 程序 结束 。 相 反 ， 最 近 才 放 在 堆 上 的 对 象 可 能 很 快 就 不 可 访问 了 例如 在 一 个 方 
法 作用 域 中 创建 的 对 象 )。 基 于 这 些 假设 , 堆 上 的 每 一 个 对 象 都 属于 下 列 某 代 。 

口 第 0 代 : 从 没有 被 标记 为 回收 的 新 分 配 的 对 象 。 

口 第 1 代 : 在 上 一 次 垃圾 回收 中 没有 被 回收 的 对 象 (也 就 是 ， 它 被 标记 为 回收 ， 但 因为 已 经 获取 

了 足够 的 堆 空 间 而 没有 被 删除 )。 
口 第 2 代 : 在 一 次 以 上 的 垃圾 回收 后 仍然 没有 被 回收 的 对 象 。 


说 明 第 0 代 和 第 1 代称 为 暂时 代 ( ephemeral generation )。 在 下 一 节 中 你 将 看 到 ， 垃 圾 回收 过 程 对 于 
暂时 代 的 处 理 是 不 同 的 。 


垃圾 回收 器 首先 要 调查 所 有 的 第 0 代 对 象 。 如 果 标 记 和 清除 这 些 对 象 得 到 了 所 需 数量 的 空闲 内 存 ， 
任何 没有 被 回收 的 对 象 都 被 提升 到 第 1 代 。 为 了 说 明 对 象 的 代 是 怎样 影响 回收 过 程 的 , 考虑 图 13-5, 它 


Q transparent， 用 于 修饰 或 说 明 一 种 进程 或 过 程 ， 它 允许 用 户 调用 它 ， 而 用 户 并 不 需 知道 它 的 存在 。 一 一 译 者 注 
@ relocate, 移动 计算 机 程序 或 它 的 一 部 分 , 并 调整 必要 的 基准 地 址 , 使 得 移动 后 的 程序 能 够 被 ( 装 和 内存 中 ) 执行 。 
一 一 译 者 注 
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图 示 了 一 旦 所 需 的 内 存 被 回收 后 ， 怎 样 提 升 没有 被 回收 的 第 0 代 对 象 集合 ( A、B 和 E )。 

如 果 算 上 所 有 的 第 0 代 对 象 后 ,仍然 需要 更 多 的 内 存 ， 就 会 检查 第 1 代 对 象 的 “可 访问 性 ”并 相应 
地 进行 回收 。 没 有 被 回收 的 第 1 代 对 象 随后 被 提升 到 第 2 代 。 如 果 垃 圾 回收 器 仍然 需要 更 多 的 内 存 ， 它 
会 检查 第 2 代 对 象 的 可 访问 性 。 这 时 ， 如 果 一 个 第 2 代 对 象 在 垃圾 回收 后 仍然 存在 ， 它 仍然 是 第 2 代 对 
象 ， 因 为 这 是 预定 义 的 对 象 代 的 上 限 。 

这 里 的 要 点 是 ,通过 给 堆 上 的 对 象 赋 一 个 表示 代 的 值 , 尽快 地 删除 一 些 较 新 的 对 象 ( 如 本 地 变量 )， 
而 不 会 经 常 “打扰 ”一 些 旧 对 象 ( 例如 程序 的 主 窗 体 )。 






| 国 


1 


图 13-5 在 一 次 垃圾 回收 后 幸存 的 第 0 代 对 象 被 提升 到 第 1 代 


中 


13.5 .NET 1.0 至 .NET 3.5 的 并 发 垃圾 回收 


在 .NET 4.0 之 前 ,运行 时 使 用 并 发 垃圾 回收 技术 来 清理 不 再 使 用 的 对 象 。 在 这 个 模型 下 ， 当 对 第 0 
代 或 第 1 代 (前面 说 过 这 两 代称 为 暂时 代 ) 对 象 执行 回收 时 ， 垃 圾 收集 器 会 暂时 挂 起 当前 进程 中 的 所 
有 活动 线程 ， 以 确保 应 用 程序 在 回收 过 程 中 不 会 访问 托管 堆 。 

我 们 将 在 第 19 章 中 介绍 线程 的 知识 , 这 里 只 需要 简单 地 将 其 理解 为 正在 运行 的 可 执行 文件 中 的 执 
行路 径 。 在 垃圾 回收 周期 完成 时 ， 挂 起 的 线程 可 以 继续 工作 。 幸 好 .NET 3.5 ( 及 以 前 版 本 ) 的 垃圾 回 
收 喜 经 过 高 度 优化 ， 你 很 少 能 注意 到 应 用 程序 中 的 这 种 短暂 中 断 。 

作为 优化 ， 并 发 垃圾 回收 通过 专门 的 线程 清理 不 在 暂时 代 中 的 对 象 。 这 降低 了 (但 并 没有 消除 ) 
判断 活动 线程 时 对 .NET 运 行 时 的 需求 。 此 外 ,并 发 垃圾 回收 允许 程序 在 回收 非 暂 时 代 时 继续 分 配 堆 上 
的 对 象 。 


13.6 .NET 4.0 及 后 续 版 本 


从 .NET Sa 改变 了 垃圾 回收 器 处 理 线程 挂 起 的 方式 ， 它 在 清理 托管 堆 上 的 对 象 时 ， 使 用 后 台 
垃圾 回收 。 尽 管 它 叫 这 个 名 称 , 但 并 不 意味 着 所 有 的 垃圾 回收 都 发 生 在 额外 的 后 台 执行 线程 。 后 台 垃 圾 
ey 而 对 于 暂时 代 上 的 对 象 ，.NET 运 行 时 将 使 用 一 个 专用 后 台 线 程 进行 回收 。 

.NET 4.0 或 更 高 版 本 的 垃圾 回收 大 大 减少 了 一 个 给 定 线 程 参 与 垃圾 回收 细节 时 必须 挂 起 的 时 间 。 
这 些 改进 的 最 终结 果 是 , 优化 了 清理 第 0 代 和 第 1 代 中 无 用 对 象 的 过 程 ， 并且 提升 了 程序 的 运行 时 性 能 
[这 对 那些 需要 较 短 ( 并且 可 预测 的 ) GC 中 断 时 间 的 实时 系统 来 说 是 非常 重要 的 ]。 
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但 是 ， 这 种 新 的 垃圾 回收 模式 不 会 对 如 何 构建 .NET 应 用 程序 产生 影响 。 实 际 上 ，.NET 垃 圾 回收 
器 可 以 不 在 人 工 直接 干预 的 情况 下 执行 其 工作 (微软 也 正在 透明 地 改进 回收 过 程 )。 


13.7 System.GC 类 型 


mscorlib.dll 程 序 集 提供 了 名 为 System.6C 的 类 类 型 , 它 可 以 通过 编程 使 用 一 些 静 态 成 员 与 垃圾 回收 
器 进行 交互 。 这 里 要 特别 注意 的 是 ， 极 少 需要 在 代码 中 直接 使 用 这 个 类 。 一 般 情况 下 ， 只 有 在 创建 那 
些 使 用 非 托管 资源 的 类 时 , 才 需 要 使 用 System.GC 的 成 员 。 例如, 使 用 .NET 平 台 调 用 协议 调用 基于 C 的 
Windows API， 或 一 些 非 常 低级 上 且 复杂 的 COM 互 操作 逻辑 。 表 13-1 提 供 了 一 些 值 得 注意 的 成 员 ( 完整 
的 细节 请 查询 .NET Framework 4.5 SDK 文 档 )。 


System.GC 的 成 员 
AddMemoryPressure() 
RemoveMemoryPressure() 


Collect() 


CollectionCount() 
GetGeneration() 


GetTotalMemory() 


MaxGeneration 
SuppressFinalize() 


MaitForPendingFinalizers() 


表 13-1 ”部 分 System.GC 类 型 成 员 

作 用 
可 以 指定 一 个 与 垃圾 回收 过 程 相关 的 、 代 表 调 用 对 象 “ 紧 急性 级 别 ”( 即 压 力 ) 
的 数值 。 要 明白 这 些 方法 应 该 一 前 一 后 地 修改 压力 ,这样 就 不 会 删除 比 所 增加 
的 总 数 更 多 的 压力 了 


强制 GC 进行 一 次 垃圾 回收 。 这 个 方法 已 被 重 载 ， 以 指定 要 回收 的 代 和 回收 模 
式 (通过 GCCollectionMode 枚 举 ) 


返回 一 个 数值 ， 表 示 已 经 对 某 一 代 进 行 了 多 少 次 垃圾 回收 
返回 一 个 对 象 当 前 的 代 


返回 当前 分 配 在 托管 堆 上 的 估计 的 内 存 数量 ( 以 字 节 为 单位 )。 布 尔 参数 指定 
调用 是 否 在 返回 前 等 待 垃圾 回收 的 发 生 


返回 目标 系统 支持 的 最 大 的 代 。 在 Microsoft 的 .NET 4.0 下 ， 可 能 有 3 代 (0、1 和 2 ) 
设置 一 个 标志 ， 说 明 这 些 对 象 不 需要 调用 Finalize() 方 法 

挂 起 当前 线程 直到 所 有 可 终结 的 对 象 都 被 终结 。 这 个 方法 通常 在 调用 
GC.Collect() 后 被 直接 调用 


为 了 了解 如 何 使 用 System.GC 类 型 来 获取 垃圾 回收 的 细节 ,考虑 下 面 的 Main() 方 法 , 它 使 用 了 GC 的 


部 分 成 员 : 


static void Main(string[] args) 


Console.WritelLine("***** Fun with System.GC *****"); 


// 输出 堆 上 估计 的 字 节 数量 


Console.WriteLine("Estimated bytes on heap: {0}", 


GC.GetTotalMemory(false)); 


// MaxGeneration 是 由 0 开始 的 ， 因 此 为 了 显示 的 目的 加 上 了 1 
Console.WriteLine("This 0S has {0} object generations.\n", 


(GC.MaxGeneration + 1)); 


Car refToMyCar = new Car("Zippy", 100); 
Console.WriteLine(refToMyCar.ToString()); 


// 输出 refToMyCar 对 象 的 代 
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Console.WriteLine("Generation of refToMyCar is: {0}", 
GC.GetGeneration(refToMyCar)); 


Console.ReadLine(); 


强制 垃圾 回收 


.NET 垃 圾 回收 器 的 功能 是 代替 我 们 管理 内 存 。 然 而 ， 在 一 些 非 常 罕见 的 环境 下 ， 通 过 编程 使 用 
GC.Collect() 强 制 垃圾 回收 可 能 会 有 好 处 。 以 下 是 你 可 能 会 考虑 与 回收 进程 交互 的 两 个 常见 场景 : 

口 应 用 程序 将 要 进入 一 段 代 码 ， 后 者 不 希望 被 可 能 的 垃圾 回收 中 断 ; 

口 应 用 程序 刚刚 分 配 非常 多 的 对 象 ， 你 想 尽 可 能 多 地 删除 已 获得 的 内 存 。 

如 果 你 确定 让 垃圾 回收 器 马上 检查 不 可 访问 对 象 可 能 有 好 处 ， 就 可 以 显 式 触发 一 次 垃圾 回收 ， 如 
下 所 示 : 


static void Main(string[] args) 


// 强制 一 次 垃圾 回收 ， 并 等 待 每 一 个 对 象 都 被 终结 
GC.Collect(); 
GC.WaitForPendingFinalizers(); 


} 

当 手动 强制 垃圾 回收 时 ， 应 该 总 是 调用 GC.WaitForpPendingFinalizers()。 这 样 你 可 以 稍 等 片刻 ， 
以 确定 在 程序 继续 执行 之 前 ， 所 有 可 终结 的 对 象 都 必须 执行 所 有 必要 的 清除 工作 。 在 底层 ， 
GC.WaitForPendingFinalizers() 会 在 回收 过 程 中 挂 起 调用 的 “线程 "。 这 是 件 好 事 ， 因 为 它 保证 代码 不 
调用 当前 正在 被 销毁 的 对 象 的 方法 。 

也 可 以 给 GC.Collect() 方 法 提供 一 个 数值 ， 该 数值 表示 垃圾 回收 将 要 操作 的 最 老 的 代 。 例 如 ， 如 
果 想 让 CLR 只 检查 第 0 代 对 象 ， 可 以 按 如 下 方式 编写 代码 : 


static void Main(string[] args) 


// 只 检查 第 0 代 对 象 
GC.Collect(0); 
GC.WaitForpendingFinalizers(); 


还 有 ，Collect() 方 法 还 可 以 传人 GCCollectionMode 枚 举 作为 第 二 个 参数 ,来 调整 运行 库 如 何 强 制 
进行 垃圾 回收 。enum 定 义 了 如 下 的 值 : 


public enum GCCollectionMode 


Default， // Forced 是 当前 默认 值 
Forced, // 告诉 运行 库 立 即 回收 
Optimized  // 允许 运行 库 检 测 当 前 时 间 是 否 适 合 回收 对 象 
像 任 何 垃 圾 回收 一 样 ， 调 用 GC.Collect() 会 提升 没有 被 回收 的 对 象 的 代 。 例 如 ， 按 如 下 所 示 修 改 
Main() 方 法 : 
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static void Main(string[] args) 
Console.WriteLine("***** Fun with System.GC *****"); 


// 输出 堆 上 估计 的 字 节 数 
Console.WriteLine("Estimated bytes on heap: {0}", 
GC.GetTotalMemory(false)); 


// MaxGeneration 是 从 0 开始 的 

Console.WritelLine("This OS has {0} object generations.\n", 
(GC.MaxGeneration + 1)); 

Car refToMyCar = new Car("Zippy", 100); 

Console.WriteLine(refToMyCar.ToString()); 


// 输出 refToMyCar 对 象 的 代 
Console.Writeline("\nGeneration of refToMyCar is: {0}", 
GC.GetGeneration(refToMyCar)); 


// 为 测试 目的 创建 对 象 数组 

object[] tons0fObjects = new object[50000]; 

for (int i = 0; i < 50000; i++) 
tonsOfObjects[i] = new object(); 


// 仅 回收 第 0 代 对 象 
GC.Collect(0, GCCollectionMode.Forced); 
GC.WaitForPendingFinalizers(); 


// 输出 refToMyCar 对 象 的 代 
Console.WritelLine("Generation of refToMyCar is: {0}", 
GC.GetGeneration(refToMyCar)); 


// 看 一 下 tons0f0bjects[9000] 是 否 还 活着 
if (tons0f0bjects[9000] != null) 
{ 


Console.WriteLine("Generation of tonsOfObjects[9000] is: {0}", 
GC.GetGeneration(tonsOfobjects[9000])); 
} 


else 
Console.WriteLine("tonsOfObjects[9000] is no longer alive."); 


// 输出 一 个 代 被 清除 的 次 数 

Console.WritelLine("\nGen 0 has been swept {0} times", 
GC.CollectionCount(0)); 

Console.WritelLine("Gen 1 has been swept {0} times", 
GC.CollectionCount(1)); 

Console.WriteLine("Gen 2 has been swept {0} times", 
GC.CollectionCount(2)); 

Console.ReadLine(); 


} 

在 这 里 , 我 们 为 了 测试 而 创建 了 一 个 非常 大 的 对 象 数 组 ( 精确 数量 是 50 000 )。 从 下 面 的 输出 结果 
中 可 以 看 到 ， 即 使 这 个 Main() 方 法 只 做 了 一 次 垃圾 回收 的 显 式 请 求 (通过 GC.Collect() 方 法 )，CLR 在 
幕后 也 执行 了 多 次 垃圾 回收 。 
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Zippy is going 100 MPH 


Generation of refToMyCar is: 0 
Generation of refToMyCar is: 1 
Generation of tonsOfObjects[9000] is: 1 


Gen 0 has been swept 1 times 
Gen 1 has been swept 0 times 
Gen 2 has been swept 0 times 





本 章 讲 到 这 里 ， 希望 你 对 对 象 生命 周期 的 相关 细节 已 经 有 了 些 认识 。 在 下 一 节 中 ， 通 过 讲解 怎样 
创建 可 终结 ( finalizable ) 对 象 和 可 处 置 ( disposable ) 对 象 来 更 深入 地 分 析 垃 圾 回收 过 程 。 要 明白 一 
点 : 下 面 的 技术 仅 在 创建 需要 维护 内 部 非 托 管 资源 的 C# 类 时 是 非常 必要 的 。 


源 代码 ”SimpleGC 项 目的 源 代码 位 于 Chapter 13 子 目录 下 。 


13.8 构建 可 终结 对 象 


在 第 6 章 中 ， 学 习 了 .NET 的 基 类 System.0bject， 它 定义 了 名 为 Finalize() 的 虚 方 法 。 训 无 疑问 ， 
这 个 方法 的 默认 实现 是 什么 都 不 做 的 : 


// System.0bject 
public class Object 
{ 


protected virtual void Finalize() {} 


当 为 自 定义 的 类 重 写 Finalize() 时 ,就 建立 了 一 个 地 方 , 来 为 类 型 执行 必要 的 清理 逻辑 。 因 为 
这 个 成 员 被 定义 为 受 保护 的 ,所 以 不 可 能 通过 点 操作 符 从 类 实例 中 直接 调用 一 个 对 象 的 Finalize() 
方法 。 相 反 ， 在 从 内 存 删除 这 个 对 象 之 前 ， 垃 圾 回收 器 会 调用 对 象 的 Finalize() 方 法 (如 果 支 持 
的 话 )。 





说 明 在 结构 类 型 上 重 写 Finalize() 是 不 合法 的 。 这 一 点 非常 重要 ， 因 为 结构 是 值 类 型 ， 它 们 本 来 就 
从 不 分 配 在 堆 上 ， 也 就 不 能 被 回收 。 但 是 ， 如 果 你 创建 的 结构 包含 需要 清理 的 非 托管 资源 ， 
可 以 实现 IDisposable 接 口 ( 稍 后 将 介绍 )。 


当然 , Finalize() 的 调用 将 ( 最 终 ) 发 生 在 一 次 “自然 的 ” 垃圾 回收 或 可 能 用 程序 通过 GC.Collect() 
强制 回收 的 过 程 中 。 另 外 ， 当 承载 应 用 程序 的 应 用 程序 域 从 内 存 中 印 载 时 ， 会 自动 调用 类 型 的 终结 器 
方法 。 有 些 读者 可 能 知道 应 用 程序 域 ( 或 简写 为 AppDomain ) 是 用 来 承载 一 个 可 执行 程序 集 和 任何 需 
要 的 外 部 代码 库 的 。 如 果 对 这 个 .NET 概 念 不 熟悉 ,不 用 着 急 , 在 学 习 完 第 17 章 后 你 自然 会 熟悉 。 简 单 
地 说 ， 当 应 用 程序 域 从 内 存 中 撮 载 时 ，CLR 自 动 调用 在 它 的 生命 周期 中 创建 的 每 一 个 可 终结 对 象 的 终 
结 器 。 
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现在 ,开发 者 的 直觉 告诉 你 ,大 多 数 C# 类 都 不 需要 显 式 地 清理 逻辑 ， 也 不 需要 自 定义 终结 器 。 原 
因 很 简单 : 如 果 类 使 用 了 其 他 托管 对 象 ， 一 切 都 最 终 会 被 回收 。 只 是 在 你 使 用 非 托 管 资 源 时 ( 例如 原 
始 的 操作 系统 文件 句柄 、 原 始 的 非 托管 数据 库 连 接 、 非 托管 内 存 或 其 他 非 托管 资源 )， 才 可 能 需要 设 
计 一 个 在 用 完 后 清理 自身 的 类 。 在 .NET 平 台 上 ， 非 托管 资源 是 通过 使 用 PInvoke (平台 调用 ) 服务 直 
接 调 用 操作 系统 的 API， 或 通过 一 些 复杂 的 COM 交 互 获得 的 。 因 此 ， 有 垃圾 回收 的 另 一 条 规则 。 


规则 ” 重 写 Finalize() 的 唯一 令 人 信服 的 理由 是 ，C# 类 通过 PInvoke 或 复杂 的 COM 互 操作 性 任务 使 用 
了 非 托 管 资 源 (一 般 情 况 是 通过 System.Runtime.InteropServices.Marshal 类 型 定义 的 各 成 
员 )。 原 因 是 在 这 些 场 景 下 ， 你 无 法 操作 没有 托管 在 CLR 的 内 存 。 


13.8.1 重 写 System.0bject.Finalize() 


在 极其 个 别 的 情况 下 ， 确 实 需要 创建 一 个 使 用 非 托管 资源 的 类 ， 你 显然 希望 保证 底层 内 存 以 一 种 
可 预测 的 方式 被 释放 。 假 设 创建 了 一 个 名 为 SimpleFinalize 的 新 控制 台 应 用 程序 项 目 并 且 插入 一 个 名 为 
MyResourceWrapper 的 使 用 非 托 管 资源 的 类 (无 论 怎样 都 是 有 可 能 的 )， 且 重 写 Finalize()。 在 C# 中 做 
这 件 事 比较 奇怪 ， 不 能 用 预期 的 override 关 键 字 来 做 : 


class MyResourceWrapper 


// 编译 时 错误 
protected override void Finalize(){ } 


当 想 配置 自 定义 的 C# 类 类 型 来 重 写 Finalize() 方 法 时 ， 可 以 使 用 下 面 的 (类 似 C++ 的 ) 析 构 函数 
语法 来 达到 同样 的 效果 。 之 所 以 要 用 这 种 重 写 虚 方法 的 替代 形式 , 是 因为 当 C# 编 译 器 执行 一 个 终结 器 
语法 时 ， 它 将 自动 在 被 隐 式 重 写 的 Finalize() 方 法 中 增加 许多 必需 的 基础 代码 ( 稍 后 介绍 )。 

C# 终 结 器 和 构造 函数 很 相似 ， 因 为 它们 和 定义 它们 的 类 具有 相同 的 名 字 。 此 外 , 终结 器 具有 波浪 
号 (~) 前 级 。 然 而 ， 和 构造 方法 不 同 的 是 , 终结 器 不 接受 访问 修饰 符 ( 它们 是 受 隐 式 保 护 的 )， 不 接 
受 参数 ， 也 不 能 被 重 载 ( 一 个 类 只 能 有 一 个 终结 器 )。 

下 面 是 MyResourcewrapper 自 定义 的 终结 器 ， 它 在 被 调用 时 会 触发 一 声 系 统 蜂 鸣 。 很 明显 ， 这 仅 是 
为 了 教学 的 目的 。 一 个 实际 的 终结 器 应 该 只 做 清除 任何 非 托管 资源 的 工作 ， 而 不 与 其 他 托管 对 象 的 成 
员 ( 即使 是 那些 由 当前 对 象 引 用 的 成 员 ) 进行 交互 , 因为 不 能 假设 它们 在 垃圾 回收 器 中 调用 Finalize() 
方法 时 还 存在 。 

// 用 终结 器 语法 重 写 System.0bject.Finalize() 

class MyResourceWrapper 

~MyResourceWrapper() 


// 清除 这 里 非 托 管 的 资源 


// 当 被 销毁 时 蜂 鸣 ( 仅 为 测试 目的 ) 
Console.Beep(); 
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如 果 用 ildasm.exe 查 看 这 个 C# 析 构 函 数 ， 将 看 到 编译 器 加 入 了 一 些 必要 的 错误 检测 代码 。 首 先 ， 
Finalize() 方 法 作用 域内 的 代码 段 放 在 了 一 个 try 块 中 ( 见 第 7 章 )。 相 关 的 finally 块 保证 基 类 的 
Finalize() 方 法 总 是 被 执行 ， 而 不 管 在 try 作 用 域内 遇 到 的 异常 是 什么 。 


.method family hidebysig virtual instance void 
Finalize() cil managed 


// 代码 尺寸 13 (0xd) 
.maxstack 1 
try 


IL 0000: ldc.i4 Ox4e20 

IL 0005: ldc.i4 Ox3e8 

IL 000a: call 

void [mscorlib]System.Console::Beep(int32, int32) 


IL_000f: nop 
IL 0010: nop 
IL 0011: leave.s IL 001b 
} // .try 结 束 
finally 
IL_0013: ldarg.0 
IL 0014: 
call instance void [mscorlib]System.Object::Finalize() 
IL 0019: nop 


IL 001a: endfinally 
}// 处 理 代码 结束 
IL 001b: nop 
IL 001c: ret 
] // MyResourceWrapper: :Finalize 方 法 结束 


如 果 现 在 测试 MyResourceWrapper 类 型 ， 将 发 现 系 统 蜂 鸣 发 生 在 应 用 程序 终止 时 ， 因 为 CIL 会 在 
AppDomain 关 闭 时 自动 调用 终结 胡 。 


static void Main(string[] args) 


Console.WritelLine("***** Fun With Finalizers *****\n"); 
Console.WriteLine("Hit the return key to shut down this app"); 
Console.WritelLine("and force the GC to invoke Finalize()"); 
Console.WriteLine("for finalizable objects created in this AppDomain."); 
Console.ReadLine(); 

MyResourceWrapper rw = new MyResourceWrapper(); 


源 代码 ”SimpleFinalize 项 目的 源 代 码 位 于 Chapter 13 子 目录 下 。 


13.8.2 ”终结 过 程 的 细节 


始终 要 牢记 ，Finalize() 方 法 的 作用 是 保证 .NET 对 象 能 在 垃圾 回收 时 清除 非 托 管 资源 。 这 样 ， 
de pd: 内 存 的 类 型 ( 到 目前 为 止 这 是 最 常见 的 情况 )， 终 结 是 没有 用 的 。 事 

， 只 要 有 可 能 的 话 ， 就 应 该 在 设计 类 型 时 避免 提供 Finalize() 方 法 ， 原 因 很 简单 ， 终 结 是 要 花 
Rs 
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当 在 托管 堆 上 分 配对 象 时 ， 运 行 库 自动 确定 该 对 象 是 否 提 供 一 个 自 定义 的 Finalize() 方 法 。 如 果 
是 这 样 , 对 象 被 标记 为 可 终结 的 , 同时 一 个 指向 这 个 对 象 的 指针 被 保存 在 名 为 终结 队列 的 内 部 队列 中 。 
终结 队列 是 一 个 由 垃圾 回收 器 维护 的 表 ， 它 指向 每 一 个 在 从 堆 上 删除 之 前 必须 被 终结 的 对 象 。 

当 垃 圾 回收 器 确定 到 了 从 内 存 中 释放 一 个 对 象 的 时 间 时 ， 它 检查 终结 队列 上 的 每 一 个 项 ， 并 将 对 
象 从 堆 上 复制 到 另 一 个 称 作 终 结 可 达 表 (finalization reachable table ) (通常 简写 为 freachable， 读 音 为 
effreachable ) 的 托管 结构 上 。 此 时 ， 下 一 个 垃圾 回收 时 将 产生 男 一 个 线程 ， 为 每 一 个 在 可 达 表 中 的 对 
象 调用 Finalize() 方 法 。 因 此 ， 为 了 真正 终结 一 个 对 象 ， 至 少 要 进行 两 次 垃圾 回收 。 

总 而 言 之 ， 尽 管 对 象 的 终结 能 够 保证 对 象 可 以 清除 非 托 管 的 资源 ， 但 它 本 质 上 仍然 是 非 确 定 的 ， 
而 且 由 于 额外 的 幕后 处 理 ， 速 度 会 变 得 相当 慢 。 


13.9 构建 可 处 置 对 象 


当 垃 圾 回收 生效 时 ， 可 以 利用 终结 器 来 释放 非 托 管 资源 。 然 而 ， 因 为 很 多 非 托 管 资源 都 非常 宝贵 
(如 数据 库 和 文件 句柄 )， 所 以 它们 应 该 尽 可 能 快 地 被 清除 ， 而 不 能 依靠 垃圾 回收 的 发 生 。 除 了 重 写 
Finalize() 之 外 ， 类 还 可 以 实现 IDisposable 接 口 ， 它 定义 了 一 个 名 为 Dispose() 的 方法 : 


public interface IDisposable 


void Dispose(); 


如 果实 现 了 IDisposable 接 口 , 就 是 假设 当 对 象 用 户 不 再 使 用 这 个 对 象 时 , 会 在 这 个 对 象 引用 离开 
作用 域 之 前 手工 调用 Dispose()。 这样, 对象 可 以 执行 任何 必要 的 非 托 管 资源 的 清除 工作 , 而 且 不 会 再 
有 将 对 象 放 在 终结 队列 上 导致 的 性 能 损失 ， 也 不 必 等 待 垃圾 回收 器 触发 类 的 终结 逻辑 。 


说 明 结构 和 类 类 型 都 可 以 实现 IDisposable ( 与 重 写 Finalize() 不 同 ， 后 者 只 适用 于 类 类 型 )， 因 为 
对 象 用户 (不 是 垃圾 回收 器 ) 会 调用 Dispose() 方 法 。 


创建 一 个 名 为 SimpleDispose 的 新 控制 台 应 用 程序 项 目 来 说 明 IDisposable 接 口 的 使 用 。 如 下 修改 的 
MyResourceWrapper 类 现在 实现 了 IDisposable， 而 没有 重 写 System.0bject.Finalize() : 


// 实现 IDisposable 
class MyResourceWrapper : IDisposable 


// 对 象 用 户 应 该 在 完成 使 用 这 个 对 象 时 调用 这 个 方法 
public void Dispose() 


// 在 这 里 清除 非 托 管 资源 
// 抛弃 包含 的 其 他 可 处 置 对 象 
// 出 于 测试 目的 


Console.WriteLine("***** In Dispose! *****"); 


} 
注意 , Dispose() 方 法 不 只 负责 释放 一 个 对 象 的 非 托管 资源 , 还 应 该 对 任何 它 包含 的 可 处 置 对 象 调 


13.9 ”构建 可 处 置 对 象 395 


用 Dispose()。 与 Finalize() 不 一 样 , 在 Dispose() 方 法 中 与 其 他 托管 对 象 通信 是 很 安全 的 。 原因 很 简单 : 
垃圾 回收 器 并 不 支持 IDisposable 接 口 ， 永 远 都 不 会 调用 Dispose()。 因 此 ， 当 对 象 的 用 户 调 用 这 个 方 
法 时 ， 对 象 仍然 在 托管 堆 上 ， 并 可 以 访问 所 有 其 他 分 配 在 堆 上 的 对 象 。 调 用 人 逻辑 很 直接 : 


class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Dispose *****\n"); 
// 创建 一 个 可 处 置 对 象 并 调用 Dispose()， 从 而 释放 所 有 内 部 资源 
MyResourceWrapper rw = new MyResourceWrapper(); 
rw.Dispose(); 
Console.ReadLine(); 
} 
} 


当然 ， 在 试图 调用 一 个 对 象 的 Dispose() 之 前 ， 需 要 保证 类 型 支持 IDisposable 接 口 。 虽 然 通过 查 
询 .NET Framwork 4.5 SDK 文 档 ， 也 可 以 知道 哪 一 个 基础 类 库 类 型 实现 了 IDisposable， 但 可 以 使 用 在 
第 6 章 讨 论 的 is 或 as 关键 字 通 过 编程 来 完成 检查 : 
class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun With Dispose *****\n"); 
MyResourceWrapper rw = new MyResourceWrapper(); 
if (rw is IDisposable) 
rw.Dispose(); 
Console.ReadLine(); 


这 个 示例 说 明了 内 存 管理 的 另 一 个 规则 。 





规则 ”如果 对 象 支持 IDisposable， 最 好 对 任何 直接 创建 的 对 象 调用 Dispose()。 应 该 认为 ， 如 果 类 设 
计 者 选择 支持 Dispose() 方 法 ， 这 个 类 型 就 需要 执行 清除 工作 。 如 果 忘 记 了 这 么 做 ， 内 存 仍 将 
被 清理 ( 所 以 不 必 枣 懂 )， 只 是 会 需要 更 长 的 时 间 。 








对 于 之 前 的 规则 , 还 有 一 个 补充 : 基础 类 库 中 的 许多 类 型 都 实现 了 IDisposable 接 口 ， 并且 还 提供 
了 Dispose() 方 法 的 一 个 别名 ( 有 点 混淆 ), 这 样 使 得 定义 类 型 的 释放 相关 的 方法 听 上 去 更 自然 。 例 如 ， 
System.I0.FileStream 类 实现 了 IDisposable ( 因此 也 支持 Dispose() 方 法 )， 它 还 定义 了 用 于 相同 目的 
的 Close() 方 法 : 

// 假设 我 们 已 经 导入 了 System.I0 命 名 空间 

static void DisposeFileStream() 


FileStream fs = new FileStream("myFile.txt", FileMode.OpenOrCreate); 


// 确实 有 点 混 消 ， 这 两 个 方法 调用 完成 相同 的 事情 
fs.Close(); 
fs.Dispose(); 
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虽然 关闭 一 个 文件 比 释 放 更 自然 , 但 是 你 可 能 也 觉得 重复 的 清理 的 方法 很 容易 混淆 。 由 于 提供 别 
名 的 类 型 也 不 是 很 多 ， 我们 只 要 记 住 ， 如 果 类 型 实现 了 IDisposable， 调用 Dispose() 总 是 安全 的 。 


重用 C# 的 using 关 键 字 


处 理 实现 了 IDisposable 的 托管 对 象 时 ， 经 常 需要 使 用 结构 化 异常 处 理 来 保证 类 型 的 Dispose() 方 
法 在 出 现 运行 时 异常 时 被 调用 : 
static void Main(string[] args) 


Console.Writeline("***** Fun with Dispose *****\n"); 
MyResourceWrapper rw = new MyResourceWrapper (); 
try 


{ 
// 使 用 rw 的 成 员 
finally 
{ 
// 无 论 是 否 发 生 错 误 ， 总 是 调用 Dispose() 
rw.Dispose(); 
} 
虽然 这 是 一 个 很 好 的 防御 性 编程 的 例子 , 但 实际 情况 是 , 如 果 只 是 为 了 保证 调用 Dispose() 方 法 而 
把 每 个 可 处 置 的 类 型 包装 在 try/finally 块 中 , 几乎 不 会 有 开发 者 愿意 这 么 做 。 为 了 用 更 邻 人 接受 的 方 
式 达 到 同样 的 结果 ，C# 提 供 了 一 个 如 下 的 特殊 语法 : 
static void Main(string[] args) 
Console.WriteLine("***** Fun with Dispose *****\n"); 


// 当 退 出 Using 作用 域 时 ， 自 动 调用 Dispose() 
using(MyResourceWrapper rw = new MyResourceWrapper()) 


// 使 用 rw 对 象 
} 
如 果 使 用 ildasm.exe 查 看 Main() 方 法 的 CIL 代 码 ， 会 发 现 using 语 法 确实 用 Dispose() 调 用 扩展 了 
try/finally 逻 辑 : 
.method private hidebysig static void Main(string[] args) cil managed 
try 
{ 
} // .try 结束 
finally 
{ 


IL 0012: callvirt instance void 
SimpleFinalize.MyResourceWrapper: :Dispose() 
}// 处 理 代码 结束 


] 77 Program: :Main 方 法 结束 
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说 明 ”如 果 试 图 “使 用 ”一 个 没有 实现 IDisposable 的 对 象 ， 将 会 收 到 编译 器 错误 。 


虽然 这 个 语法 的 确 免 去 了 将 可 处 置 对 象 手工 包装 在 try/finally 逻 辑 中 的 需要 ， 但 C# 的 using 关 键 
字 现 在 却 有 了 双重 含义 (指定 命名 空间 和 调用 Dispose() 方 法 )。 不 过 ， 当 使 用 支持 IDisposable 接 口 
的 .NET 类 型 时 , 这 个 句法 结构 将 保证 一 旦 退出 了 using 块 ,“ 正 在 使 用 ”的 对 象 将 自动 调用 其 Dispose() 
5 

同样 ， 还 要 知道 可 以 在 using 作 用 域 中 声明 相同 类 型 的 多 个 对 象 。 和 我 们 期 望 的 那样 ， 编 译 器 会 
插入 代码 来 调用 每 一 个 声明 对 象 的 Dispose()。 

static void Main(string[] args) 


Console.WriteLine("***** Fun with Dispose *****\n"); 


// 使 用 过 号 分 定 的 列表 来 声明 多 个 要 释放 的 对 象 
using(MyResourceWrapper rw = new MyResourceWrapper(), 
ITw2 = new MyResourceWrapper()) 


{ 
// 使 用 rw 和 Tw2 对 象 


源 代 码 ”SimpleDispose 项 目的 源 代码 位 于 Chapter 13 子 目录 下 。 
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现在 ,我 们 已 看 到 了 两 种 方式 来 构造 能 够 清理 内 部 非 托 管 资 源 的 类 。 一 方面 ,我们 可 以 使 用 终结 
器 。 这 个 技术 我 们 尽 可 以 放心 使 用 ， 因 为 知道 对 象 可 以 不 需要 用 户 参 与 进行 垃圾 回收 ,清除 它 自身 。 
男 一 方面 , 我 们 可 以 实现 IDisposable， 给 对 象 用 户 提 供 一 种 一 旦 对 象 用 完 就 能 清除 的 方法 。 然 而 ， 如 
果 调 用 者 忘记 调用 Dispose()， 非 托管 资源 可 能 会 永远 留 在 内 存 中 。 

将 两 个 技术 混合 进 同一 个 类 定义 是 可 行 的 。 这 样 做 可 以 获得 两 种 模型 的 好 处 。 如 果 对 象 用 户 记 住 
了 调用 Dispose(), 可 以 通过 调用 GC.SuppressFinalize() 通 知 垃圾 回收 器 跳 过 终结 过 程 ; 如 果 对 象 用 户 
忘记 了 调用 Dispose(), 对 象 最 终 也 将 被 终结 并 有 机 会 释放 内 部 资源 。 对象 的 内 部 非 托 管 资源 会 用 其 中 
一 种 方式 释放 掉 。 

下 面 是 修改 后 的 MyResourceWrapper, 它 现 在 既是 可 终结 的 , 也 是 可 处 置 的 , 它 定义 在 C# 控 制 台 应 
用 程序 FinalizableDisposableClass 中 : 


// 高 级 的 资源 包装 器 
public class MyResourceWrapper : IDisposable 





// 如 果 对 象 用 户 忘记 调用 Dispose()， 垃 圾 回收 器 会 调用 这 个 方法 
~MyResourceWrapper() 


// 清除 所 有 内 部 的 非 托管 资源 
// 不 要 调用 任何 托管 对 象 的 Dispose() 
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// 对 象 用 户 将 调用 这 个 方法 来 尽快 清除 资源 
public void Dispose() 


// 在 这 里 清除 非 托 管 资源 
// 在 其 他 包含 的 可 处 置 对 象 上 调用 Dispose() 
// 如 果 用 户 调用 了 Dispose() 就 不 需要 终结 ， 因 此 跳 过 终结 
GC.SuppressFinalize(this); 
} 
注意 ，Dispose() 方 法 已 被 修改 为 调用 GC.SupressFinalize()， 它 通知 CLR 在 对 象 被 回收 时 不 再 需 
要 调用 析 构 函数 ， 因 为 非 托 管 资源 已 经 通过 Dispose() 人 逻辑 被 释放 了 。 


正式 的 处 置 模式 


上 面 的 MyResourceWrapper 实 现 的 确 能 很 好 地 工作 ， 然 而 ， 它 有 一 些小 缺陷 。 首 先 ，Finalize() 和 
Dispose() 方 法 都 要 清除 相同 的 非 托 管 资 源 。 这 当然 导致 了 重复 的 代码 , 它 很 容易 使 维护 复杂 化 。 理 想 
情况 下 ， 应 该 定义 一 个 私有 的 辅助 函数 供 两 个 方法 调用 。 

下 面 ， 我 们 要 确保 Finalize() 方 法 不 会 尝试 处 置 任何 托管 对 象 ， 而 Dispose() 方 法 则 应 该 这 样 做 。 
最 后 ， 还 要 确保 对 象 用 户 可 以 安全 地 多 次 调用 Dispose() 而 不 出 错 。 当 前 ， 我 们 的 Dispose() 方 法 没有 
这 样 的 安全 措施 。 

为 了 解决 这 些 设 计 问 题 ， 微 软 定义 了 一 个 正式 甚至 有 些 刻 板 的 处 置 模式 ， 它 在 健壮 性 、 可 维护 性 
和 性 能 三 者 间 取 得 了 平衡 。 下 面 是 使 用 了 这 个 官方 模式 的 MyResourceWrapper 的 最 终 ( 上 且 有 注释 的 ) 
版 本 : 


class MyResourceWrapper : IDisposable 


{ 
// 用 来 判断 Dispose() 是 否 已 经 被 调用 
private bool disposed = false; 


public void Dispose() 
// 调用 辅助 方法 
// 指定 true 表 示 对 象 用 户 触发 了 清理 过 程 
CleanUp(true); 
// 现在 跳 过 终结 
GC.SuppressFinalize(this); 


private void CleanUp(bool disposing) 


{ 
// 保证 我 们 还 没有 被 处 置 
if (!this.disposed) 


{ 
// 如 果 disposing 等 于 true， 释 放 所 有 托管 的 资源 
if (disposing) 


和 
人 
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disposed = true; 


~MyResourceWrapper() 
{ 


// 调用 辅助 方法 
// 指定 false 表 示 GC 触 发 了 清理 过 程 
CleanUp(false); 


} 

注意 ,MyResourceWrapper 现 在 定义 了 名 为 CleanUp() 的 私有 辅助 方法 。 当 指定 true 为 参数 时 ,表示 
对 象 用 户 初始 化 了 清理 过 程 ， 因 此 应 该 清理 所 有 托管 的 和 非 托管 的 资源 。 然 而 ， 当 垃圾 回收 器 初始 化 
清理 过 程 时 ， 调 用 CleanUp() 时 要 指定 false， 以 保证 内 部 的 可 处 置 对 象 不 被 处 置 〈 因为 我 们 不 能 假设 
它们 仍然 在 内 存 中 ), 最 后 , 布尔 成 员 变 量 ( disposed ) 在 退出 CleanUp() 之 前 设置 为 true, 以 保证 Dispose() 
可 以 被 多 次 调用 而 不 出 错 。 


说 明 当 一 个 对 象 被 “处 置 ” 后 ， 它 仍然 在 内 存 中 ， 因 此 仍然 可 以 在 客户 端 调用 其 成 员 。 因 此 ， 一 
个 健壮 的 资源 包装 器 类 还 需要 更 新 类 中 的 所 有 成 员 ， 添 加 这 样 的 逻辑 : “如 果 对 象 被 处 置 了 ， 
就 直接 返回 ， 什 么 都 不 做 。 


为 了 测试 MyResourceWrapper， 在 终结 器 作用 域 中 加 入 对 Console.Beep() 的 调用 ， 如 下 所 示 : 
~MyResourceWrapper() 
Console.Beep(); 


// 调用 辅助 方法 。 指 定 false 表 示 GC 触 发 了 清理 过 程 
CleanUp (false); 


接 下 来 修改 Main() 方 法 : 


static void Main(string[] args) 
Console.Writeline("***** Dispose() / Destructor Combo Platter *****"); 


// 手动 调用 Dispose()， 这 不 会 调用 终结 器 
MyResourceWrapper rw = new MyResourceWrapper(); 


rw.Dispose(); 
// 不 调用 Dispose()， 这 会 触发 终结 器 ， 并 引起 嘟 嘟 声 


MyResourceWrapper rw2 = new MyResourceWrapper(); 


注意 我 们 显 式 调用 了 rw 对 象 的 Dispose() 方 法 , 因此 不 会 产生 析 构 函数 调用 。 然而, 我 们 忘记 调用 
rw2 对 象 的 Dispose()， 因 此 应 用 程序 终结 时 ， 我 们 会 听 到 一 声 嘟 嘟 声 。 如 果 我 们 注释 掉 对 rw 对 象 调 用 
Dispose()， 就 会 听 到 两 声 嘟 嘟 声 。 


源 代码 ”FinalizableDisposableClass 项 目的 源 代码 位 于 Chapter 13 子 目录 下 。 


我 们 对 CLR 通 过 垃圾 回收 需 来 管理 对 象 的 研究 终于 结束 了 。 虽 然 垃圾 回收 过 程 还 有 一 些 深 奥 的 细 
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节 [ 例 如 弱 引 用 ( weak reference ) 和 对 象 复 苏 ( object resurrection ) ] 没 有 分 析 ， 不 过 你 通过 前 面 的 学 
习 完 全 可 以 自己 进行 更 深 的 探讨 了 。 在 本 章 最 后 ， 我 们 介绍 一 个 .NET 4.0 的 新 特性 一 一 对 象 的 “延迟 
对 象 实例 化 ”。 


13.11 延迟 对 象 实例 化 


在 创建 类 时 ， 可 能 偶尔 会 在 代码 中 添加 一 个 永远 不 会 被 使 用 的 特殊 成 员 变量 ， 因 为 用 户 不 会 调用 使 
用 了 它们 的 方法 (或 属性 ), 这 很 正常 。 但 是 , 如 果 成 员 变量 的 初始 化 需要 很 大 的 内 存 空间 , 问题 就 来 了 。 
例如 ， 假 设 你 正在 编写 一 个 封装 了 数字 音乐 播放 器 操作 的 类 。 除 了 预期 的 方法 ， 如 Play() 、Pause() 
和 Stop() 之 外 ， 你 还 要 返回 一 个 Song 对 象 集 合 ( 通过 AllTracks 类 )， 表 示 设 备 上 的 各 个 数字 音乐 文件 。 
新 建 一 个 Console Application ， 命 名 为 LazyObjectInstantiation， 并 定义 如 下 的 类 类 型 : 


// 表示 一 首 歌 曲 
class Song 


public string Artist { get; set; } 
public string TrackName { get; set; } 
public double TrackLength { get; set; } 


// 表示 播放 器 上 的 所 有 歌曲 
class AllTracks 


// 该 多 媒体 播放 器 最 多 可 容纳 10 000 首 歌曲 
private Song[] allSongs = new Song[10000]; 


public AllTracks() 


{ 
// 假设 用 Song 对 象 填充 了 数组 
Console.WriteLine("Filling up the songs!"); 


} 


// MediaPlayer 包 含 AllTracks 对 象 
class Mediaplayer 


// 假设 这 些 方法 包含 相应 的 功能 

public void Play() { /* 播放 歌曲 */ } 
public void Pause() { /* 暂停 歌曲 */ } 
public void Stop() { /* 停止 播放 */ } 


private AllTracks allSongs = new AllTracks(); 
public AllTracks GetAllTracks() 


// 返回 所 有 的 歌曲 
return allSongs; 
} 
在 当前 的 MediaPlayer 实 现 中 ， 我 们 假设 用 户 希 望 通过 GetAllTracks() 方 法 获取 歌曲 的 列表 。 但 如 
果 用 户 不 需要 这 个 列表 呢 ? 在 我 们 当前 的 实现 中 ，AllTracks 成 员 变量 仍 将 被 分 配 ， 并 在 内 存 中 创建 
10 000 个 Song 对 象 ， 如 下 所 示 : 
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static void Main(string[] args) 


// 这 次 调用 不 需要 获取 所 有 的 歌曲 ， 但 却 间接 地 创建 了 10 000 个 对 象 
MediaPlayer myPlayer = new Mediaplayer(); 
myPlayer.Play(); 


Console.ReadLine(); 


你 显然 不 愿意 创建 10 000 个 没 人 使 用 的 对 象 ， 因 为 这 大 大 增加 了 .NET 垃 圾 回收 器 的 压力 。 尽 管 你 
可 以 手工 添加 一 些 代 码 来 确保 只 有 在 使 用 的 时 候 才 创建 alsongs 对 象 ( 如 使 用 工厂 方法 设计 模式 ), 但 
实际 上 还 存在 一 种 更 简单 的 方式 。 

基础 类 库 提供 了 一 个 非常 有 用 的 泛 型 类 Lazyk>， 它 定义 在 mscorlib.dl11 内 的 System 命名 空间 下 。 
该 类 所 定义 的 数据 在 代码 库 实际 使 用 它 之 前 是 不 会 被 创建 的 。 由 于 它 是 一 个 泛 型 类 ， 因 此 第 一 次 使 用 
时 必须 指定 要 创建 的 项 的 类 型 ， 可 以 是 任意 .NET 基 础 类 库 中 的 类 型 或 自 定义 类 型 。 要 让 AllTracks 成 
员 变 量 支持 延迟 实例 化 ， 可 以 将 下 面 的 代码 : 

// MediaPlayer 包 含 AllTracks 对 象 


class Mediaplayer 
”private AllTracks allSongs = new AllTracks(); 
public AllTracks GetAllTracks() 


// 返回 所 有 歌曲 
return allSongs; 


} 
改 成 : 
// MediaPlayer 包 含 Lazy<AllTracks> 对 象 


class Mediaplayer 
private Lazy<AllTracks> allSongs = new Lazy<AllTracks>(); 
public AllTracks GetAllTracks() 


{ 
// 返回 所 有 歌曲 
return allSongs.Value; 





} 

现在 我 们 用 Lazy<> 类 型 来 表示 AllTracks 成 员 变 量 ， 除 此 之 外 ， 还 要 注意 GetAllTracks() 方 法 也 被 
修改 了 。 在 获取 实际 存储 的 数据 时 (本 例 中 为 包含 10 000 个 song 对 象 的 AllTracks 对 象 )， 我 们 必须 使 
用 Lazy<> 类 的 只 读 属 性 Value。 

进行 如 此 简单 的 修改 之 后 ，Main() 方 法 只 有 在 调用 GetAllTracks() 方 法 后 才 会 间接 分 配 Song 对 象 ， 
如 下 所 示 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with Lazy Instantiation *****\n"); 


// 这 里 没有 分 配 AllTracks 对 象 
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Mediaplayer myPlayer = new MediaPlayer(); 
myPlayer.Play(); 


// 在 调用 GetAllTracks() 时 分 配 AllTracks 
Mediaplayer yourPlayer = new Mediaplayer(); 
AllTracks yourMusic = yourPlayer.GetAllTracks(); 


Console.ReadLine(); 


说 明 延迟 对 象 初始 化 不 仅 可 以 降低 不 必要 的 对 象 分 配 ， 还 可 用 于 拥有 昂贵 创建 代码 的 成 员 ， 如 调 
用 远程 方法 、 连 接 关 系 型 数据 库 ， 等 等 。 


定制 延迟 数据 的 创建 


在 声明 Lazy<> 变 量 时 ， 将 使 用 默认 的 构造 函数 创建 实际 的 内 部 数据 类 型 : 


// 在 使 用 Lazy< 变量 > 时 将 调用 AllTracks 的 默认 构造 函数 
private Lazy<AllTracks> allSongs = new Lazy<AllTracks>(); 


虽然 这 在 某 些 情况 下 没有 问题 , 但 如 果 AllTracks 类 包含 其 他 的 构造 函数 ,并 且 你 想 调 用 它们 , 会 
如 何 呢 ?此 外 ， 如 果 在 建立 Lazy<> 变 量 时 还 有 额外 的 工作 要 做 (不 只 是 创建 Al1Tracks 对 象 )， 这 时 又 
会 如 何 呢 ? 幸 好 Lazy<> 类 允许 指定 一 个 泛 型 委托 作为 可 选 参 数 。 在 创建 其 包装 的 类 型 时 ， 它 将 调用 指 
定 的 方法 。 

该 泛 型 委托 的 类 型 为 system.Func<>, 它 所 指向 的 方法 的 返回 值 类 型 与 相关 的 Lazy<> 变 量 所 创建 的 
类 型 是 相同 的 , 并 且 可 以 包含 16 个 参数 ( 用 泛 型 类 型 参数 表示 )。 在 大 多 数 情况 下 ， 都 不 需要 向 Func<> 
所 指向 的 方法 传人 任何 参数 。 此 外 ， 为 了 简化 Funck> 的 用 法 ， 我 建议 你 使 用 Lambda 表 达 式 (委托 与 
Lambda 的 关系 详 见 第 10 章 )。 

记 住 MediaPlayer 的 最 终 版 本 在 创建 包装 的 AllTracks 对 象 时 添加 了 一 些 自 定义 代码 。 该 方法 在 退 
出 之 前 必须 返回 Lazy<> 所 包装 对 象 的 新 实例 ， 在 创建 该 实例 时 可 以 选择 任意 的 构造 函数 ( 这 里 我 们 仍 
然 调用 AlL1Tracks 的 默认 构造 郴 数 ): 


class Mediaplayer 


// 在 创建 AllTracks 对 象 时 使 用 Lambda 表 达 式 添加 额外 的 代码 
private Lazy<AllTracks> allSongs = new Lazy<AllTracks>( () => 


Console.WritelLine("Creating AllTracks object!"); 
return new AllTracks(); 


); 
public AllTracks GetAllTracks() 


{ 
// 返回 所 有 的 歌曲 
return allSongs.Value; 
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希望 你 能 看 到 Lazy<> 类 的 用 法 。 从 根本 上 说 ， 这 个 新 的 泛 型 类 可 以 确保 昂贵 的 对 象 只 在 用 户 需 要 
的 时 候 才 进行 分 配 。 如 果 你 觉得 该 话题 对 你 的 项 目 有 用 ， 可 以 查看 .NET Framework 4.5 SDK 文 档 中 的 
System.Lazy<> 类 ， 来 获取 关于 “延迟 初始 化 ”编程 的 更 多 示例 。 


源 代码 ”LazyObjectInstantiation 项 目的 源 代码 位 于 Chapter 13 子 目录 下 。 


13.12 ”小结 


本 章 的 中 心 是 解密 垃圾 回收 过 程 。 可 以 看 到 , 垃圾 回收 器 仅 当 它 不 能 从 托管 堆 获得 所 需要 的 内 存 
时 才 运 行 〈 或 是 当 指定 的 应 用 程序 域 从 内 存 外 载 时 )。 在 有 垃圾 回收 时 ， 我 们 大 可 以 放心 ， 因 为 微软 
的 回收 算法 已 经 通过 使 用 对 象 代 、 用 于 对 象 终结 的 辅助 线程 和 专门 承载 大 对 象 的 托管 堆 优化 过 了 。 

本 章 还 举例 说 明了 怎样 通过 程序 使 用 System.GC 类 类 型 与 垃圾 回收 器 进行 交互 。 前面 提 到 , 唯一 真 
正 需 要 这 么 做 的 情况 是 ,创建 在 非 托 管 资源 上 操作 的 可 终结 或 可 处 置 类 类 型 。 

回想 一 下 ， 可 终结 类 型 是 重 写 了 System.0bject.Finalize() 虚 方法 以 在 回收 垃圾 时 清除 非 托 管 资 
源 的 类 。 而 可 处 置 对 象 是 提供 了 析 构 函数 (通过 重 写 Finalize() 方 法 ) 类 ,对象 用 户 将 在 IDisposable 
接口 被 实现 后 调用 它 。 最 后 我 们 学 习 了 结合 两 种 方式 的 官方 的 “处 置 ”模式 。 

本 章 结 尾 我 们 学 习 了 .NET 4.0 中 的 一 个 新 泛 型 类 Lazy<>。 如 你 所 见 ， 使 用 该 类 可 以 将 昂贵 (也 就 
是 消耗 内 存 大 的 ) 对 象 的 创建 推迟 到 用 户 实际 需要 的 时 候 。 这 样 ， 可 以 减少 在 托管 堆 中 存储 的 对 象 数 
量 ， 同 时 还 能 确保 昂贵 的 对 象 只 在 真正 需要 的 时 候 才 由 调用 者 创建 。 
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本 书 前 四 部 分 中 ， 我 们 学 习 创建 了 大 量 “ 独 立 ” 的 可 执行 应 用 程序 ， 所 有 的 程序 逻辑 都 打 

士 包 在 一 个 单独 的 可 执行 文件 (*.exe ) 中 。 这 些 可 执行 程序 集 只 是 用 了 主要 的 .NET 类 库 

mscorlib.dll。 尽 管 一 些 简单 的 .NET 程 序 可 以 只 使 用 .NET 基 类 库 构建 , 但 对 你 (或 你 的 同事 ) 来 说 , 将 
可 复 用 的 程序 逻辑 隔离 到 自 定 义 的 类 库 (*.dl! 文 件 ) 中 供应 用 程序 共享 ， 会 是 司空 见 惯 的 事 。 

本 章 会 学 习 将 类 型 打包 到 自 定 义 代码 库 中 的 多 种 方式 。 首 先 ， 我 们 会 学 习 将 类 型 隔离 到 命名 空间 
的 细节 。 之 后 ， 将 介绍 Visual Studio 中 的 类 库 项 目 模板 ， 并 学 习 私 有 程序 集 和 共享 程序 集 的 区 别 。 

接 下 来 我 们 将 分 析 .NET 运 行 库 如 何 解析 一 个 程序 集 的 位 置 , 并 进而 理解 全 局 程序 集 缓存 (GAC )、 
XML 应 用 程序 配置 文件 (*.config 文 件 )、 发 行者 策略 程序 集 以 及 System.Configuration 命 名 空间 。 
14.1 定义 自 定 义 命名 空间 

在 深入 库 部 署 和 配置 的 内 容 之 前 , 首先 要 学 习 的 是 将 自 定 义 类 型 打包 到 .NET 命 名 空间 的 细节 。 至 
此 ， 我 们 已 经 构建 了 很 多 小 的 测试 程序 ， 它 们 使 用 .NET 世界 中 既 有 的 命名 空间 ( 特别 是 System )。 然 
而 ， 当 构建 包含 很 多 类 型 的 大 型 应 用 程序 时 ， 把 相关 类 型 分 组 到 自 定 义 命 名 空间 中 很 有 用 。 在 C# 中 ， 
这 是 通过 namespace 关 键 字 来 完成 的 。 创 建 .NET*.dl! 程 序 集 时 ， 显 式 定义 自 定义 命名 空间 就 更 重要 了 ， 
因为 其 他 开发 者 需要 引用 该 库 并 导入 我 们 的 自 定义 命名 空间 来 使 用 我 们 的 类 型 。 

为 了 直接 研究 这 个 问题 ， 先 创建 一 个 新 控制 台 应 用 程序 CustomNamespaces。 现 在 ,假设 我 们 在 开 
发 一 组 几何 类 Square 、Circle 和 Hexagon。 由 于 这 种 相似 性 ， 你 可 能 希望 把 它们 一 起 分 组 到 Custom- 
Namespaces.exe 程 序 集 MyShapes 的 唯一 命名 空间 中 。 我 们 有 两 个 基本 方案 。 首 先 ， 我们 可 以 选择 把 它 
们 定义 在 一 个 C# 文 件 ( ShapesLib.cs ) 中 ， 如 下 所 示 : 

// ShapesLib.cs 

using System; 

namespace MyShapes 


// Circle 类 
public class Circle { /* Interesting members... */ } 


// Hexagon 类 
public class Hexagon { /* More interesting members... */ } 


// Square 类 
public class Square { /* Even more interesting members... */ } 
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尽管 C# 编 译 器 也 允许 在 一 个 C# 代 码 文件 中 包含 多 个 类 型 ,但 如 果 你 想 在 新 项 目 中 复 用 类 定义 就 很 
麻烦 了 。 例 如 ， 假 设 我 们 构建 了 一 个 新 项 目 并 只 想 使 用 Circle 类 。 如 果 所 有 类 型 都 定义 在 一 个 单独 的 
代码 文件 中 ， 你 将 或 多 或 少 受 困 于 这 个 集合 。 因 此 ， 作 为 一 种 选择 ， 你 可 以 把 一 个 命名 空间 分 割 到 多 
个 C# 文 件 中 。 为 了 保证 每 个 类 型 都 封装 在 同一 个 逻辑 组 中 , 只 需要 把 某 个 类 定义 封装 在 相同 命名 空间 
中 即 可 ， 如 下 所 示 : 

// Circle.cs 

using System; 


namespace MyShapes 


// Circle 类 
public class Circle { /* Interesting methods... */ } 


// Hexagon.cs 
using System; 


namespace MyShapes 


// Hexagon 类 
public class Hexagon { /* More interesting methods... */ } 


// Square.cs 
using System; 


namespace MyShapes 


// Square 类 
public class Square { /* Even more interesting methods... */ } 


注意 ，MyShapes 命 名 空间 成 为 这 些 类 概念 上 的 “容器 ”"。 如 果 另 外 一 个 命名 空间 ( 如 Custom- 
Namespaces ) 希望 使 用 不 同 命名 空间 中 的 对 象 , 可 以 使 用 using 关 键 字 , 就 像 在 .NET 基 础 类 库 中 使 用 命 
名 空间 时 一 样 : 

// 定义 在 基 类 库 中 的 命名 空间 

using System; 

// 使 用 定义 在 MyShapes 命 名 空间 中 的 类 型 

using MyShapes; 

namespace CustomNamespaces 


public class Program 





static void Main(string[] args) 


Hexagon h = new Hexagon(); 
Circle c = new Circle(); 
Square s = new Square(); 


} 
} 
在 这 个 示例 中 ,我 们 假设 定义 MyShapes 命 名 空间 的 C# 文 件 与 定义 CustomNamespaces 命 名 空间 的 文 
件 都 在 同一 个 Console Application 项 目 内 。 也 就 是 说 ， 所 有 的 文件 都 将 被 编译 为 一 个 NET 可 执行 程序 
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集 。 如 果 在 外 部 程序 集中 定义 Myshapes 命 名 空间 ， 那 么 就 必须 引用 那个 库 才 能 编译 成 功 。 你 将 在 本 章 
中 学 习 使 用 外 部 库 建立 应 用 程序 的 所 有 细节 。 


14.1.1 ”使 用 完全 限定 名 解决 命名 冲突 


从 技术 角度 说 ， 当 声明 定义 在 外 部 命名 空间 内 的 类 型 时 ， 不 需要 使 用 C# 的 using 关 键 字 。 我 们 可 
以 使 用 类 型 的 完全 限定 名 ， 回 忆 一 下 第 1 章 ， 在 类 型 名 之 前 加 上 定义 命名 空间 的 前 缀 。 例 如 : 


// 注意 ， 不 再 需要 导入 MyShapes 了 
using Systemj; 


namespace CustomNamespaces 
public class Program 
static void Main(string[] args) 


MyShapes .Hexagon h = new MyShapes.Hexagon(); 
MyShapes.Circle c = new MyShapes.Circle(); 
MyShapes.Square s = new MyShapes.Square(); 


} 
} 


一 般 没有 必要 使 用 完全 限定 名 。 不 仅 因 为 它 需 要 更 多 的 键盘 敲 击 ， 还 因为 它 在 代码 大 小 和 执行 时 
间 上 没有 什么 区 别 。 其 实 , 在 CIL 代 码 中 ， 类 型 总 是 以 完全 限定 名 进行 定义 。 因 此 ，C# 的 using 关 键 字 
只 是 节省 了 打字 时 间 。 

然而 , 完全 限定 名 可 以 在 使 用 包含 同名 类 型 的 多 个 命名 空间 时 避免 命名 冲突 , 此 时 就 会 很 有 用 ( 可 
能 也 是 必需 的 ), 假设 我 们 有 一 个 新 命名 空间 My3DShapes, 它 定 义 的 3 个 类 将 图 形 以 漂亮 的 3D 进 行 呈 现 ， 

// 另 一 个 Shape 命 名 空间 

using System; 


namespace My3DShapes 
{ 


// 3D Circle 类 
public class Circle { } 


// 3D Hexagon 类 
public class Hexagon { } 


// 3D Square 类 
public class Square { } 
如 果 现 在 更 新 Program 类 ， 会 遇 到 许多 编译 时 错误 ， 因 为 这 些 命名 空间 都 定义 了 相同 名 字 的 类 : 


// 产生 歧义 
using Systemj 
using MyShapes; 
using My3DShapes; 


namespace CustomNamespaces 


public class Program 
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static void Main(string[] args) 


// 究竟 引用 哪个 命名 空间 

Hexagon h = new Hexagon(); // 编译 器 错误 
Circle c = new Circle();  // 编译 器 错误 
Square s = new Square();  // 编译 器 错误 


} 
} 


我 们 可 以 使 用 类 型 的 完全 限定 名 来 解决 歧义 ， 如 下 所 示 : 


// 现在 就 可 以 解决 歧义 了 
static void Main(string[] args) 


My3DShapes .Hexagon h = new My3Dshapes.Hexagon(); 


My3DShapes.Circle c = new My3DShapes.Circle(); 
MyShapes.Square s = new MyShapes.Square(); 


14.1.2 ”使 用 别名 解决 命名 冲突 

C# using 关 键 字 还 可 以 用 于 创建 类 型 完全 限定 名 的 别名 。 此 时 ， 我 们 就 可 以 定义 一 个 标识 在 编译 
时 替代 类 型 的 完全 限定 名 。 例 如 ， 定 义 别名 可 以 提供 解决 命名 冲突 的 另 一 种 方式 : 

using Systemj 

using MyShapes; 

using My3DShapes; 


// 使 用 自 定义 别名 来 解决 歧义 
using The3DHexagon = My3DShapes.Hexagon; 


namespace CustomNamespaces 
class Program 
static void Main(string[] args) 


// 这 是 在 创建 My3DShapes.Hexagon 类 
The3DHexagon h2 = new The3DHexagon(); 


} 
} 


这 种 using 语 法 还 可 以 用 来 为 很 长 的 命名 空间 创建 别名 。 在 基础 类 库 中 有 一 个 很 长 的 命名 空间 是 
System.Runtime.Serialization.Formatters.Binary， 它 包含 一 个 叫 BinaryFormatter 的 成 员 。 如 果 你 愿 
意 ， 可 以 按 如 下 所 示 创 建 BinaryFormatter 的 实例 : 

using bfHome = System.Runtime.Serialization.Formatters.Binary; 

namespace MyApp 

下 

class ShapeTester 
static void Main(string[] args) 


bfHome.BinaryFormatter b = new bfHome.BinaryFormatter(); 
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} 
} 
} 


也 可 以 使 用 传统 的 using 指 令 : 


using System.Runtime.Serialization.Formatters.Binary; 
namespace MyApp 
class ShapeTester 
static void Main(string[] args) 


BinaryFormatter b = new BinaryFormatter(); 


} 
} 
} 


在 这 里 ， 不 用 关心 BinaryFormatter 类 的 用 户 ( 我 们 将 在 第 20 章 中 介绍 该 类 )。 目 前 ， 只 需要 简单 
地 记 住 C# using 关 键 字 可 以 为 较 长 的 或 常用 的 限定 名 定义 别名 ， 用 来 解决 引入 多 个 命名 空间 ( 它们 定 
义 相 同 的 类 型 ) 时 导致 的 名 称 冲突 。 


说 明 滥用 C# 别 名 会 导致 代码 库 混 乱 。 如 果 团 队 中 的 其 他 程序 员 不 了 解 你 的 自 定义 别名 ， 则 很 可 能 
以 为 这 些 别名 代表 .NET 基 础 类 库 中 的 类 型 ， 而 当 在 .NET Framework 4.5 SDK 文 档 中 找 不 到 这 
些 标记 时 ， 这 会 带 来 相当 大 的 困扰 。 


14.1.3 ”创建 戏 套 的 命名 空间 


在 组 织 类 型 的 时 候 , 完全 可 以 在 男 一 个 命名 空间 中 定义 命名 空间 。.NET 基 础 类 库 在 许多 地 方 这 么 
用 ,用 来 提供 类 型 组 织 的 更 深 级 别 。 例如，IO 命 名 空间 嵌 套 在 System 中 以 生成 system.IO。 如 果 希 望 创 
建 一 个 根 命名 空间 来 包含 既 有 的 My3Dshapes 命 名 空间 ， 可 以 按 如 下 所 示 更 新 我 们 的 代码 : 


// 嵌 套 一 个 命名 空间 
namespace Chapter14 


namespace My3DShapes 


// 3D Circle 类 
public class Circle{f } 


// 3D Hexagon 类 
public class Hexagon{ } 


// 3D Square 类 
public class Square{ } 


} 
} 


在 很 多 情况 下 ， 根 命名 空间 的 作用 只 是 提供 更 深 级 别 的 作用 域 ， 因 此 可 能 不 会 在 其 作用 域 中 直接 
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定义 任何 类 型 ( 比如 这 里 的 Chapter14 命 名 空间 )。 这 样 的 话 ， 可 以 使 用 如 下 的 简洁 形式 来 定义 舱 套 命 
名 空间 : 


// 嵌 套 命名 空间 (组 合 两 个 ) 
namespace Chapter14.My3DShapes 


// 3D Circle 类 
public class Circle{ } 


// 3D Hexagon 类 
public class Hexagon{ } 


// 3D Square 类 
public class Square{ } 


由 于 我 们 在 chapter14 根 命名 空间 中 艇 套 了 My3Dshapes 命 名 空间 ， 所 以 就 需要 更 新 所 有 既 有 的 
using 指 令 和 类 型 别名 : 


using Chapter14.My3DShapes; 
using The3DHexagon = Chapter14.My3DShapes.Hexagon; 


14.1.4 Visual Studio 的 默认 命名 空间 


最 后 再 提 一 下 ， 在 默认 情况 下 ， 当 使 用 Visual Studio 新 建 C# 项 目 时 ， 应 用 程序 的 默认 命名 空间 名 
就 是 项 目 名 。 此 后 ， 如 果 我 们 使 用 Project 一 Add New Item 荣 单项 来 插 和 人 新 代码 文件 ， 类 型 会 自动 使 用 
默认 命名 空间 进行 包装 。 如 果 和 希望 改变 默认 命名 空间 的 名 字 ， 只 需要 使 用 项 目 Properties 窗 口 的 
Application 标 签 页 来 访问 Default namespace ( 默认 命名 空间 ) 选项 ( 如 图 14-1 所 示 ) 。 
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图 14-1 配置 默认 命名 空间 


这 样 ， 任 何 插入 到 项 目 中 的 新 项 都 会 包装 在 Chapter14.CoreLogic 命 名 空间 中 ( 显然 ， 如 果 其 他 命 
名 空间 希望 使 用 这 些 类 型 ， 就 需要 使 用 正确 的 using 指 令 )。 

现在 ,你 已 经 了 解 了 如 何 将 自 定 义 类 型 包装 到 组 织 良 好 的 命名 空间 。 接 下 来 ,让 我 们 快速 浏览 .NET 
程序 集 的 好 处 及 其 格式 。 然 后 ， 我 们 将 深入 介绍 创建 、 部 署 和 配置 自 定 义 类 库 的 细节 。 
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源 代码 ”CustomNamespaces 项 目的 源 代码 位 于 Chapter 14 子 目录 下 。 





14.2 .NET 程序 集 的 作用 


.NET 应 用 程序 可 以 由 多 个 程序 集 拼 装 而 成 。 简单 来 说 , 程序 集 就 是 一 个 以 公共 语言 运行 库 (CLR ) 
为 宿主 的 、 版 本 化 的 、 自 描述 的 二 进 制 文件 。 尽 管 现实 中 .NET 程 序 集 和 以 往 Windows 二 进 制 文件 的 文 
件 扩展 名 (*.exe 或 者 *.dll ) 完全 相同 ， 但 是 两 者 的 内 部 构成 则 几乎 完全 不 同 。 因 此 ， 为 了 给 后 续 内 容 
做 铺垫 ， 这 里 先 分 析 一 下 程序 集 的 内 部 格式 带 来 的 好 处 。 


14.2.1 程序 集 促进 代码 重用 


从 表面 上 看 ， 前 面 章节 中 构建 的 控制 台 应 用 程序 中 所 有 的 应 用 逻辑 都 包含 在 一 个 可 执行 程序 集 
中 。 而 实际 上 ， 它 们 所 使 用 的 许多 类 型 来 自 于 总 是 可 访问 的 .NET 代 码 库 一 一 mscorlib.dll ( 回忆 一 下 前 
面 章 节 ，C# 编 译 器 会 自动 引用 mscorlib.dll ) 以 及 System.Core.dll ( 在 某 些 示 例 中 )。 

我 们 知道 ， 代 码 库 ( 也 称 类 库 ) 是 一 个 *.dll 形 式 的 文件 ， 它 包含 了 一 些 外 部 应 用 程序 能 够 调用 的 
类 型 。 当 创建 可 执行 程序 集 时 , 上 毫 无 疑问 , 我 们 将 需要 使 用 许多 系统 提供 的 和 自己 手工 编写 的 代码 库 。 
但 是 ， 请 记 住 一 点 : 代码 库 的 文件 扩展 名 不 一 定 是 *.dl]。 一 个 可 执行 程序 集 完全 可 以 使 用 定义 在 外 部 
可 执行 文件 中 的 类 型 。 因 此 ， 一 个 被 引用 的 *.exe 也 可 以 被 认为 是 代码 库 。 

无 论 一 个 代码 库 如 何 被 打包 ，.NET 平 台 允 许 我 们 以 语言 无 关 的 方式 来 重用 其 中 的 类 型 。 例如， 可 
以 使 用 C# 创 建 一 个 代码 库 ， 然 后 在 其 他 .NET 编 程 语言 中 重用 它 。 不 但 可 以 在 不 同 的 语言 间 分 配 类 型 ， 
而 且 可 以 相互 继承 。 用 C# 定 义 的 基 类 可 以 由 Visual Basic 编 写 的 类 来 扩展 ， 用 F# 定 义 的 接口 可 以 由 C# 
定义 的 结构 来 实现 ,等 等 。 这 里 的 关键 是 当 需 要 把 单个 可 执行 文件 分 拆 为 多 个 .NET 程 序 集 时 ， 就 能 
够 做 到 语言 无 关 的 代码 重用 。 


14.2.2 ”程序 集 确定 类 型 边界 


回忆 一 下 ， 类 型 的 完全 限定 名 由 命名 空间 ( 如 System ) 为 前 级 加 上 类 型 名 称 ( 如 Console ) 组 成 。 然 
而 严格 地 说 ， 这 个 类 型 标识 〈 即 前 面 说 的 类 型 完全 限定 名 ) 中 还 需要 加 上 类 型 所 在 的 程序 集 。 比 方 说 ， 
如 果 有 两 个 不 同名 称 的 程序 集 ( MyCars.dll 和 YourCars.dll )， 它 们 同时 在 一 个 命名 空间 ( CarLibrary ) 中 
定义 了 一 个 SportsCar 类 ， 则 在 .NET 址 界 里 ， 这 两 个 程序 集中 的 SportsCar 类 型 被 认为 是 不 同 的 。 


14.2.3 ”程序 集 是 可 版 本 化 的 单元 


每 个 .NET 程 序 集 被 分 配 一 个 格式 为 <major>.<minor>.<build>.<revision> 的 四 部 分 数字 版 本 号 。 
( 如 果 没 有 显 式 设置 版 本 号 ,程序 集会 自动 分 配 版 本 号 1.0.0.0， 即 默认 的 Visual Studio 项 目 设置 。) 版 本 
号 加 上 可 选 的 公 钥 值 使 得 一 个 程序 集 的 不 同 版 本 在 同一 台 机 器 上 能 够 共处 而 不 产生 冲突 。 正 式 来 讲 ， 
提供 了 公 钥 信息 的 程序 集 被 称 为 强 命名 的 (strongly named )。 在 本 章 后 面 你 将 看 到 ， 通 过 使 用 强 名 称 ， 
CLR 可 以 确保 客户 端 调用 程序 能 够 加 载 正确 版 本 的 程序 集 。 
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14.2.4 程序 集 是 自 描述 的 


程序 集 被 认为 是 自 描述 的 ( self-describing )， 部 分 原因 是 它们 记录 了 自身 正常 运行 所 需要 访问 的 
外 部 程序 集 。 因 此 ， 如 果 程 序 集 需 要 访问 System.Windows.Forms.dll 和 System.Core.dll， 那 么 它们 的 信 
息 将 会 被 记录 到 该 程序 集 的 清单 ( manifest ) 中 。 在 第 1 章 中 曾经 讲 过 ， 清 单 是 一 段 描述 程序 集 自身 各 
种 信息 (名称 、 版 本 、 需 要 的 外 部 程序 集 等 ) 的 元 数据 块 。 

除了 清单 数据 ， 程 序 集 还 包含 男 外 一 些 元 数据 。 这 些 元 数据 描述 了 程序 集 包含 的 每 一 个 类 型 的 组 
成 (成 员 名 称 、 实 现 的 接口 、 基 类 、 构 造 函 数 等 )。 由 于 程序 集 的 信息 被 如 此 详细 地 记录 下 来 ，CLR 
并 不 需要 访问 Windows 系 统 注 册 表 来 解析 程序 集 的 位 置 (这 与 微软 原来 的 COM 编 程 模型 有 很 大 的 区 
别 )。 随 着 本 章 的 阅读 ， 你 将 会 发 现 CLR 使 用 一 种 完全 新 颖 的 方式 去 解析 外 部 代码 库 的 位 置 。 


14.2.5 ”程序 集 是 可 配置 的 


程序 集 可 以 以 “私有 ”或 者 “共享 ”的 方式 部 署 。 私 有 程序 集 与 调用 它 的 客户 端 应 用 程序 处 于 同 
一 个 目录 下 (也 可 以 在 其 子 目录 下 )。 而 共享 程序 集 则 是 为 了 让 同一 台 机 器 上 的 大 部 分 应 用 程序 都 可 
以 使 用 它 而 存在 的 一 种 代码 库 ， 它 被 部 署 在 全 局 程序 集 缓存 (GAC ) 的 特定 目录 中 。 

无 论 怎样 部 署 程序 集 , 都 可 以 编写 基于 XML 的 配置 文件 。 使 用 这 些 配置 文件 , 可 以 指示 CLR 做 到 : 
在 指定 位 置 查找 程序 集 ， 为 特定 客户 端 加 载 指定 版 本 的 程序 集 ， 查 阅 本 地 机 器 、 网 络 位 置 或 基于 Web 
的 URL 上 的 任意 目录 。 阅 读 完 本 章 ， 我 们 将 会 对 XML 配置 文件 有 更 好 的 理解 。 


14.3 .NET 程序 集 的 格式 


我 们 已 经 知道 了 .NET 程 序 集 所 带 来 的 好 处 ,现在 进一步 深入 程序 集 的 内 部 结构 。 从 结构 上 看 ,一 
个 .NET 程 序 集 ( *.dll 或 者 *.exe ) 包含 以 下 几 个 部 分 : 

口 Windows 文 件 首部 

口 CLR 文 件 首部 

口 CIL 代 码 

口 类 型 元 数据 

口 程序 集 清单 

口 可 选 的 能 入 资源 

通常 头 两 个 部 分 ( Windows 文 件 首 部 和 CLR 文 件 首部 ) 容易 被 忽视 ,但 其 实 它们 是 值得 简要 了 解 
一 下 的 。 下 面 来 逐个 讲解 。 


14.3.1 Windows 文 件 首部 


Windows 文 件 首部 使 程序 集 可 以 被 Windows 系 列 操作 系统 加 载 和 操作 。 这 些 首部 信息 标识 了 应 用 
程序 将 以 什么 类 型 ( 是 基于 控制 台 、 基 于 图 形 用 户 界面 还 是 *.dll 代 码 库 ) 驻 留 于 Windows 操 作 系统 中 。 
使 用 dumpbin.exe 工 具 ( 通过 Developer Command Prompt )， 打 开 一 个 .NET 程 序 集 ， 并 通过 dumpbin/ 
headers CarLibrary.d1l1 指 定 /headers 标 记 ， 我们 可 以 浏览 该 程序 集 的 Windows 文 件 首部 信息 。 
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下 面 是 本 章 稍 后 要 创建 的 CarLibrary.dll 程 序 集 的 ( 部 分 ) Windows 首 部 信息 〈 如 果 你 想 立 即 运行 
dumpbin.exe， 可 以 用 本 书 编写 的 任意 *.dll 或 *.exe 的 名 称 来 替换 CarLibrary.dll ): 








Dump of file CarLibrary.dll 


PE signature found 
File Type: DLL 


FILE HEADER VALUES 
14C machine (x86) 
3 number of sections 
4B37DCD8 time date stamp Sun Dec 27 16:16:56 2011 
0 file pointer to symbol table 
0 number of symbols 
E0 size of optional header 
2102 characteristics 
Executable 
32 bit word machine 
DLL 


OPTIONAL HEADER VALUES 
10B magic # (PE32) 
8.00 linker version 
E00 size of code 
600 size of initialized data 
0 size of uninitialized data 
2CDE entry point (00402CDE) 
2000 base of code 
4000 base of data 
400000 image base (00400000 to 00407FFF) 
2000 section alignment 
200 file alignment 
4.00 operating system version 
0.00 image version 
4.00 subsystem version 
0 Win32 version 
8000 size of image 
200 size of headers 
checksum 
subsystem (Windows CUI) 


Wo 





记 住 ， 大 多 数 的 .NET 程 序 员 都 没 必要 关心 内 内 在 .NET 程 序 集中 的 首部 数据 的 格式 。 除 非 碰巧 要 
构建 一 个 新 的 .NET 语 言 编译 器 ( 这 时 你 才 会 在 乎 这 些 信息 )， 否 则 你 肯定 对 不 用 去 理会 首部 数据 中 那 
些 星 涩 的 细节 感到 十 分 高 兴 。 但 要 注意 的 是 ， 当 Windows 向 内 存 中 加 载 二 进 制图 像 时 ， 在 后 台 将 使 用 
这 些 信息 。 


14.3.2 ”CLR 文件 首部 


为 了 驻 留 于 CLR 中 ,所 有 的 .NET 文 件 都 必须 含有 CLR 首 部 数据 块 。 简 单 地 讲 ，CLR 文 件 首部 定义 
了 多 个 标记 ， 它 们 使 得 运行 库 可 以 了 解 到 托管 文件 的 布局 。 例 如 ， 这 些 标记 标识 了 文件 中 元 数据 和 资 
源 的 位 置 、 程 序 集 构 建 的 运行 库 版 本 、( 可 选 的 ) 公 钥 值 等 。 使 用 代码 dumpbin/clrheader 
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CarLibrary.d11 为 dumpbin.exe 工 具 提 供 /clrheader 标 记 ， 我 们 就 可 以 浏览 该 程序 集 内 部 的 CLR 首 部 信 
息 ， 如 下 所 示 : 





Dump of file CarLibrary.d]1 
File Type: DLL 


clr Header: 
48 cb 
2.05 runtime version 
2164 [ A74] RVA [size] of MetaData Directory 


IL Only 
0 entry point token 
ol 0] RVA [size] of Resources Directory 
ol 0] RVA [size] of StrongNameSignature Directory 
of 0] RVA [size] of CodeManagerTable Directory 
下 下 0] RVA [size] of VTableFixups Directory 
of 0] RVA [size] of ExportAddressTableJumps Directory 
0 [ 0] RVA [size] of ManagedNativeHeader Directory 
Summary 
2000 .reloc 
2000 .rsrc 
2000 .text 


同样 , .NET 开 发 人 员 不 需要 过 多 关心 程序 集 的 CLR 头 部 信息 细节 。 只 需要 理解 每 一 个 .NET 程 序 集 
都 包含 这 个 数据 , 它 在 背后 被 .NET 运 行 库 作为 图 片 数 据 加 载 进 内 存 。 现 在 我 们 看 一 下 每 天 的 编程 任务 
中 非常 有 用 的 信息 。 


14.3.3 ”ClL 人 代码、 类 型 元 数据 和 程序 集 清单 


程序 集 的 核心 部 分 包含 CIL 人 代码， 这 些 CIL 代 码 是 独立 于 平台 和 CPU 的 中 间 语 言 。 在 运行 时 ,程序 

集 内 部 的 CIL 代 码 才 被 (实时 的 JIT 编 译 器 ) 编译 成 特定 平台 和 CPU 的 指令 。 在 这 种 机 制 下 ，.NET 程 序 

集 可 以 在 多 种 不 同 的 架构 、 设 备 和 操作 系统 下 运行 。( 虽然 可 以 完全 不 去 了 解 CIL 编 程 语言 的 细节 , 但 

是 在 第 18 章 还 是 对 其 语法 和 语义 进行 了 介绍 。) 
程序 集 还 包含 元 数据 ， 这 些 元 数据 完整 地 描述 了 程序 集 内 含 类 型 和 引用 外 部 类 型 的 格式 。.NET 

运行 库 利 用 元 数据 在 内 存 的 二 进 制 布局 类 型 中 解析 类 型 ( 以 及 类 型 的 成 员 ) 的 位 置 ， 使 远程 方法 调用 

更 便利 。 在 第 15 章 探讨 反射 服务 的 时 候 ， 将 会 详细 讲述 .NET 元 数据 的 格式 。 
男 外， 程序 集 必须 被 关联 上 一 个 清单 ( manifest， 也 称 程序 集 元 数据 )。 该 清单 详细 记录 了 程序 集 

中 的 每 一 个 模块 、 构 建 程序 集 的 版 本 以 及 该 程序 集 引 用 的 所 有 外 部 程序 集 。 在 本 章 中 , 我们 将 会 看 到 

CLR 广 泛 地 使 用 程序 集 的 清单 来 定位 外 部 程序 集 引 用 。 


14.3.4 可 选 的 程序 集资 源 


最 后 ，.NET 程 序 集 还 可 以 包含 一 些 舱 入 资源 ， 如 应 用 程序 图 标 、 图 像 文 件 、 声 音 片 段 或 者 字符 串 
表 。 事 实 上 ，.NET 平 台 支 持 卫 星 程 序 集 (satellite assemblie )， 这 些 程序 集 只 包含 本 地 化 资源 。 在 构建 
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国际 化 软件 系统 的 时 候 ， 我们 可 能 想 基 于 特定 区 域 ( 英语、 德语 等 ) 来 对 资源 进行 分 类 打包 ， 这 时 候 
附属 程序 集 就 显得 非常 有 用 。 附 属 程序 集 不 是 本 书 要 讨论 的 话题 ,如果 感 兴趣 的 话 ， 请 参考 .NET 4.5 
Framework 文 档 了 解 卫星 程序 集 的 有 关 信 息 。 


14.4 ”构建 和 使 用 自 定义 类 库 


在 开始 进入 .NET 类 库 的 世界 前 ， 首 先 创建 一 个 包含 几 个 公共 类 型 的 单 文件 *.dll 程 序 集 ( 名 为 
CarLibrary )。 使 用 Visual Studio 可 以 这 样 构 建 一 个 代码 库 ， 只 需 通过 File 一 New Project 菜 单项 选择 类 库 
( Class Library ) 项 目 ( 如 图 14-2 所 示 )。 





LNET Framewor 5 a] ;| Fault st *| | Search Instalied Tempiabes 





本 Windows Forms Appiicaticn Yisual C# [发 sa 
下 Aprojectforcreatinga Cs class lbrary 
| WPF Appiication Voual CF 【en 


| Ce 
1 融 | Console Application Visgal C# 


1 te 
< ASP.NET Web Forms Application Visual Ce 





1 
四 5 sa 


Cartibrary 
CNMyCode 

| Create directory for solution 
© Add to source control 


Carlibrary 





图 14-2 ”创建 一 个 C# 类 库 


在 这 个 汽车 类 库 中 ， 首 先 创建 一 个 名 为 Car 的 抽象 基 类 ， 它 通过 自 定义 属性 语法 定义 了 各 种 状态 
数据 。 它 还 拥有 一 个 抽象 方法 TurboBoost() ， 使 用 自 定义 的 枚 举 类 型 ( EngineState ) 来 表示 汽车 引擎 
的 当前 状态 ， 如 下 所 示 : 


using Systemj 

using System.Collections.Generic; 
using System.Lingqg; 

using System.Text; 

using System.Threading.Tasks; 


namespace CarLibrary 


// 表示 引擎 的 状态 
public enum EngineState 
{ engineAlive, engineDead } 


// 层次 结构 中 的 抽象 基 类 


public abstract class Car 


public string PetName {get; set;} 
public int CurrentSpeed {get; set;} 
public int MaxSpeed {get; set;} 
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protected EngineState egnState = EngineState.engineAlive; 
public EngineState EngineState 


get { return egnState; } 


public abstract void TurboBoost(); 


public Car(){} 
public Car(string name, int maxSp, int currSp) 


PetName = name; MaxSpeed = maxSp; CurrentSpeed = currSp; 


} 
} 


现在 假设 Car 类 型 有 两 个 子 类 : MiniVan ( 旅行 车 ) 和 SportsCar ( 跑车 ) 。 每 个 子 类 都 通过 Windows 
Forms 消 息 框 显示 恰当 的 消息 来 重 写 抽 象 方法 TurboBoost()。 在 DerivedCars.cs 项 目 中 插入 新 的 C# 类 文 
件 ， 代 码 如 下 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 


// 先 读 代 码 ! 只 有 添加 了 .NET 类 库 才 能 通过 编译 
using System.Windows .Forms; 


namespace CarlLibrary 
public class SportsCar : Car 
public SportsCar(){ } 
public SportsCar(string name, int maxSp, int currSp) 
: base (name, maxSp, currSp){ } 
public override void TurboBoost() 
MessageBox.Show("Ramming speed!", "Faster is better..."); 
} 
public class MiniVan : Car 
public MiniVan(){ } 


public MiniVan(string name, int maxSp, int currSp) 
: base (name, maxSp, currSp){ } 





public override void TurboBoost() 


// Minivans 引 擎 的 马力 不 足 
egnstate = EngineState.engineDead; 
MessageBox.Show("Eek!", "Your engine block exploded!"); 
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请 注意 ， 每 一 个 子 类 实现 TurboBoost() 时 ， 都 使 用 了 Windows Forms 的 MessageBox 类 ， 该 类 定义 在 
System.Windows. Forms.dll 程 序 集中 。 为 使 程序 集 使 用 在 外 部 程序 集中 定义 的 类 型 ， 因 此 需要 通过 Add 
Reference 对 话 框 来 为 CarLibrary 项 目 添 加 对 外 部 二 进 制 文件 的 引用 ( 如 图 14-3 所 示 )。Add Reference 对 
话 框 可 以 通过 选择 Visual Studio Project 一 Add Reference 菜 单项 打开 。 








Targeting: .NET Framework 4.5 Seatch Assemblies 
Name Name: 
System.Web.DataVisualization.Design System.Windows.Forms 
System.Web.DynamicData Created by 
System.Web.DynamicData Design Microsoft Corporation 
System.Web.Entity pp 
System.Web.Entity.Design Heer 
System.Web.Exensions 4.0.30319.17379 built by 
System.Web.Extensions.Design FXBETAREL 
System.Web.Mobile 
System.Web.RegularExpressions 
System.Web.Routing 
System.Web.Services 
System.Windows 
System.Windows.Controls.Ribbon 
stem Windows FOrms Oe 
System,Windows.Forms.DataVisualization 
System.Windows.Forms.DataVisualization.Desi... 
System.Windows.Input.Manipulations 
System.Windows.Presentation 
System.Workflow.Activities 
System.Workflow.ComponentMode} 
System.Workflow.Runtime 
System,WorkflowServices 
System,Xam} 





图 14-3 ”使 用 Add Reference 对 话 框 引用 外 部 .NET 程 序 集 


这 里 必须 清楚 的 一 点 是 : Add Reference 对 话 框 的 Framework 区 域 并 没有 显示 机 器 上 所 有 的 程序 集 。 
Add Reference 对 话 框 并 不 会 显示 我 们 自 定义 的 库 ， 也 不 会 显示 所 有 部 署 在 GAC ( 全 局 程序 集 缓存 ， 本 
章 后 面 会 介绍 其 细节 ) 中 的 库 ， 它 只 显示 Visual Studio 预 先 设 定 的 一 组 常用 程序 集 。 当 构建 的 应 用 程 
序 需 要 添加 一 个 在 Add Reference 对 话 框 中 未 列 出 的 程序 集 时 ,我们 需要 单 击 Browse 节 点 手动 找到 该 
*.dll 或 *.exe。 





说 明 Add Reference 对 话 框 的 Recent 节 会 不 断 更 新 显示 最 近 被 引用 的 程序 集 。 这 很 方便 ， 因 为 .NET 
项 目 通常 使 用 同样 的 外 部 库 核 心 设置 。 





14.4.1 清 


在 客户 端 应 用 程序 使 用 CarLibrary.dll 之 前 ， 先 查看 一 下 代码 库 的 内 部 结构 。 假 定 项 目 已 经 编译 完 
毕 ， 现 在 通过 File 一 Open 菜 单 ， 导 航 到 CarLibrary 项 目的 \bin\Debug 子 目录 ， 将 CarLibrary.dll 加 载 到 
ildasm.exe 中 。 这 样 ， 就 可 以 在 IL disassembler 工 具 中 查看 你 的 库 了 ( 如 图 14-4 所 示 )。 
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‘IFile View Heip || 
9B- [he ee en a 
bp MANIFEST 
白 - 嘿 CarLibrary 
由 - 共 Carlibrary.Car 
申 -对 Carlibrary.EngineState 


日 共 CarLibrary.Minivan 
外- 叭 CarLibrary,5portsCar 

















图 14-4 将 CarLibrary.dll 加 载 到 ildasm.exe 中 


双击 MANIFEST 图 标 ， 打 开 CarLibrary.dll 的 清单 。 该 清单 的 第 一 个 代码 块 描述 了 当前 程序 集 正确 
运行 所 必需 的 所 有 外 部 程序 集 。 你 应 记得 ,CarLibraty.dll 使 用 了 mscorlib.dll 和 System.Windows. Forms.dll 
里 面 的 类 型 ， 因此 两 者 都 在 清单 中 通过 .assembly extern 标 记 列 出 ， 如 下 所 示 : 


.assembly extern mscorlib 


.publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
.Ver 4:0:0:0 


.assembly extern System.Windows .Forms 


-publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
:Ver 4:0:0:0 


每 一 个 .assembly extern 块 由 .publickeytoken 指 令 和 .ver 指 令 组 成 。.publickeytoken 指 令 仅 当 程 
序 集 被 配置 为 强 名 称 (在 “ 强 名 称 ” 部 分 会 详细 介绍 ) 的 时 候 才 需要 。 而 .ver 指 令 则 用 于 表示 引用 程 
序 集 的 数字 版 本 标识 。 

在 这 些 外 部 引用 信息 之 后 , 我 们 会 发 现 很 多 .custom 标 记 , 它们 标识 了 程序 集 级 别 的 特性 ( 版权 信 
息 、 公 司 名 、 程 序 集 版 本 等 )。 下 面 是 manifest 数 据 的 部 分 代码 : 


.assembly CarlLibrary 


.Custom instance void ...AssemblyDescriptionAttribute... 
.Custom instance void ...AssemblyConfigurationAttribute... 
.Custom instance void ...RuntimeCompatibilityAttribute... 
.Custom instance void ...TargetFrameworkAttribute... 
.Custom instance void ...AssemblyTitleAttribute... 

.Custom instance void ...AssemblyTrademarkAttribute... 
.Custom instance void ...AssemblyCompanyAttribute... 
-Custom instance void ...AssemblyProductAttribute... 
.Custom instance void ...AssemblyCopyrightAttribute... 





“Ver 1:0:0:0 


.module CarLibrary.dll 
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通常 ， 可 以 使 用 当前 项 目的 Properties 编 辑 器 可 视 地 建立 这 些 设置 。 现 在 ， 回 到 Visual Studio， 点 
击 Solution Explorer 中 的 Properties 图 标 ， 单 击 Application 选 项 卡 中 的 Assembly Information... 按 钮 ( 默认 
选中 )， 将 弹出 如 图 14-5 所 示 的 GUI 编辑 器 。 


[acs 








Title: 
Description: | 
Company: 

Product: Carlibrary 


Copyright: Copyright © 2012 


Trademark: 
Assembly version: 1 0 0 0 
File version: 1 0 0 0 
GUID: fe8206c8-5dd2-4301-9dc8-719b76862893 
Neutral language: (None) | | 
| 加 Make assembly COM-Visibie 








14-5 ”使 用 Visual Studio 的 Properties 编 辑 器 编辑 程序 集 信 息 
保存 设置 ，GUI 编 辑 器 将 更 新 项 目 中 的 AssemblyInfo.cs 文 件 。 该 文件 由 Visual Studio 维 护 ， 并 且 展 
开 Solution Explorer 中 的 Properties 节 点 ， 可 以 看 到 它 ， 如 图 14-6 所 示 。 


革 祖 人 加 | 下 
Search Solution Explorer (Ctris;) 
网 Solution ‘Carlibrary’ (1 project) 
Carlibrary 





* System.Data 
时 System,Data,DataSetExtensions 
st System.Windows.Forms 
"System.Xml 
"a System.Xmi.Ling 

》 ce BaseCar.cs 

b cr DervedCars.cs 


SOLUTION ExPLORER ENMUOHER OE EE 
图 14-6 使 用 GUI Properties 编 辑 器 可 以 更 新 AssemblyInfo.cs 文 件 
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浏览 该 文件 ， 可 以 看 到 大 量 中 括号 括 起 的 .NET 特 性 ， 例 如: 


[assembly: AssemblyTitle("CarLibrary")] 
[assembly: AssemblyDescription("")] 

[assembly: AssemblyConfiguration("")] 

[assembly: AssemblyCompany("")] 

[assembly: AssemblyProduct("CarlLibrary")] 
[assembly: AssemblyCopyright("Copyright © 2012")] 
[assembly: AssemblyTrademark("")] 

[assembly: AssemblyCulture("")] 


第 15 章 会 详细 介绍 这 些 特 性 , 因此 这 里 不 用 担心 其 细节 。 但 必须 知道 的 是 , 定义 在 AssemblyInfo.cs 
文件 里 面 的 大 量 特性 会 用 来 更 新 程序 集 清单 中 的 .custom 标 记 的 值 。 


14.4.2 CIL 


前 面 介绍 过 , 程序 集 并 不 包含 特定 平台 的 指令 。 相反, 它 包 含 的 是 独立 于 平台 的 CIL 指 令 。 当 .NET 
运行 库 把 一 个 程序 集 加 载 进 内 存 时 ，CIL 将 会 被 ( JIT 编译 器 ) 编译 成 目标 平台 可 以 理解 的 指令 。 如 果 
回 到 ildasm.exe 中 ， 双 击 SportsCar 类 的 TurboBoost() 方 法 ，ildasm.exe 会 打开 一 个 新 窗 口 展示 实现 该 方 
法 的 CIL 指 令 : 

.method public hidebysig virtual instance void 

TurboBoost() cil managed 


// 代码 大 小 18(0x12) 
.maxstack 8 
IL 0000: nop 
IL 0001: ldstr "Ramming speed!" 
IL 0006: ldstr "Faster is better..." 
IL O00b: call valuetype [System.Windows.Forms]System.Windows.Forms.DialogResult 
[System.Windows.Forms]System.Windows.Forms.MessageBox: :Show(string, string) 
IL 0010: pop 
IL 0011: ret 
} // 方法 SportsCar: :TurboBoost 结 束 


同样 ， 尽 管 大 多 数 .NET 开 发 者 不 需要 深入 了 解 CIL 的 细节 ， 但 第 18 章 还 是 详细 介绍 了 它 的 语法 和 
语义 。 信 不 信 由 你 ， 理 解 CIL 的 语法 将 有 助 于 构建 更 加 复杂 的 需要 高 级 服务 的 应 用 程序 ， 如 程序 集 的 
运行 时 构造 ( 同样 ， 详 见 第 18 章 )。 


14.4.3 ”类 型 元 数据 


在 构建 使 用 自 定义 .NET 库 的 应 用 程序 之 前 ， 如 果 按 下 Ctrit+M 组 合 键 ，ildasm.exe 会 显示 
CarLibrary.dll 程 序 集中 的 每 一 个 类 型 的 元 数据 ( 如 图 14-7 所 示 )。 

第 15 章 会 研究 程序 集 的 元 数据 ， 对 .NET 平 台 来 说 , 它 是 非常 重要 的 元 素 , 并 晶 是 许多 技术 的 峭 柱 
(对象 序 列 化 、 延 迟 绑 定 、 可 扩展 应 用 程序 等 )。 现 在 已 经 对 CarLibrary.dll 程 序 集 的 内 部 结构 有 一 定 的 
了 解 ， 接 下 来 开始 构建 使 用 你 的 类 型 的 客户 端 应 用 程序 。 


源 代码 ”CarLibrary 项 目的 源 代码 位 于 Chapter 14 子 目录 下 。 
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: CarLibrary .dlil 
dl D72F -3FDA-9F94-43B8328798383EC>》 


TypDefName: CarLibrary.EngineState {82888962) 

Flags : [Public] [AutoLayout] [Class] [Sealed] [hnsiClass] (8888 
Extends : 180806081 [TypeRef] System.Enum 

Field #1 (8488698661) 


(94866881) 


TN NT 








图 14-7 ”CarLibrary.dll 中 的 类 型 元 数据 


14.4.4 ”构建 C# 客 户 端 应 用 程序 


由 于 CarLibrary 中 的 每 一 个 类 型 都 被 声明 为 public， 因 此 其 他 .NET 应 用 程序 都 可 以 使 用 它们 。 其 
实 可 以 使 用 internal 关 键 字 把 类 型 定义 为 内 部 的 ( 实际 上 ，C# 默 认 的 访问 方式 是 internal )。 内 部 类 型 
只 能 被 它 所 在 的 程序 集 使 用 ， 而 不 能 被 外 部 客户 端 看 到 和 创建 。 

为 了 能 够 调用 库 的 功能 ,我 们 创建 一 个 C# 控 制 台 应 用 程序 项 目 CSharpCarClient， 然 后 使 用 Add 
Reference 对 话 框 的 Browse 节 点 添加 对 CarLibrary.dll 的 引用 ( 如 果 使 用 Visual Studio 编 译 CarLibrary.dll， 
程序 集 将 被 放 到 CarLibrary 项 目 文件 夹 的 子 目 录 \bin\Debug 下 )。 现 在 ,我 们 可 以 构建 客户 端 应 用 程序 
去 使 用 这 些 外 部 类 型 了 。 把 先前 的 C# 文 件 做 如 下 更 改 : 


using Systemj; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 


// 不 要 忘记 导入 命名 空间 CarLibrary 
using CarLibrary; 


namespace CSharpCarClient 
public class Program 
static void Main(string[] args) 
Console.WriteLine("***** C# CarLibrary Client App *****"); 


// 创建 SportsCar 对 象 
SportsCar viper = new SportsCar("Viper", 240, 40); 
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viper.TurboBoost(); 


// 创建 MiniVan 对 象 
MiniVan mv = new MiniVan(); 
mv. TurboBoost(); 


Console.WriteLine("Done. Press any key to terminate"); 
Console.ReadLine(); 
} 
} 
} 


以 上 代码 跟 先 前 编写 的 其 他 应 用 程序 看 上 去 没有 什么 区 别 。 唯一 的 不 同 是 这 个 C# 客 户 端 应 用 程序 
使 用 定义 在 另 一 个 自 定义 库 里 面 的 类 型 。 现 在 运行 程序 ， 它 会 打开 多 个 不 同 的 消息 框 。 

你 可 能 想 知道 在 使 用 Add Reference 对 话 框 引用 CarLibrary.dll 时 到 底 会 发 生 什 么 。 点 击 Solution 
Explorer 中 的 Show All Files 按 钮 ， 会 发 现 Visual Studio 将 原始 的 CarLibrary.dll 复 制 到 了 了 CSharpCarClient 
项 目 文件 夹 的 子 目 录 \bin\Debug 下 (如 图 14-8 所 示 )。 






: SOLUTION EXPLORER Ma 
oo6haem|s|mo 加 


Search Solution Explorer (Ctrl AA: 
Solution ‘CSharpCarClient' (1 project) 所 
4 团 CSharpCarClient 


bp ££ Properies 
b wm References 


4 BE bin 


四 Ee 
可 Ch di 


:Carlibrary.pdb 
入 CSharpCarClient.exe.config | 
i CSharpCarClient.pdb | 
i CSharpCarClientvshost.exe 
1 CSharpCarClient.vshost.exe.config 
i CSharpCarClient.vshost.exe.manifest 
| obj 
锡 App.config We 
SOLUTION EXPLORER | 2 


图 14-8 ”Visual Studio 将 私有 程序 集 复 制 到 客户 目录 中 
本 章 后 面 将 会 介绍 ，CarLibrary.dll 被 部 署 为 “私有 ”程序 集 ( 这 是 Visual Studio 类 库 项 目的 自动 


行 类 )。 当 你 在 新 应 用 程序 中 引用 私有 程序 集 时 ( 如 CSharpCarClient.exe )，IDE 会 通过 在 客户 端 应 用 程 
序 的 输出 目录 中 放置 库 的 副本 来 响应 。 








源 代 码 ”CSharpCarClient 项 目的 源 代 码 位 于 Chapter 14 子 目录 下 。 
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14.4.5 构建 Visual Basic 客户 端 应 用 程序 


.NET 平 台 人 允许 开发 者 跨 编 程 语言 共享 编译 的 代码 。 为 了 阐明 .NET 平 台 的 语言 无 关 性 ， 让 我 们 使 
用 Visual Basic 来 构建 新 的 控制 台 应 用 程序 ( VisualBasicCarClient )， 如 图 14-9 所 示 。 先 创建 一 个 项 目 ， 
然后 使 用 Add Reference 对 话 框 添加 对 CarLibrary.dll 的 引用 。 通 过 选择 Project 一 Add Reference 菜 单 选项 
来 打开 Add Reference 对 话 框 。 








[NET framework#3 | Sort by [pefauk -| 于 Search Instslled Templates 
Windows Forms Application Visual Basic j Typet: Yip Des 

| Aproject forcreatingarcommand-iine 
[| application 








WPF Application Visual Basic 


| 
Console Application Wisual Basic 
| ASPNET Web Forms Appication Visual Basic 
Class Library Visual Basic 
Portable Class Library Visual Basic 
ye 
ASP.NET MYC 3 Web Appiication Visual Basic 


VisualBasicCarClient 
G:\My Books\Cs= Book\Cz and the .NET piztform Soth Ed (In progress}\Code\Chapter 14\ 


VisuaiBasieC aCient 





图 14-9 创建 Visual Basic 控 制 台 应 用 程序 


与 C# 一 样 ，Visual Basic 人 允许 列 出 当前 文件 使 用 的 命名 空间 。 但 是 Visual Basic 使 用 Imports 关 键 字 
而 不 是 C# 的 using 关 键 字 ， 因 此 在 Module1.vb 代 码 文件 中 添加 以 下 Imports 语 句 : 


Imports CarLibrary 


Module Module1 
Sub Main() 
End Sub 

End Module 


注意 ，Main() 方 法 定义 在 Visual Basic Module 类 型 中 。 简 而 言 之 ，Module 类 型 是 Visual Basic 对 只 含 
有 静态 方法 ( 与 C# 的 静态 很 像 ) 的 类 的 简写 方式 。 为 了 使 用 Visual Basic 语 法 处 理 MiniVan 和 SportsCar 
类 型 ， 把 Main() 方 法 改写 为 : 


Sub Main() 
Console.WritelLine("***** VB CarLibrary Client App *****") 


' 通 过 Dim 关 键 字 声明 本 地 变量 
Dim myMiniVan As New MiniVan() 
myMiniVan.TurboBoost() 


Dim mySportsCar As New SportsCar() 
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mySportsCar.TurboBoost() 
Console.ReadLine() 
End Sub 


编译 后 ， 运 行 本 应 用 程序 ， 将 再 次 看 到 程序 打开 了 一 连 串 的 对 话 框 。 另 外 ， 新 的 客户 端 应 用 程序 
将 它 自己 的 CarLibrary.dll 本 地 副本 放置 在 bin\iDebug 文 件 夹 下 。 


14.4.6 ”实现 跨 语 言 继 承 


使 用 .NET 开 发 最 吸引 人 的 一 个 方面 就 是 跨 语言 继承 。 为 了 说 明 这 一 点 ,我们 创建 一 个 新 的 Visual 
Basic 类 ， 用 它 继承 ( 之 前 使 用 C# 编 写 的 ) SportsCar。 首 先 ，( 通过 选择 Proiect 一 Add Class 菜 单项 ) 为 
当前 Visual Basic 应 用 程序 添加 一 个 新 的 类 文件 , 命名 为 PerformanceCar.vb。 使 用 Inherits 关 键 字 更 改 
该 类 的 定义 ， 让 它 继承 SportsCar 类 型 。 然 后 ， 使 用 0verrides 关 键 字 重 写 抽象 方法 TurzboBoost() ， 如 下 
所 示 : 


Imports CarLibrary 


' 这 个 VB 类 型 继承 了 用 C# 编 写 的 SportsCar 类 型 
Public Class PerformanceCar 
Inherits SportsCar 


Public Overrides Sub TurboBoost() 
Console.WritelLine("Zero to 60 in a cool 4.8 seconds...") 
End Sub 


End Class 

为 了 测试 新 的 类 类 型 ， 更 新 模块 的 Main() 方 法 ， 如 下 所 示 : 
Sub Main() 

“Dim dreamCar As New PerformanceCar() 


“使 用 继承 的 属性 
dreamCar.PetName = "Hank" 
dreamCar.TurboBoost() 
Console.ReadLine() 

End Sub 


注意 ，dreamCar 对 象 可 以 调用 继承 链 中 存在 的 任何 公共 成 员 ( 如 PetName 属 性 )， 而 不 用 担心 基 类 
完全 由 不 同 的 语言 定义 并 且 位 于 完全 不 同 的 程序 集中 。 以 语言 无 关 的 方式 跨 程 序 集 边 界 对 类 进行 扩 
展 , 是 .NET 开 发 周期 中 一 个 非常 自然 的 部 分 。 你 可 以 方便 地 使 用 编译 后 的 由 那些 不 愿 用 C# 的 人 编写 的 
代码 。 


源 代码 VisualBasicNetCarClient 项 目的 源 代码 位 于 Chapter 14 子 目录 下 。 


14.5 私有 程序 集 
到 现在 为 止 , 我们 在 本 章 中 所 创建 的 类 库 都 被 部 署 为 私有 程序 集 。 私 有 程序 集 要 求 放置 在 客户 端 
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应 用 程序 所 在 目录 ( 应 用 程序 目录 ) 或 者 其 子 目 录 下 。 在 先前 构建 CSharpCarClient.exe 和 VisualBasic- 
CarClient.exe 的 过 程 中 , 添加 对 CarLibrary.dll 的 引用 的 时 候 ，Visual Studio 会 把 CarLibrary.dll 复 制 到 客户 
端 应 用 程序 目录 下 ( 至 少 在 首次 编译 结束 后 ) 。 

当 一 个 客户 端 程序 使 用 定义 在 外 部 程序 集 的 类 型 时 ，CLR 只 是 加 载 CarLibrary.dll 本 地 的 副本 。 由 
于 .NET 运 行 库 在 查找 被 引用 的 程序 集 时 并 不 查询 系统 注册 表 ， 因 此 我 们 可 以 把 CSharpCarClient.exe 
(或 者 VisualBasicCarClient.exe ) 和 CarLibrary.dll 程 序 集 一 起 放 到 机 器 上 的 某 个 位 置 ， 然 后 运行 应 用 程 
序 (这 就 是 时 常 听 到 的 Xcopy 部 署 )。 

逢 载 ( 复制 ) 排他 性 使 用 私有 程序 集 的 应 用 程序 非常 容易 ， 只 需 直接 删除 (复制 ) 应 用 程序 文件 
夹 就 可 以 了 。 更 重要 的 是 ， 不 需要 担心 移 除 私有 程序 集会 破坏 机 器 上 其 他 应 用 程序 的 正常 运行 。 


14.5.1 私有 程序 集 的 标识 


私有 程序 集 的 全 标识 包括 友好 名 称 和 数字 版 本 号 ， 两 者 都 被 记录 在 程序 集 清 单 中 。 友 好 名 称 就 是 
模块 (包含 程序 集 清 单 的 ) 名 字 减 去 文件 扩展 名 。 例 如 ， 如 果 查 看 CarLibrary.dll 程 序 集 , 会 看 到 如 下 
内 容 : 


.assembly CarLibrary 
.Ver 1:0:0:0 


鉴于 私有 程序 集 的 独立 性 ，CLR 在 解析 它 的 位 置 时 并 不 忙于 使 用 它 的 版 本 号 。 我 们 假定 私有 程序 
集 并 不 需要 详细 检查 版 本 ,因为 客户 端 应 用 程序 是 唯一 知道 其 存在 的 实体 。 因 此 , 一 台 机 器 上 很 有 可 
能 会 有 同一 个 私有 程序 集 的 副本 在 不 同 目录 下 多 次 出 现 的 情况 。 


14.5.2 ”探测 过 程 


.NET 运 行 环境 使 用 一 种 叫 探测 (probing) 的 技术 解析 私有 程序 集 的 位 置 , 这 项 技术 其 实 远 不 如 它 
的 名 字 听 起 来 那样 具有 侵略 性 。 探 测 是 一 种 把 外 部 程序 集 请 求 映射 到 被 请 求 的 二 进 制 文件 位 置 的 过 
程 。 严 格 来 说 ， 一 个 加 载 请 求 可 以 是 显 式 的 或 者 隐 式 的 。 隐 式 的 加 载 请 求 发生 在 CLR 查 询 清 单 
的 .assembly extern 标 记 来 解析 程序 集 位 置 的 时 候 ， 例 如 : 

// 隐 式 加 载 请 求 


.assembly extern CarLibrary 


显 式 的 加 载 请 求 则 发 生 在 以 编程 方式 调用 System.Reflection.Assembly 类 的 Load() 或 者 LoadFrom() 
方法 时 ， 这 两 个 方法 主要 在 后 期 绑 定 或 者 动态 调用 类 型 成 员 时 用 到 。 第 15 章 有 相关 的 详细 介绍 ， 以 下 
就 是 一 个 显 式 加 载 请 求 的 示例 代码 : 


// 根据 友好 名 称 显 式 加 载 请 求 
Assembly asm = Assembly.Load("CarLibrary"); 


不 管 是 隐 式 还 是 显 式 ， 在 CLR 获 得 程序 集 的 友好 名 称 之 后 ， 便 开始 探测 客户 端 应 用 程序 目录 下 的 
CarLibrary.dll 文 件 。 如 果 找 不 到 文件 ， 它 就 尝试 去 查找 具有 相同 友好 名 称 的 可 执行 程序 集 ( 如 
CarLibrary.exe )。 如 果 还 是 找 不 到 ， 运 行 库 就 在 运行 时 引发 FileNotFoundException 异 常 。 
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说 明 ”准确 地 说 , 如 果 在 客户 端 应 用 程序 目录 下 找 不 到 被 请 求 的 程序 集 副本 , CLR 会 尝试 查找 该 目录 
下 具有 程序 集 友 好 名 称 的 子 目 录 (例如 CNMyClient\CarLibrary )。 如 果 被 请 求 的 程序 集 在 这 个 
子 目录 下 ，CLR 就 可 以 成 功 地 把 该 程序 集 加 载 到 内 存 中 。 


14.5.3 “配置 私有 程序 集 


虽然 可 以 采用 这 种 部 署 方式 一 一 把 所 需 的 程序 集 复制 到 ( 用 户 硬 盘 中 ) 单个 文件 夹 ， 但 是 我 们 可 
能 更 想 定 义 多 个 子 目 录 来 区 分 相关 内 容 。 例 如 ， 假 设 应 用 程序 目录 是 C:MyApp， 其 中 包含 
CSharpCarClient.exe。 在 该 目录 下 有 一 个 名 为 MyLibraries 的 子 目录 ， 其 中 放 有 CarLibrary.dll。 

不 考虑 两 个 目录 的 关系 ， 只 有 提供 一 个 配置 文件 ，CLR 才 会 探测 到 MyLibraries 子 目录 。 配 置 文件 
包含 多 个 XML 元 素 ， 它 们 可 以 决定 探测 的 过 程 。 根 据 “ 规 则 ”， 配 置 文件 必须 拥有 和 运行 的 应 用 程序 
相同 的 名 称 ， 带 *.config 的 文件 扩展 名 ， 同 时 ， 它 们 必须 被 部 署 到 客户 端 应 用 程序 目录 下 。 因 此 ， 如 果 
为 CSharpCarClient.exe 创 建 配置 文件 的 话 ， 该 配置 文件 的 名 称 必须 是 CSharpCarClient. exe.config, 并 且 
位 于 C:\MyApp 目 录 下 ( 就 本 例 而 言 )。 

现在 让 我 们 实践 一 下 。 首 先 使 用 Windows 资 源 管理 器 在 C 盘 创建 一 个 名 为 MyApp 的 新 目录 ， 然 后 
将 CSharpCarClient.exe 和 CarLibrary.dll 复 制 到 这 个 目录 , 双击 前 者 运行 程序 。 你 的 程序 应 该 可 以 成 功 运 
行 。 接 着 在 C:MyApp 下 创建 一 个 名 为 MyLibraries 的 子 目录 ( 如 图 14-10 所 示 )， 移 动 CarLibrary.dll 到 该 
目录 中 。 


be ocal DR (EN Ne 


Organize v [Open Include in library w Share with v Bumn » 


4 包 Local Disk (C:) < Name Date modified Type 
高 eclipse 
者 inetpub 
点 UNQPad4 
4 MyApp 司 
点 MylLibraries 
莫 MyCode 
坑 Perftogs | i OE 


高 MytLibraries 4/1072012 9:25 AM Filefolder 
:CSharpCarClient.exe /1072012S:14 AM Application 





MytLibraries Date modified: 4/10/2012 9:25 AM 


上 
A 1 
| Rieroler | 


图 14-10 ”现在 CarLibrary.dll 位 于 MyLibraries 子 目录 下 


再 次 双击 该 可 执行 文件 尝试 运行 程序 。 由 于 CLR 在 应 用 程序 目录 下 不 能 直接 找到 CarLibrary， 因 
此 你 会 收 到 一 个 令 人 厌恶 的 且 未 被 处 理 的 FileNotFoundException 异 常 。 

为 了 指示 CLR 在 MyLibraries 下 进行 探测 ,让 我 们 创建 一 个 名 为 CSharppCarClient.exe.config 的 配置 文 
件 ,， 然后 把 它 放 到 CSharpCarClient.exe 所 处 的 目录 下 ( C:\IMyApp )。 打 开 该 文件 , 输入 以 下 内 容 ( 注意 
XML 是 区 分 大 小 写 的 ): 
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<configuration> 
<runtime> 
<¢assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 
<probing privatepath="MyLibraries"/> 
</assemblyBinding> 
</runtime> 
</configuration> 


.NET 的 *.config 文 件 通 常 以 <configuration> 元 素 作 为 根 元 素 。 内 髋 的 cruntime> 元 素 可 能 还 定义 了 
一 个 <assemblyBinding> 子 元 素 ， 该 子 元 素 会 进一步 内 髋 一 个 <probing> 元 素 。 在 这 个 例子 里 面 ， 
privatepPath 特 性 是 关键 ， 它 用 于 通知 CLR 需 要 在 应 用 程序 目录 下 的 哪些 子 目 录 下 进行 探测 。 

注意 <probing> 元 素 并 没有 指明 哪 一 个 程序 集 位 于 它 指 定 的 子 目录 下 。 换 名 话说 ， 不 能 认为 
“CarLibrary 就 在 MyLibraries 子 目录 下 ， 而 MathLibrarie 在 OtherStuff 子 目录 下 ”。<probing> 元 素 只 是 指 
示 CLR 到 所 有 指定 的 子 目录 去 查找 被 请 求 的 程序 集 ， 直 到 找到 第 一 个 匹配 的 。 


说 明 ”注意 privatePath 特 性 并 不 能 用 于 指定 一 个 绝对 路 径 ( C:\SomeFolderSomeSubFolder ) 或 者 一 
个 相对 路 径 ( .\SomeFolder\AnotherFolder ) ! 如 果 想 指定 应 用 程序 目录 以 外 的 另 一 个 目录 ， 必 
须 使 用 另外 一 个 XML 元 素 : 《codeBasey> 元 素 ( 该 元 素 将 会 在 本 章 后 面 详细 介绍 ) 。 


使 用 分 号 定 界 符 ，privatePath 特 性 可 以 指定 多 个 子 目 录 。 现在 并 不 需要 这 样 做 , 但 下 面 展示 一 
例子 ， 它 通知 CLR 去 探测 MyLibraries 和 MyLibraries\Tests 这 两 个 子 目 录 : 

<probing privatePpath="MyLibraries;MyLibraries\Tests"/> 

为 了 测试 一 下 ， 请 改变 配置 文件 名 称 ( 随便 取 一 个 名 字 )， 然 后 再 次 运行 程序 。 这 一 次 程序 将 会 
运行 失败 。 请 记 住 *.config 文 件 必须 以 相关 的 客户 端 应 用 程序 名 作为 自己 的 前 级 。 最 后 再 做 一 个 测试 ， 
打开 配置 文件 , 更 改 其 中 任意 XML 元 素 的 大 小 写 ,保存 文件 , 你 会 发 现 你 的 程序 再 次 不 能 正常 运行 ( 前 
面 提 到 过 ，XML 文 件 是 区 分 大 小 写 的 )。 


说 明 要 理解 CLR 在 探查 处 理 中 会 加 载 第 一 个 找到 的 程序 集 。 上 比如， 如 果 C:\IMyApp 文 件 夹 包含 
CarLibrary.dll 的 副本 ， 它 就 会 被 加 载 到 内 存 中 ， 而 MyLibraries 中 的 副本 则 会 被 忽略 。 


14.5.4 ”App.Config 文 件 


你 当然 可 以 使 用 文本 编辑 器 手动 编写 XML 配 置 文 件 ， 但 Visual Studio 允许 在 开发 客户 程序 的 同时 
创建 配置 文件 。 首 先 ， 通 过 Project 一 Add New Item 菜 单 选项 向 项 目 添加 一 个 新 的 Application 
Configuration 文 件 项 。 注 意 在 图 14-11 中 ， 该 文件 的 名 称 为 推荐 的 App.Config。 


<?xml] Version="1.0”encoding="utf-8”?> 
<configuration> 
</configuration> 
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图 14-11 在 Visual Studio 新 项 目 中 插入 新 的 App.config 文 件 


打开 该 文件 ， 你 会 发 现 一 组 很 少 的 指令 ， 可 以 向 其 中 添加 其 他 元 素 : 

现在 , 可 以 为 创建 的 应 用 程序 输入 需要 的 XML 元 素 。 奇妙 的 事情 发 生 了 , 每 次 编译 项 目 时 ,Visual 
Studio 会 自动 把 App.config 中 的 数据 复制 到 \bin\Debug 目 录 下 的 一 个 新 文件 中 ， 并 将 它 改 为 一 个 合适 的 
名 称 ( 如 CSharpCarClient.exe.config )。 但 是 ， 请 记 住 ， 做 这 一 切 的 前 提 是 该 配置 文件 的 名 字 必 须 是 
App.config， 如 图 14-12 所 示 。 





* SOLUHON EXPLORER ©: 
coagemrom 
Search Solution Explorer (Ctrl 万 - 
国 Sciution 'CSharpCarClient’ (1 project) 
4 CSharpCarClient 

b pK Properties 

b> sa References 








Debug 

Carlibrary.dil 

3 CarLibrary.pdb 

i CSharpCarClient.exe 







L CSharpCarClient.pdb 


CSharpCarClient.vshost.exe 
CSharpCarClient.vshost,exe.config 
CSharpCarClient.vshost.exe.manifest 
b 时 obj 
崔 App.config 


Per Program.cs 





SOLUTION EXPLORER 时 


图 14-12 ”App.config 的 内 容 将 被 复制 到 输出 目录 中 正确 命名 的 *.config 中 
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使 用 这 种 方法 ， 我 们 需要 做 的 事情 只 是 维护 App.config 的 内 容 ，Visual Studio 会 确保 应 用 程序 目录 
包含 最 新 的 内 容 ( 就 算 我 们 偶然 地 把 项 目 重 命 名 了 )。 


14.6 ”共享 程序 集 


现在 已 经 知道 如 何 部 署 和 配置 一 个 私有 程序 集 ， 接 着 开始 了 解 共 享 程 序 集 的 作用 。 和 私有 程序 集 
一 样 ， 共 享 程序 集 是 旨 在 多 个 项 目 中 复 用 的 类 型 的 集合 。 两 者 的 本 质 区 别 在 于 共享 程序 集 的 一 个 副本 
可 供 一 台 机 器 上 的 多 个 应 用 程序 使 用 。 

考虑 本 书 中 所 有 需要 访问 mscorlib.dll 的 应 用 程序 。 查 看 一 下 它们 的 目录 ,我 们 将 找 不 到 该 ,NET 程 
序 集 的 私有 副本 。 这 是 因为 mscorlib.dll 被 部 署 为 共享 程序 集 。 由 此 可 见 ， 如 果 想 要 创建 一 个 机 器 级 别 
( machine wide ) 的 类 库 ， 那 么 需要 把 它 部 署 为 共享 程序 集 。 


说 明 ”将 代码 库 部 署 为 私有 库 还 是 共享 库 ， 仍然 是 一 个 需要 权衡 的 问题 ， 它 取决 于 项 目 本 身 的 细节 。 
一 般 来 说 ， 如 果 构 建 的 库 可 被 大 量 应 用 程序 使 用 ， 共 享 程序 集 将 十 分 有 帮助 ， 因 为 你 可 以 轻 
松 地 部 署 一 个 新 的 版 本 〔〈 稍 后 将 看 到 )。 


14.6.1 全 局 程序 集 缓存 


在 前 面 提 到 , 一 个 共享 程序 集 并 不 部 署 在 使 用 它 的 应 用 程序 目录 中 。 相 反 , 共享 程序 集 安装 在 GAC 
中 。 但 是 ，GAC 的 确切 位 置 则 取决 于 目标 机 器 上 所 安装 的 .NET 平 台 的 版 本 。 

在 没有 安装 .NET 4.0 或 更 高 版 本 的 机 器 中 , GAC 是 在 Windows 目 录 下 名 为 Assembly 的 子 目 录 中 ( 例 
如 , C:\Windows\assembly )。 现在 它 应 该 叫做 “ 老 GAC” 了 , 因为 它 只 包含 1.0、2.0、3.0 和 3.5 版 本 的 .NET 
库 。 如 图 14-13 所 示 。 


计 Organize Y Open Share with v Burn New folder 

起 Program Files (x86) * Assembly Name Version Cul.. Public Key Token 
Accessibility 2000 bOSF7f11d50a3a 
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图 14-13 老 GAC 
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”说 明 不 能 把 可 执行 的 程序 集 (*.exe ) 安装 到 GAC。 只 有 *.dll 文 件 可 以 被 部 署 为 共享 程序 集 。 


.NET 4.0 发 布 时 , 微软 决定 将 .NET 4.0 和 更 高 版 本 的 库 隔离 到 单独 的 位 置 , 即 C:\Windows\Microsoft. 
NET\assembly\GAC_MSIL ( 如 图 14-14 所 示 )。 
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图 14-14” .NET 4.0 和 更 高 版 本 的 GAC 


该 新 目录 下 存在 很 多 子 目录 ， 都 以 特殊 代码 库 的 友好 名 称 命名 ( 如 \System.WIndows.Forms 和 
\System.Core 等 )。 在 给 定 的 友好 名 称 文件 夹 下 ， 会 发 现 男 一 个 子 目录 ， 通 常 以 下 面 的 约定 命名 : 

v4.0_major.minor.build.revision publickeyTokenValue 

“v4.0” 前 缀 表示 该 库 由 .NET 4.0 或 更 高 版 本 编译 。 该 前 绥 后 面 是 一 个 下 划 线 ， 然 后 是 该 库 的 版 本 
号 (如 1.0.0.0 )。 两 个 下 划 线 之 后 ， 是 另 一 串 数字 ， 叫 做 publickey 标 记 值 。 在 下 一 节 将 看 到 ， 这 个 公共 
键 值 是 程序 集 “ 强 名 称 ” 的 一 部 分 。 最 后 , 在 这 个 文件 夹 下 , 你 会 发 现 当前 讨论 的 *.dll 文 件 的 一 个 副本 。 

在 本 书 中 ,我 假设 你 都 是 使 用 .NET 4.5 构 建 应 用 程序 。 因 此 如 果 要 在 GAC 中 安装 库 ， 将 会 安装 到 
C:\Windows\Microsoft.NET\assembly\GAC_MSIL 中 。 但 要 清楚 的 是 ， 如 果 要 配置 使 用 3.5 或 更 早 版 本 编 
译 的 Class Library 项 目 ， 共 享 库 是 安装 在 C:\Windows\assembly 下 的 。 


14.6.2” 强 名 称 


在 部 署 程序 集 到 GAC 前 ,必须 赋予 它 一 个 强 名 称 。 强 名 称 用 于 标识 给 定 .NET 二 进 制 文件 的 发 行者 。 
“发 行者 ”可 以 是 一 个 独立 程序 员 ( 比如 你 ) ， 可 以 是 某 公 司 的 一 个 部 门 ， 还 可 以 是 整个 公司 。 

在 一 定 程度 上 可 以 说 ， 强 名 称 在 ,NET 中 的 作用 好 比 全 局 唯一 标识 符 (GUID ) 在 COM 中 的 作用 。 
如 果 学 过 COM 编 程 ， 你 会 想起 AppID 是 标识 特定 COM 应 用 程序 的 GUID。 与 COM GUID 值 ( 只 是 128 
位 的 二 进 制 数字 ) 不 同 , 强 名 称 是 基于 两 个 密码 学 上 双关 的 钥 ( 公 钥 和 私 钥 ) 的 , 这 种 机 制 比 起 GUID 
更 具 唯 一 性 和 抗 算 改 性 。 
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强 名 称 由 一 组 相关 数据 组 成 。 我 们 可 以 使 用 以 下 程序 集 级 别 的 特性 来 定义 其 中 的 大 部 分 数据 。 

口 程序 集 的 友好 名 称 ( 程序 集 名称 减 去 文件 扩展 名 )。 

口 程序 集 的 版 本 号 ( 使 用 [Assemblyversion] 特 性 赋值 )。 

口 公 钥 值 ( 使 用 [AssemblykeyFile] 特 性 赋值 )。 

口 用 于 本 地 化 的 可 选 的 区 域 性 标识 ( 使 用 [AssemblyCulture] 特 性 赋值 )。 

口 戏 入 的 数字 签名 ， 使 用 基于 程序 集 内 容 的 散 列 值 和 私 钥 值 生 成 。 

为 了 给 一 个 程序 集 赋 予 强 名 称 ， 首 先 需 要 使 用 NET Framework 4.5 的 sn.exe 工 具 生成 公 钥 / 私 钥 对 。 
sn.exe 工 具 生 成 一 个 文件 [通常 以 *.snk ( Strong Name Key ) 作为 文件 扩展 名 ]， 该 文件 包含 两 个 不 同 的 
但 算术 上 相关 的 钥 : 公 钥 和 私 钥 。 一 旦 C# 编 译 器 确定 *.snk 文 件 的 位 置 ， 它 就 会 在 编译 过 程 中 使 
用 .publickey 标 记 把 公 钥 值 记 录 到 程序 集 清单 里 。 

另外 ，C# 编 译 器 还 会 产生 一 个 基于 整个 程序 集 内 容 ( CIL 代 码 、 元 数据 等 ) 的 散 列 值 。 在 第 6 章 已 
经 讲 过 , 散 列 码 是 对 于 某 一 固定 输入 的 独一无二 的 数值 输出 。 因此, 如 果 更 改 了 .NET 程 序 集 的 内 容 ( 就 
算 只 是 改变 一 个 字符 ) ， 编 译 器 将 产生 完全 不 同 的 散 列 码 。 散 列 码 结合 *.snk 文 件 中 的 私 钥 组 成 数字 签 


名 ,并 把 它 舱 入 到 程序 集 的 CLR 首 部 数据 中 。 产 生 程 序 集 的 强 名 称 的 整个 过 程 如 图 14-15 
所 示 。 





清单 〈 带 公 钼 ) 
类 型 元 数据 


CIL 





图 14-15 ”编译 期 间 ，C# 编 译 器 将 基于 公 钥 和 私 钥 数据 生成 数字 签名 ， 并 把 它 
插入 到 程序 集中 


实际 的 私 钥 并 不 在 程序 集 清 单 中 列 出 ， 它 只 用 做 对 程序 集 内 容 进 行 数字 签名 ( 结合 生成 的 散 列 
码 ) 。 重 申 一 点 , 使 用 公 钥 / 私 钥 这 个 密码 学 概念 ， 完 全 是 为 了 确保 在 .NET 领 域 中 ,没有 任意 两 个 公 
司 、 部 门 或 个 人 拥有 相同 的 标识 。 程 序 集 被 赋予 强 名 称 后 ， 就 可 以 安装 到 GAC 中 。 


说 明 强 名 称 同 时 为 程序 集 的 内 容 提 供 了 一 定 程度 的 保护 ， 防 止 程序 集 被 自 改 。 因 此 ，.NET 建 议 为 
每 一 个 程序 集 ( 包括 *.exe 程 序 集 ) 都 赋予 一 个 强 名 称 ， 无 论 该 程序 集 是 否 被 安装 到 GAC。 


14.6.3 ”在 命令 行 生成 强 名 称 
让 我 们 动手 为 先前 创建 的 CarLibrary.dll 程 序 集 赋予 强 名 称 。 现 在 ,你 可 以 使 用 Visual Studio 生 成 需 
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要 的 *.snk 文 件 ， 而 在 “万 恶 的 旧 社 会 ” (大约 2003 年 ) ， 为 程序 集 进行 强 命名 的 唯一 选择 是 命令 行 。 
我 们 来 看 看 如 何 实现 。 

首先 使 用 sn.exe 工 具 生成 需要 的 密 钥 。 尽 管 sn.exe 工 具 拥 有 众多 命令 行 选项 , 但 现在 只 需要 关心 -k 
标记 , 它 会 要 求 sn.exe 工 具 生成 一 个 包含 公 钥 / 私 钥 对 的 新 文件 。 在 硬盘 C 区 创建 一 个 名 为 MyTestKeyPair 
的 文件 来， 通过 Developer Command Prompt 转 到 该 目录 下 。 然 后 输入 以 下 命令 生成 MyTestKeyPair.snk 
文件 : 

sn -k MyTestKeyPair. snk 

公 钥 / 私 钥 对 生成 后 ， 接 着 需要 把 MyTestKeyPair.snk 文 件 的 位 置 告 诉 C# 编 译 器 。 本 章 前 面 介 绍 过 ， 
如 果 使 用 Visual Studio 创 建 任何 新 的 C# 项 目 ， 都 会 发 现 初 始 项 目 文件 ( 位 于 Solution Explorer 的 Properties 
节点 ) 中 包含 一 个 AssemblyInfo.cs 文 件 。 这 个 文件 包含 了 大 量 描述 程序 集 自身 的 特性 ,。 [AssemblyKeyFile] 
就 是 其 中 一 个 程序 集 级 别 的 特性 , 它 被 添加 到 AssemblyInfo.cs 文 件 中 , 以 便 告诉 编译 器 有 效 的 *.snk 文 件 
的 位 置 所 在 。 下 面 使 用 一 个 字符 串 来 定义 该 位 置 : 


[assembly: AssemblyKeyFile(@"C:\MyTestKeyPair\MyTestKeyPair.snk")] 


说 明 当 手 动 指定 [AssemblyKeyFile] 特 性 时 ，Visual Studio 会 生成 警告 来 通知 你 使 用 csc.exe 的 
/keyfile 选 项 ,或 者 通过 Visual Studio 的 Properties 窗 口 建立 密 钥 文件 。 不 久 你 会 使 用 [DE 来 完成 
(所 以 可 以 忽略 警告 )。 


由 于 共享 程序 集 的 版 本 号 也 作为 强 名 称 的 一 部 分 ， 因 此 必须 为 CarLibrary.dll 定 义 一 个 版 本 号 。 在 
AssemblyInfo.cs 文 件 里 ,会 看 到 男 外 一 个 名 为 [AssemblyVersion] 的 特性 。 先 把 它 的 值 设 为 1.0.0.0: 


[assembly: AssemblyVersion("1.0.0.0")] 


.NET 版 本 号 由 4 个 部 分 组 成 ( <major>.<minor>.<build>.<revision> ), 如 果 保 持 上 面 的 设置 , Visual 
Studio 会 自动 在 编译 时 增加 版 本 值 ( 使 用 * 通 配 符 标记 ， 而 非特 定 的 版 本 值 )。 本 例 不 需要 这 样 做 。 思 
考 如 下 代码 : 


// 格式 : 《Major number>.<Minor number>.<Build number>.<Revision number> 
// 每 一 部 分 的 有 效 取 值 范围 都 是 0~65535 
[assembly: AssemblyVersion("1.0.*")] 


现在 ，C# 编 译 右 已 经 获取 了 所 有 用 于 生成 强 名 称 数据 的 信息 ( 并 没有 通过 [AssemblyCulture] 
特性 设置 独特 的 Culture 属 性 值 ， 而 是 自动 “继承 ”了 当前 机 器 中 的 Culture 属 性 值 ， 在 本 例 中 为 US 
English )。 

编译 CarLibrary 代 码 库 , 然后 使 用 ildasm.exe 查 看 它 的 清单 。 会 看 到 .pub1lickey 标 签 记 录 了 公 钥 
的 所 有 信息 ， 而 .ver 标 记 则 记录 了 前 面 通过 [AssemblyVersion] 特 性 设置 的 版 本 号 (如 图 14-16 
所 示 )。 

这 时 ,我 们 可 以 向 GAC 中 部 署 共享 的 CarLibrary.dll 程 序 集 。 不 过 要 记 住 ,现在 .NET 开 发 者 可 以 使 
用 Visual Studio 中 友好 的 用 户 界 面 创建 强 命名 的 程序 集 ， 而 不 用 再 使 用 神秘 的 sn.exe 命 令 行 工具 。 在 查 
看 详情 之 前 ， 确 保 从 AssemblyInfo.cs 文 件 中 删除 (或 注释 掉 ) 下 面 这 行 代 码 : 

// [assembly: AssemblyKeyFile(@"C:\MyTestKeypair\MyTestKeyPair.snk")] 
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-Custom instance void [mscorlib]System.Reflection.AssenblyKeyFilefAttribut 小 


/1f --- The following custom attribute is added automatically, do not UBco 
1/ -custon instance void fmscorlib]Systenm.Diagnostics.DebuggablefAttribut 


-T= (00 24 88 68 94 88 88 86 94 989 98 688 82 66 6868 
899 24 6868 88 52 53 41 31 88 88 88 89 81 698 
45 26 78 88 ED 26 5B 65 88 88 BD D5 88 8E 
6D 14 8E 9¢ ED 98 6 F3 DB 9F 2E F7 B89 EA 
DC 11 95 5B 96 uC 86 35 C7 19 75C A8 81 BE 
85 768 84 F3 5C 28 68 89 38 F3 48 88 SE D3 
4E 64 98 SE 49 AD 51 8E 98 HE 6F EB 2A 88 
F9 E1 48 67 ?7D 12 AD 83 78 95 11 8Bh 2B B1 
89 56 19 89 C7 E1 G8C 84 B3 Cc3 CC DD bp3 
DB SF SE 78 A7 5E 26 AC 39 9E ) 

-hash algorithm Bx698068085 

-er 1:8:8:8 








> 
-nodule CarLibrary. dli 





图 14-16” 强 名 称 程序 集 在 清单 中 记录 了 公 钥 


14.6.4 ”使 用 Visual Studio 为 程序 集 赋 予 强 名 称 


Visual Studio 人 允许 我 们 使 用 项 目的 Properties 页 指定 *.snk 文 件 的 位 置 ， 并 生成 新 的 *.snk 文 件 。 在 
CarLibrary 项 目 中 首先 双击 Solution Explorer 中 的 Properties 图 标 ， 选 择 Signing 选 项 卡 ， 然 后 选中 Sign the 
assembly 复 选 框 并 选择 下 拉 列 表 中 的 <New...> 选 项 ( 如 图 14-17 所 示 )。 


Cartibrary” 二 X AssemblyInfo. CS 2 2 


Appiication 
Build 


Build Events x 
Debug | | 
Resources 
Services 
Settings 
Reference Paths 


Code Analysis | 


提 gs 


v| Sign the assembly 


Choose a strong name key fije: | 








图 14-17 使 用 Visual Studio 创 建新 的 *.snk 文 件 
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然后 ， 你 需要 为 新 的 *.snk 文 件 提供 一 个 名 称 ( 如 myKeyFile.snk )， 而 且 你 还 可 以 选择 是 否 用 密码 


Key file name: 


myKeyPair.snk 


| Pretest my fer le wh e pesmmerd 


Enter password: 
Confirm password: 


| Signature Algorithm 





图 14-18 使 用 Visual Studio 命 名 *.snk 文 件 


这 时 ,你 将 在 Solution Explorer 中 看 到 *.snk 文 件 ( 如 图 14-19 所 示 )。 每 次 生成 应 用 程序 时 ， 该 文件 
中 的 数据 都 将 为 程序 集 分 配 一 个 合适 的 强 名 称 。 


SOLUTION EXPLORER : 
oI,|Q| 


Search Solution Explorer {Ctri+;} 





Solution 'CarLibrary' (1 project) 
4 CarLibrary 
4 wi] Properties 
b cs Assemblyinfo.cs 
by wu References 
> Ca BaseCar.cs 
Pb Ga DervedCars.cs 


ry Fz 和 
(I myKeyPair.snk 








SOLUTION EXPLORER (TEAM 


图 14-19 ”Visual Studio 在 每 次 编译 时 都 将 为 程序 集 进行 强 签名 
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说 明 ”属性 编辑 器 的 Application 标 签 页 提供 了 一 个 名 为 Assembly Information ( 程序 集 信息 ) 的 按钮 。 
单 击 这 个 按钮 ， 会 出 现 一 个 对 话 框 ， 我们 可 以 用 来 创建 包含 版 本 号 、 版 权 信 息 在 内 的 许多 程 
序 集 级 别 的 特性 。 


14.6.5 ”在 GAC 中 安装 强 名 称 的 程序 集 


最 后 一 步 就 是 把 CarLibrary.dll ( 现在 它 已 经 具有 强 名 称 ) 安装 到 GAC 中 。 把 程序 集 安装 到 GAC 的 
最 简单 方法 就 是 创建 Windows MSI 安 装 包 (或 者 使 用 商用 安装 程序 ， 比 如 InstallShield )，.NET 
Framework 4.5 SDK 提 供 了 命令 行 工 具 gacutil.exe， 它 用 于 快速 测试 。 


说 明 ”你 必须 拥有 管理 员 权 限 才 能 与 机 器 中 的 GAC 进 行 交互 ， 这 可 能 需要 调整 User Access Control 
(UAC， 用 户 访 问 控制 ) 的 设置 。 


表 14-1 记 录 了 gacutil.exe 相 关 的 参数 选项 (也 可 以 在 命令 中 使 用 /? 标 志 来 查看 每 个 选项 ) 。 
表 14-1 gacutil.exe 的 各 种 参数 选项 


选 项 作 用 
i 将 强 名 称 程序 集 安装 人 GAC 
-u 从 GAC 中 印 载 程序 集 
-1 在 GAC 中 显示 程序 集 ( 或 特定 程序 集 ) 


要 使 用 gacutil.exe 安 装 强 命名 程序 集 ， 首先 要 打开 Developer Command Prompt, 然后 将 目录 定位 到 
CarLibrary.dll 所 在 的 目录 ,例如 (路径 可 能 会 不 同 ): 

cd C:\MyCode\CarLibrary\bin\Debug 

接 下 来 ,使 用 -i 命令 安装 该 库 ， 如 下 所 示 : 

gacutil -i CarLibrary.dll 

然后 ， 可 以 使 用 -1 命令 核实 该 库 是 否 已 经 部 署 成 功 ( 注意 使 用 -1 命令 时 要 忽略 文件 扩展 名 ): 

gacutil -1 CarLibrary 


如 果 一 切 正常 ,可 以 在 Console 窗 口中 看 到 如 下 的 输出 结果 ( 你 将 如 期 得 到 唯一 的 PublickeyToken 值 ): 





The Global Assembly Cache contains the following assemblies: 
Carlibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=33a2bc294331e8b9, 
processorArchitecture=MSIL 





此 外 ， 导 航 到 C:\Windwos\MicrosoftNET\assembly\GAC _MSIL ， 会 发 现 包 含 正 确 子 目录 结构 的 新 
的 CarLibrary 文 件 夹 ( 如 图 14-20 所 示 )。 


14.7 使 用 共享 程序 集 437 


Nama Date modified 


六 MicrosoRtNET 3 | Cartibray,dl -0/0121022AM App 网 
crosoft, Ss 


assembly 
家 GAC_32 
六 GAC 64 
其 GAC_MSIL 
训 Accessibility 
加 AspNetMMCExt 
畜 Carlibrary 
志 v40 1000_64ee9364749d8328 
二 CppCodeProvider 汪汪 
未 _Fcharn Camniler a ids 


Cartlibrary.dHl Date modified: 4/10/2012 10:22 AM Date created: 4/10/2012 10:22 AM 


tension 








14.7 ”使 用 共享 程序 集 


和 使 用 私有 程序 集 构建 程序 相 比 ， 使 用 共享 程序 集 构建 程序 的 唯一 不 同 在 于 如 何在 Visual Studio 
中 添加 程序 集 引 用 。 事 实 上 ， 工 具 上 没有 任何 改变 ( 仍然 使 用 Add Reference 对 话 框 ) 

如 果 需 要 引用 私有 程序 集 ， 可 以 使 用 Browse 按 钮 导航 到 GAC 中 正确 的 子 目录 。 不过, 你 还 可 以 简 
单 地 导航 到 强 命名 程序 集 所 在 的 位 置 ( 如 某 类 库 项 目的 /bin/debug 文 件 夹 ), 然后 引用 该 副本 。 当 Visual 


Studio 找 到 一 个 强 命名 程序 集 时 ， 将 不 会 把 该 库 拷贝 到 客户 端 应 用 程序 的 输出 文件 夹 。 图 14-21 展 示 了 
引用 的 库 。 


Name Path 


Og | 
(Carlibrary.dl 四 ENMy BooksC= BoolNCz and the ,NET Plat Carlibrary.dil 
全 Created by: 


File Version: 
10.0.0 








Browse | [OK [Cancet 
图 14-21 使 用 Visual Studio 引 用 强 命名 的 共享 CarLibrary ( 1.0.0.0 版 ) 
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为 了 演示 这 一 点 ， 新 建 一 个 C# 控制 台 应 用 程序 ， 命 名 为 SharedCarLibClient， 并 引用 前 面 描述 的 
CarLibrary.dll 程 序 集 。 现 在 ， 在 Solution Explorer 的 Reference 文 件 夹 里 有 一 个 图 标 。 选 中 该 图 标 ， 然 后 
查看 Properties 窗 口 ( 可 通过 Visual Studio 的 View 菜 单 访问 ), 会 发 现 选 中 的 CarLibrary 的 Copy Local 属 性 
设置 为 false。 不 管 怎样 ， 在 新 的 客户 端 应 用 程序 中 编写 如 下 的 测试 代码 : 


using System; 

using System.Collections.Generic; 
using System.Linqg; 

using System.Text; 

using System.Threading.Tasks; 


using CarlLibrary; 
namespace SharedCarlLibClient 
class Program 
static void Main(string[] args) 


Console.WritelLine("***** Shared Assembly Client *****"); 
SportsCar c = new SportsCar(); 

c.TurboBoost(); 

Console.ReadLine(); 


} 
} 


编译 完 客 户 应 用 程序 后 , 使 用 Windows 资 源 管理 器 查看 含有 SharedCarLibClient.exe 文 件 的 文件 夹 ， 
会 发 现 Visual Studio 并 没有 把 CarLibrary.dl] 复 制 到 客户 应 用 程序 的 目录 下 。 当 发 现 引用 程序 集 的 清单 
中 含有 .publickey 值 时 ，Visual Studio 就 会 假定 这 个 具有 强 名 称 的 程序 集 已 被 部 署 到 GAC 中 , 因此 它 将 
不 会 对 该 程序 集 进行 复制 工作 。 


查看 SharedCarLibClient 程 序 集 的 清单 


前 面 讲 到 过 ， 在 为 一 个 程序 集 生成 强 名 称 时 ， 整 个 公 钥 将 会 被 记录 到 程序 集 清单 里 面 。 而 一 个 客 
户 端 应 用 程序 引用 一 个 强 名 称 程序 集 时 ，.NET 会 把 该 程序 集 的 公 钥 压缩 成 散 列 值 , 然后 存放 在 客户 端 
应 用 程序 清单 的 .publickeytoken 标 签 里 。 使 用 ildasm.exe 查 看 SharedCarLibClient.exe 的 清单 时 ， 将 会 看 
到 以 下 内 容 〈 公 钥 标 记 值 会 不 一 样 ， 因 为 它 是 根据 公 钥 值 计 算得 到 的 ) : 

.assembly extern CarLibrary 


.publickeytoken = (33 A2 BC 29 43 31 E8 B9 ) 
Ver 1:0:0:0 


如 果 把 存放 在 客户 端 清单 里 的 公 钥 标记 值 与 GAC 展 示 给 你 的 公 钥 标记 值 相 比 较 , 会 发 现 它 们 完全 
匹配 。 记 得 公 钥 作为 强 名 称 程序 集 标识 的 一 部 分 。 因 此 ，CLR 只 会 加 载 这 样 的 CarLibrary 程 序 集 : 版 
本 号 为 1.0.0.0， 公 和 钥 的 散 列 值 是 33A2BC294331E8B9。 如 果 CLR 在 GAC 中 找 不 到 一 个 程序 集 符合 以 上 要 
求 (同时 在 客户 端 应 用 程序 目录 下 找 不 到 私有 程序 集 CarLibrary ) ， 则 会 抛 出 FileNotFoundException 
异常 。 
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源 代码 ”SharedCarLibClient 应 用 程序 的 源 代 码 位 于 Chapter 14 子 目录 下 。 


14.8 配置 共享 程序 集 


和 私有 程序 集 一 样 , 共享 程序 集 也 可 以 使 用 *.config 文 件 进行 配置 。 由 于 共享 程序 集 安装 在 一 个 公 
共 的 地 方 (GAC )， 因 此 并 不 需要 像 私有 程序 集 那样 在 配置 文件 中 定义 <privatepPath> 元 素 ( 如 果 客 户 
程序 既 使 用 共享 程序 集 又 使 用 私有 程序 集 ， 那么 在 *.config 文 件 里 cprivatePath> 元 素 还 是 有 的 )。 

如 果 想 要 指示 CLR 绑 定 到 某 一 程序 集 的 其 他 版 本 ， 可 以 使 用 应 用 程序 配置 文件 和 共享 程序 集 ， 我 
们 就 可 以 有 效 地 跳 过 客户 程序 清单 中 记录 的 值 。 这 样 做 的 好 处 很 多 。 比 如 ， 假 设 你 已 经 发 布 了 程序 集 
(代码 库 ) 的 1.0.0.0 版 本 , 但 是 后 来 发 现 一 个 重大 的 缺陷 。 一 种 补救 措施 是 : 重新 生成 客户 端 应 用 程序 ， 
使 其 引用 已 经 消除 缺陷 的 程序 集 版 本 ( 如 1.1.0.0 版 本 ), 然后 把 新 的 客户 端 应 用 程序 和 新 的 代码 库 发 布 
到 每 一 台 目 标 机 器 上 。 

另 一 种 做 法 是 发 布 新 的 代码 库 ， 使 用 一 个 *.config 文 件 在 运行 时 自动 指示 运行 库 绑 定 到 新 的 无 错 
版 。 只 要 新 版 本 的 程序 集 已 经 安装 到 GAC 中 ， 原 来 的 客户 应 用 程序 就 不 需要 重新 编译 生成 和 发 布 。 

再 举 一 个 例子 : 在 发 布 了 第 一 个 消除 缺陷 的 程序 集 ( 1.1.0.0 版 本 ) 的 一 到 两 个 月 后 , 一 些 新 的 功能 被 
添加 到 程序 集中 ， 由 此 而 产生 2.0.0.0 版 本 。 显 然 ， 目 前 的 客户 端 应 用 程序 是 根据 代码 库 的 1.0.0.0 版 本 进行 
编译 的 ， 因 此 它 并 不 知道 新 版 本 程序 集 里 面 的 新 类 型 ( 假定 在 客户 端 应 用 程序 代码 里 并 没有 引用 到 )。 

此 时 ， 如 果 客 户 端 应 用 程序 想 要 使 用 2.0.0.0 版 本 里 面 提供 的 新 功能 ， 在 .NET 下 ， 可 以 把 2.0.0.0 版 
本 的 程序 集 发 布 到 目标 机 器 ， 让 2.0.0.0 版 本 和 1.0.0.0 版 本 和 平 共处 。 所 以 在 需要 的 时 候 ， 只 要 修改 应 
用 程序 的 配置 文件 ， 然 后 原 有 的 客户 程序 就 可 以 动态 地 定向 到 2.0.0.0 版 本 了 (以便 调 用 新 的 功能 ) ， 
这 一 切 并 不 需要 重新 编译 和 部 署 。 


14.8.1 冻结 当前 的 共享 程序 集 


为 了 说 明 如 何 动态 绑 定 到 共享 程序 集 的 某 一 个 版 本 ， 请 打开 Windows 资 源 管 理 器 ， 然 后 把 
CarLibrary.dll 当 前 版 本 ( 1.0.0.0 ) 放 到 独立 的 目录 ( CarLibrary Version 1.0.0.0 ) 中 ， 如 图 14-22 所 示 。 


Organize 


本 包 Local Disk (C:) 
二 Cartibrary Version 1.0.0.0 


地 eclipse 
bp 二 inetpub 
Bh UNQPad4 
”5 MyApp 
> MyCode 








图 14-22 ”冻结 CarLibrary.dll 的 当前 版 本 





440 第 14 章 .NET 程序 集 入 门 


14.8.2 ”构建 共享 程序 集 2.0.0.0 版 本 


现在 让 我 们 来 更 新 CarLibrary 项 目的 内 容 。 定 义 一 个 枚 举 类 型 MusicMedia， 定义 4 种 音乐 播放 融 : 
// 这 辆 拥有 哪 种 音乐 播放 器 
public enum MusicMedia 


musicCd, 
musicTape, 
musicRadio, 
musicMp3 


接着 ， 为 Car 类 型 添加 一 个 新 的 公共 方法 ， 人 允许 调用 者 打开 某 一 个 给 定 的 音乐 播放 器 〈 如 果 需 要 ， 
一 定 要 引入 System.Windows.Forms 命 名 空间 )。 如 下 所 示 : 


public abstract class Car 


public void TurnOnRadio(bool musicOn, MusicMedia mm) 


if(musicon) 

MessageBox.Show(string.Format("Jamming {0}", mm)); 
else 

MessageBox.Show("Quiet time..."); 


} 
} 
更 新 Car 类 的 构造 函数 ， 显 示 一 个 MessageBox， 验 证 我 们 正在 使 用 CarLibrary 2.0.0.0 版 本 : 


public abstract class Car 


public Car() 
{ 

MessageBox.Show("CarLibrary Version 2.0!"); 
public Car(string name, int maxSp, int currSp) 


MessageBox.Show("CarLibrary Version 2.0!"); 
PetName = name; MaxSpeed = maxSp; CurrentSpeed = currSp; 


} 


} 

最 后 ， 在 重新 编译 前 ， 请 确保 程序 集 的 版 本 号 是 2.0.0.0。 双 击 Solution Explorer 的 Properties 图 标 ， 
单 击 Application 选 项 卡 中 的 Assembly Information... 按 钮 。 这 样 ， 就 可 以 简单 地 更 新 Assembly Version 的 
数值 ， 以 可 视 的 方式 来 修改 版 本 号 ( 如 图 14-23 所 示 )。 

现在 查看 项 目的 \bin\Debug 目 录 , 会 发 现 新 版 本 的 程序 集 ( 2.0.0.0 ), 而 1.0.0.0 版 本 则 还 在 CarLibrary 
Version 1.0.0.0 子 目录 下 。 使 用 本 章 前 面 介 绍 的 gacutil.exe 把 新 版 本 安装 到 4.0GAC 中 。 注 意 ,， 你 现在 
有 同一 程序 集 的 两 个 版 本 ( 如 图 14-24 所 示 )。 

如 果 现 在 使 用 Windows 资 源 管理 器 执行 SharedCarLibClient.exe ， 还 不 能 看 到 显示 “CarLibrary 
Version 2.0” 的 消息 框 , 因为 现在 客户 程序 还 是 引用 版 本 1.0.0.0 程 序 集 。 我 们 应 该 如 何 指示 CLR 去 绑 定 
版 本 2.0.0.0 呢 ? 
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Title: Carlibrary 


Description: 

Company: 

Product: Carlibrary 

Copyright: Copyright © 2012 
Trademark: 

Assembly version: >| 0 o 0 


File version: 1 0 0 8 





GUID: fe8206c8-5dd2-4301-9dc8-719b76862893 
Neutral language: (None) 
Make assembly COM-Visible 











图 14-23 ”设置 CarLibrary.dll 的 版 本 号 为 2.0.0.0 





Organize v Include in Horny | = 


遍 Accessibility 
3 AspNetMMCExt 
4 BS CarLibrary 
W010.0.0_64ee9364749d8328 
吉 V4.0 2.0.00_1 64ee9364749d8328 
”5 CppCodeprovider 


汐 《artibrary.d 








Cope 


图 14-24 ”共存 的 两 个 版 本 


说 明 Visual Studio 会 在 我 们 编译 应 用 程序 的 时 候 自动 重 置 引 用 ! 因此 ， 当 在 Visual Studio 中 运行 
SharedCarLibClient.exe 应 用 程序 时 ， 它 会 选择 2.0.0.0 版 本 的 CarLibrary.dll! 如 果 我 们 不 小 心 这 
样 运行 程序 的 话 ， 只 要 删除 当前 的 CarLibrary.dl1 引 用 并 选择 1.0.0.0 版 本 (我 建议 过 你 把 它 放 在 
叫 CarLibrary Version 1.0.0.0 的 文件 夹 中 ) 就 可 以 了 。 





14.8.3 ”动态 重 定向 到 共享 程序 集 的 特定 版 本 
如 果 想 要 CLR 加 载 一 个 不 同 于 程序 清单 中 的 版 本 的 共享 程序 集 版 本 , 需要 使 用 *.config 配 置 文件 中 
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的 <dependentAssembly> 元 素 。 在 cdependentAssembly> 元 素 里 ， 需 要 创建 cassemblyIdentity> 子 元 素 ， 
它 用 于 指定 列 在 客户 清单 中 的 程序 集 的 友好 名 称 ( 如 CarLibrary ) 和 一 个 可 选 的 区 域 性 (culture ) 特 
性 〈 如 果 想 使 用 机 器 的 默认 区 域 性 设置 ， 则 把 该 特性 设置 为 空 或 者 完全 省 略 就 可 以 了 )。 另 外 ， 
<dependentAssembly> 元 素 还 需要 创建 cbindingRedirect> 子 元 素 ， 它 用 来 定义 程序 清单 当前 指向 的 版 
本 ( 使 用 子 元 素 的 oldVersion 特 性 表示 ) 和 GAC 中 的 替代 版 本 ( 使 用 子 元 素 的 newVersion 特 性 表示 )。 

修改 SharedCarLibClient 应 用 程序 目录 下 名 为 SharedCarLibClient.exe.config 的 配置 文件 (文件 具体 
内 容 如 下 ， 包 含 下 面 的 XML 数 据 )。 


说 明 ” 公 角 标记 的 值 可 能 不 同 于 下 面 的 标记 ， 要 查看 你 的 公共 键 标 记 值 ， 可 以 在 ildasm.exe 中 打开 客 
户 端 ， 双 击 MANIFEST 图 标 ， 将 值 拷 贝 到 剪贴 板 ( 要 移 除 空格 ) 。 





<?xml] version="1.0" encoding="utf-8" ?> 


<configuration> 
<!--Runtime binding info --> 
<runtime> 
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 
<dependentAssembly> 


<assemblyIdentity name="CarlLibrary" 
publicKeyToken="64ee9364749d8328" 
culture="neutral"/> 

<bindingRedirect oldVersion= "1.0.0.0" 
newVersion= "2.0.0.0"/> 

</dependentAssembly> 
</assemblyBinding> 
</runtime> 
</configuration> 


现在 通过 双击 Windows 资 源 管理 器 中 的 可 执行 文件 来 运行 SharedCarLibClient.exe。 程 序 将 会 弹出 
消息 框 以 显示 2.0.0.0 被 加 载 的 信息 。 

程序 配置 文件 中 可 以 定义 多 个 cdependentAssembly> 元 素 。 假 定 SharedCarLibClient.exe 原 来 引用 了 
MathLibrary 程 序 集 的 2.5.0.0 版 本 ,而 现在 需要 重 定 向 到 MathLibrary 的 3.0.0.0 版 本 ( 同时 CarLibrary 重 定 
向 到 2.0.0.0 版 本 )， 则 SharedCarLibClient.exe.config 文 件 内 容 如 下 : 


<configuration> 
<runtime> 
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 
<!- 绑 定 到 CarLibrary 的 控件 --> 
<dependentAssembly> 
<assemblyIdentity name="CarLibrary" 
publicKeyToken="64ee9364749d8328" 
culture=""/> 
<bindingRedirect oldVersion= "1.0.0.0" newVersion= "2.0.0.0"/> 
</dependentAssembly> 


<!- 绑 定 到 MathLibrary 的 控件 --> 
<dependentAssembly> 
<assemblyIdentity name="MathLibrary" 
publicKeyToken="64ee9364749d8328" 
culture=""/> 
<bindingRedirect oldVersion= "2.5.0.0" newVersion= "3.0.0.0"/> 
</dependentAssembly> 
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</assemblyBinding> 
</runtime> 
</configuration> 


说 明 可 以 通过 oldVersion 特 性 指定 一 系列 老 版 本 号 。 例 如 ，<bindingRedirect oldVersion= 
"1.0.0.0-1.2.0.0”newVersion="2.0.0.0"/> 告 诉 CLR 对 于 任何 在 1.0.0.0 到 1.2.0.0 之 间 的 老 版 本 
都 使 用 2.0.0.0 版 本 。 


14.9 ”发 行者 策略 程序 集 

下 一 个 关于 配置 的 话题 是 发 行者 策略 程序 集 ( Publisher Policy Assembly ) 的 作用 。 我 们 已 经 知道 ， 
使 用 *.config 文 件 可 以 忽略 清单 中 记录 的 版 本 , 并 使 客户 端 程序 绑 定 到 指定 版 本 的 共享 程序 集 。 这 一 切 
看 上 去 都 非常 美好 ,但 请 想象 一 下 ， 一 个 管理 员 需 要 做 的 工作 是 : 重新 配置 所 有 的 客户 端 程序 ， 使 其 
绑 定 到 CarLibrary.dll 程 序 集 的 2.0.0.0 版 本 。 由 于 配置 文件 的 命名 要 求 非常 严格 , 因此 需要 把 相同 的 XML 
内 容 复 制 到 所 有 的 客户 端 ( 而 能 够 这 样 做 , 还 需要 知道 所 有 使 用 CarLibrary 程 序 集 的 客户 端 目录 位 置 )。 
很 明显 ， 这 是 一 场 亚 梦 。 

发 行者 策略 允许 程序 集 的 发 行者 ( 用户、 用户 的 部 门 、 用 户 的 公司 等 ) 在 安装 相关 的 最 新 版 本 程 
序 集 到 GAC 的 同时 ， 把 一 个 *.config 文 件 的 二 进 制 版 本 也 安装 到 GAC。 这 样 做 的 好 处 是 客户 端 应 用 程 
序 目录 不 需要 包含 任何 *.config 文 件 。CLR 会 读 取 当 前 客户 端 程序 的 清单 , 尝试 在 GAC 中 查找 被 请 求 的 
版 本 。 但 如 果 CLR 找 到 一 个 发 行者 策略 程序 集 , 它 会 读 取 其 中 峙 入 的 XML 数据 , 在 GAC 级 别 执行 请 求 
重 定向 。 

我 们 使 用 .NET 的 al.exe 工 具 在 命令 行 创建 发 行者 策略 程序 集 。 尽 管 该 工具 拥有 众多 选项 ， 但 创建 

一 个 发 行者 策略 程序 集 只 需要 使 用 到 以 下 几 个 参数 。 

口 含有 重 定向 指令 的 *.config 或 者 *.xml 文 件 的 位 置 。 

口 生成 的 发 行者 策略 程序 集 的 名 称 。 

口 用 于 对 发 行者 策略 程序 集 签名 的 *.snk 文 件 的 位 置 。 

口 创建 的 发 行者 策略 程序 集 的 版 本 号 。 

以 下 命令 集 用 于 创建 控制 CarLibrary.dll 的 发 行者 策略 程序 集 ( 这 必须 在 命令 行 窗 口 的 单独 一 行内 
输入 ): 


al /link: CarLibraryPolicy.xml /out:policy.1.0.CarLibrary.d]1 
/keyf:C:\MyKey\myKey.snk /v:1.0.0.0 


这 里 ，XML 内 容 被 包含 在 CarLibraryPolicy.xml 文 件 中 。 命 令 输出 的 文件 名 ( 格式 必须 为 : policy. 
<major>.<minor>.assemblyToConfigure ) 由 /out 标 志 指 定 。 另 外 包含 公 钥 / 私 钥 对 的 文件 名 由 /keyf 选 项 
指定 ( 记 住 ， 因 为 发 行者 策略 文件 是 共享 的 ， 因 此 它 必须 具有 强 名 称 )。 

命令 执行 完 以 后 ， 一 个 新 的 程序 集 可 以 被 安装 到 GAC 中 ， 它 将 强制 要 求 所 有 客户 端 程序 绑 定 到 
CarLibrary.dll 的 2.0.0.0 版 本 ， 而 不 需要 使 用 特定 的 客户 应 用 程序 配置 文件 。 由 此 可 以 通过 已 有 程序 集 
的 给 定 版 本 (或 版 本 范围 ) 为 所 有 应 用 程序 设计 “机 器 级 别 ” 的 重 定向 。 
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禁止 发 行者 策略 


现在 ， 假 定 你 (作为 系统 管理 员 ) 需要 部 署 一 个 发 行者 策略 程序 集 ( 和 最 新 版 本 的 相关 程序 集 ) 
到 一 台 客 户 端 机 器 上 。 如 果 比 较 幸 运 的 话 ，90% 的 受 影响 的 客户 端 应 用 程序 会 正确 地 重 绑 定 到 2.0.0.0 
版 本 。 先 不 管 原因 ， 假 定 剩 下 的 10% 的 客户 端 应 用 程序 在 使 用 CarLibrary.dll 2.0.0.0 版 本 时 发 生 了 错误 
(我 们 知道 ， 向 后 兼容 的 软件 并 不 是 总 能 100% 地 正常 工作 )。 

在 这 种 情况 下 ， 针 对 每 个 有 问题 的 客户 端 应 用 程序 创建 一 个 配置 文件 ,通过 该 文件 通知 CLR 忽 略 
安装 在 GAC 上 的 发 行者 策略 程序 集 。 那些 其 余 的 能 够 正常 工作 的 客户 端 程序 则 接受 发 行者 策略 程序 集 
指定 的 重 定 向 ， 它 们 使 用 最 新 版 本 的 程序 集 。 为 了 逐个 客户 端 程序 地 禁止 发 行者 策略 ， 我 们 需要 创建 
一 个 使 用 <publisherpPolicy> 元 素 的 *.config 文 件 ， 同 时 把 该 元 素 的 apply 特 性 设置 为 no。 现 在 ，CLR 将 
会 加 载 客户 端 程序 清单 中 原来 指定 的 程序 集 版 本 。 


<configuration> 
<runtime> 
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 
<publisherPolicy apply="no" /> 
</assemblyBinding> 
</runtime> 
</configuration> 


14.10 ”<codeBase> 元 素 


应 用 程序 配置 文件 也 可 以 指定 代码 库 。<codeBase> 元 素 用 于 指示 CLR 探 测 位 于 任意 位 置 ( 例如 网 
络 终点 ， 或 者 客户 端 应 用 程序 目录 以 外 的 本 地 目录 ) 的 依赖 程序 集 。 

当 <codeBasey> 元 素 的 值 指向 远程 计算 机 的 时 候 ， 相 关 程序 集 将 会 按 需 下 载 到 GAC 的 下 载 缓存 中 。 
由 于 GAC 对 部 署 其 中 程序 集 的 要 求 ， 所 以 那些 通过 <codeBase> 元 素 加 载 的 程序 集 应 该 具有 强 名 称 ( 否 
则 ，CLR 无 法 把 远程 程序 集 加 载 到 GAC ) 。 我 们 可 以 使 用 gacutil.exe 结 合 /idl 选 项 查看 下 载 缓存 中 的 内 
容 。 如 下 所 示 : 

gacutil /ldl 


说 明 实际 上 , 《codeBase> 元 素 可 以 用 于 探测 不 具有 强 名 称 的 程序 集 。 但 是 ， 该 程序 集 的 位 置 必 须 是 
相对 于 客户 端 应 用 程序 目录 的 (这 一 点 与 <privatePath> 元 素 有 点 儿 不 同 ) 。 


为 了 研究 运行 时 的 <codeBase>， 创 建 控制 台 应 用 程序 CodeBaseClient， 添 加 对 CarLibrary.dl1 2.0.0.0 
版 本 的 引用 ， 然 后 改写 生成 的 代码 ， 如 下 所 示 : 


using Systemj 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 


using CarlLibrary; 
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namespace CodeBaseClient 
class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with CodeBases *****"); 
SportsCar ¢ = new SportsCar(); 
Console.WritelLine("Sports car has been allocated."); 
Console.ReadLine(); 


} 
} 


由 于 CarLibrary.dll 被 部 署 在 GAC 中 ， 所 以 客户 端 程序 可 以 正常 运行 。 然 而 ,为 了 说 明 <codeBase> 
元 素 ， 我 们 在 C 盘 下 创建 一 个 新 的 文件 夹 ( C:IMyAsms )， 然 后 把 CarLibrary.dll 的 2.0.0.0 版 本 复制 到 该 
目录 下 。 

向 CodeBaseClient 项 目前 面 已 介绍 过 添加 App.config 文 件 (或 编辑 已 有 的 App.Config ) ， 然 后 编写 
以 下 XML 内 容 ( 记 住 .publickeytoken 的 值 会 和 读者 的 有 所 不 同 ， 请 到 GAC 中 查看 ): 


<configuration> 


<runtime> 
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 
<dependentAssembly> 
<assemblyIdentity name=" CarLibrary" publicKeyToken="33A2BC294331E8B9"” /> 
<codeBase version="2.0.0.0" href="file:///C:/MyAsms/CarLibrary.dll" /> 
</dependentAssembly> 
</assemblyBinding> 
</runtime> 
</configuration> 


可 以 看 到 ,<codeBase> 元 素 内 艇 在 <assemb1yIdentity> 元 素 中 。<assemblyIdentity> 元 素 使 用 name 
特性 和 publickeyToken 特 性 来 指定 友好 名 称 和 对 应 的 publicKkeyToken 的 值 。<codeBase> 元 素 则 指定 需 
要 加 载 的 程序 集 的 版 本 和 位 置 ( 通过 href 属 性 ) 。 现 在 ， 如 果 只 把 GAC 中 的 CarLibrary.dll 的 2.0.0.0 版 
本 删除 ， 则 客户 端 程序 仍然 可 以 正常 运行 ， 因 为 CLR 在 C:\MyAsms 下 能 够 找到 被 请 求 的 程序 集 。 


说 明 ”如果 在 开发 机 器 上 随意 放置 程序 集 ， 则 等 同 于 为 自己 重新 创建 了 一 个 系统 注册 表 ( 这 将 会 带 
来 非常 闻名 的 “DLL 地 狱 ”) 。 因 为 一 旦 移动 或 重 命名 程序 集 所 在 目录 ， 相 关 应 用 程序 将 运行 
失败 。 因 此 ， 请 谨慎 使 用 <codeBase>。 





<codeBase> 元 素 能 够 引用 位 于 远程 网 络 计 算 机 上 的 程序 集 。 假 设 你 拥有 足够 的 权限 访问 
http:/www.MySite.com。 为 了 把 远程 的 *.dll 下 载 到 本 地 机 器 上 的 GAC 下 载 缓存 区 ， 可 以 对 <codeBasey> 
元 素 做 如 下 修改 : 


《codeBase version="2.0.0.0" 
href="http://www.MySite.com/Assemblies/CarLibrary.d11”/> 


源 代码 ”CodeBaseClient 应 用 程序 的 源 代码 位 于 Chapter 14 子 目录 下 。 
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14.11 System.Configuration 命名 空间 


到 目前 为 止 ， 本章 中 所 有 的 *.config 文 件 都 使 用 了 多 个 常用 的 XML 元 素 。CLR 能 够 读 取 这 些 元 素 
来 解析 外 部 程序 集 的 位 置 。 除 了 这 些 元 素 之 外 ， 在 客户 端 配 置 文件 中 ， 我们 还 能 够 增加 基于 具体 应 用 
程序 的 自 定义 信息 。 为 此 ，.NET Framework 提 供 了 一 个 命名 空间 ， 这 使 得 我 们 可 以 以 编程 方式 读 取 配 
置 文件 的 这 些 数据 。 

System.Configuration 命 名 空间 提供 了 一 组 类 型 供 开 发 人 员 读 取 *.config 文 件 的 自 定 义 数 据 。 这 些 
自 定义 的 配置 信息 必须 放 在 cappSettings> 元 素 里 。<appSettings> 元 素 可 包含 任意 多 个 cadd> 元 素 ( 用 
于 定义 键 / 值 对 ) 供 开 发 人 员 以 编程 方式 获取 。 

例如 ,假定 控制 台 应 用 程序 AppConfigReaderApp 拥 有 一 个 App.config 文 件 ， 其 中 定义 了 两 个 应 用 
程序 特定 的 值 : 


<?xml version="1.0”encoding="utf-8”?> 
<configuration> 
<startup> 
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" /> 
</startup> 


<!-- 自 定义 应 用 设置 --> 
<appSettings> 
<add key="TextColor" value="Green" /> 
《<add key="RepeatCount" value="8" /> 
</appSettings> 
</configuration> 


客户 端 应 用 程序 只 需要 调用 System.Configuration.AppSettingsReader 类 的 实例 方法 GetValue()， 
就 可 以 读 取 这 些 信息 。 在 下 面 的 代码 中 可 以 看 到 ，GetValue() 方 法 的 第 一 个 参数 是 *.config 文 件 中 键 的 
名 称 ， 第 二 个 参数 则 是 该 键 的 类 型 ( 使 用 C# 的 typeof 操 作 符 获 取 ): 


using Systemj 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

Using System.Threading.Text; 


using System.Configuration; 
namespace AppConfigReaderApp 
class Program 
static void Main(string[] args) 
Console.WriteLine("***** Reading <appSettings> Data *****\n"); 
// 从 *.config 文 件 获取 自 定义 数据 
AppSettingsReader ar = new AppSettingsReader(); 
int numbOfTimes = (int)ar.GetValue("RepeatCount", typeof(int)); 
string textColor = (string)ar.GetValue("TextColor", typeof(string)); 


Console.ForegroundColor = 
(ConsoleColor)Enum.Parse(typeof(ConsoleColor), textColor); 
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// 现在 正确 输出 消息 
for (int i = 0; i < numbOfTimes; i++) 
Console.WriteLine("Howdy!"); 
Console.ReadLine(); 


源 代码 AppConfigReaderApp 应 用 程序 的 源 代码 位 于 Chapter 14 子 目录 下 。 
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本 章 介 绍 了 XML 配 置 文 件 的 作用 。 在 这 里 ， 我 们 来 看 看 可 以 向 <runtime> 元 素 添加 一 些 设置 ， 控 
制 CLR 如 何 定位 到 外 部 所 需 的 库 。 在 阅读 本 书后 面 章节 ( 以 及 阅读 完毕 开始 构建 大 规模 软件 ) 的 时 候 ， 
你 很 快 会 发 现 使 用 XML 配置 文件 是 家 常 便 饭 。 

没 错 ，.NET 平 台 在 很 多 API 中 都 使 用 了 *.config 文 件 。 例 如 在 第 25 章 ， 你 将 看 到 WCF ( Windows 
Communication Foundation ) 使 用 了 配置 文件 来 建立 复杂 的 网 络 设置 。 在 本 书后 面 介绍 ASPNET Web 
开发 时 ， 你 很 快 会 注意 到 web.config 文 件 与 桌面 App.config 文 件 含有 相同 类 型 的 指令 。 

由 于 给 定 的 .NET 配 置 文件 可 以 包含 很 多 指令 ， 你 应 该 意识 到 在 .NET 帮 助 系统 里 ， 可 以 找到 整个 
XML 文件 的 架构 。 如 果 在 帮助 系统 中 搜索 “Configuration File Schema for the .NET Framework”， 将 找 
到 每 个 元 素 的 详细 解释 ( 如 图 14-25 所 示 )。 
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图 14-25 XML 配置 文件 完全 位 于 .NET 帮 助 系统 中 
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14.13 小结 


本 章 介 绍 了 .NET 类 库 ( 即 .NET *.dll ) 的 作用 。 如 你 所 见 ， 类 库 是 包含 可 在 多 个 项 目 中 复 用 的 逻 
辑 的 .NET 二 进 制 文件 。 库 的 部 署 有 两 种 主要 的 方式 : 私有 的 或 共享 的 。 私 有 程序 集 部 署 到 客户 端 文件 
夹 或 子 目 录 ， 只 要 有 适当 的 XML 配置 文件 。 共 享 程序 集 是 机 器 中 的 所 有 应 用 程序 都 能 使 用 的 库 ,， 它 同 
样 也 受 客 户 端 配置 文件 设置 的 影响 。 

我 们 学 习 了 如 何 将 共享 程序 集 标 记 为 “ 强 名 称 ”， 从 CLR 的 角度 看 ， 它 实际 上 是 建立 了 一 个 唯一 
标识 的 库 。 同 样 ， 我 们 还 学 习 了 不 同 的 命令 行 工 具 ( 如 sn.exe 和 gacutil.exe )， 用 于 共享 库 的 开发 和 
部 署 。 

本 章 最 后 介绍 了 发 布 者 策略 以 及 实用 System.Configuration 命 名 空间 存储 和 获取 自 定义 配置 的 
过 程 。 
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览 器 (和 其 他 IDE ), 可 以 查看 项 目 所 引用 程序 集 的 类 型 。 此 外 ,对 于 一 个 .NET 二 进 制 文件 ， 
使 用 外 部 工具 ( 如 ildasm.exe ) 可 以 查看 底层 的 CIL 代 码 、 类 型 元 数据 和 程序 集 清 单 。 除 了 在 设计 时 
对 .NET 程 序 集 进 行 研究 外 , 也 可 以 使 用 System.Reflection 命 名 空间 通过 编程 获取 相同 的 信息 。 本 章 的 
第 一 个 任务 就 是 明确 反射 的 作用 以 及 理解 .NET 元 数据 的 必要 性 。 

本 章 的 剩余 部 分 讨论 了 许多 与 反射 服务 密切 相关 的 主题 。 举 例 来 说 , 我 们 将 学 习 .NET 客 户 端 如 何 
使 用 动态 加 载 和 晚期 绑 定 来 激活 在 编译 时 未 知 的 类 型 。 我 们 也 将 学 习 如 何 使 用 系统 提供 的 或 自 定义 的 
特性 来 将 自 定义 元 数据 插入 到 .NET 程 序 集中 。 在 讲述 了 所 有 这 些 ( 表面 深奥 的 ) 主题 之 后 ,本章 将 以 
如 何 建立 “插件 对 象 ” 结 束 ， 读 者 可 以 将 它们 插入 到 一 个 可 扩展 的 桌面 GUI 应 用 程序 中 。 


15.1 类 型 元 数据 的 必要 性 


使 用 元 数据 完整 地 描述 类 型 (类 、 接 口 、 结 构 、 枚 举 和 委托 ) 的 能 力 是 .NET 平 台 的 一 个 关键 要 素 。 
许多 .NET 技 术 ， 如 WCF 和 对 象 序列 化 都 需要 这 个 能 力 在 运行 时 发 现 类 型 格式 。 男 外 ， 跨 语言 互 操 作 、 
编译 器 服务 以 及 集成 开发 环境 的 智能 感知 能 力 都 依赖 于 对 类 型 的 具体 描述 。 

回想 一 下 ，ildasm.exe 工 具 可 以 使 用 CtrI+M 组 合 键 选项 查看 一 个 数据 集 的 类 型 元 数据 ( 见 第 1 章 )。 
因此 ， 如 果 使 用 ildasm.exe 并 按 Ctrl+M 组 合 键 打开 本 书 中 建立 的 任意 的 *.dl] 或 *.exe 程 序 集 ( 比如 第 14 
章 创 建 的 CarLibrary.dll )， 都 将 发 现 有 关 的 类 型 元 数据 ( 如 图 15-1 所 示 )。 

可 以 看 到 ，ildasm.exe 中 显示 的 .NET 类 型 元 数据 非常 详细 (实际 上 二 进 制 格式 更 紧凑 )。 事 实 上 ， 
如 果 列 出 CarLibrary.dll 程 序 集 的 全 部 元 数据 描述 , 需要 用 好 几 页 。 这 太 浪 费时 间 ( 也 费 纸 )， 所 以 我 们 
只 看 看 CarLibrary.dll 程 序 集中 的 主要 元 数据 描述 。 


说 明 不 必 太 在 意 接 下 来 的 几 节 中 出 现 的 .NET 元 数据 的 确切 语法 。 重 点 是 .NET 元 数据 非常 具有 描述 
性 ， 它 列 出 了 给 定 代 码 库 中 每 个 定义 的 内 部 类 型 ( 和 引用 的 外 部 类 型 )。 
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wa 
Fin 


ScopeName : CarLibrary .dil 
MUID : {2F2D3D6C-288B9-547A2-A2FA-1261241937C1> 


下 二 


sGlobal functions 
[Si 





| ypeDef #1 {82888882) 


TypDefName: CarLibrary-EngineState {82868862) 
Flags : FPublic] fAutoLayout] [tiass] [Sealed] [hnsiClass] (68866 
Extends : B18808861 [TypeRef] Systenm.Enum 
Field #1 (846808901) 
Field Name: valye 


和 





图 15-1 使 用 ildasm.exe 查 看 程序 集 元 数据 


15.1.1 查看 (部 分 ) EngineState 枚 举 的 元 数据 


在 当前 程序 集中 定义 的 每 个 类 型 都 使 用 一 个 TypeDef #n 标 记 ( 这 里 ，TypeDef 是 type definition 的 缩 
写 )。 如 果 使 用 一 个 独立 的 .NET 程 序 集 定义 的 类 型 来 描述 类 型 ， 被 引用 的 类 型 将 使 用 TypeRef #n 标 记 。 
TypeRef ( type reference 的 缩写 ) 标记 是 一 个 指针 , 它 指向 外 部 程序 集中 被 引用 类 型 的 全 部 元 数据 定义 。 
简 言 之 ，.NET 元 数据 是 一 组 清晰 地 标记 了 所 有 的 类 型 定义 (TypeDefs ) 和 被 引用 类 型 ( TypeRefs ) 的 
表 ， 所 有 这 些 都 可 以 使 用 ildasm.exe 元 数据 窗口 查看 到 。 

在 CarLibrary.dll 中 ， 我 们 遇 到 的 一 个 TypeDef 是 对 CarLibrary.Enginestate 枚 举 的 元 数据 描述 ( 读 
者 的 编号 可 能 不 同 ，TypeDef 编 号 是 按照 C# 编 译 器 处 理 文件 的 顺序 进行 的 ): 


TypeDef #2 (02000003) 
TypDefName: CarLibrary.EngineState (02000003) 
Flags : [Public] [AutoLayout] [Class] [Sealed] [AnsiClass] (00000101) 
Extends  : 01000001 [TypeRef] System.Enum 
Field #1 (04000006) 
Field Name: value (04000006) 
Flags : [Public] [SpecialName] [RTSpecialName] (00000606) 
CallCnvntn: [FIELD] 
Field type: I4 


Field #2 (04000007) 


Field Name: engineAlive (04000007) 
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Flags : [Public] [Static] [Literal] [HasDefault] (00008056) 
DefltValue: (I4) 0 

CallCnvntn: [FIELD] 

Field type: ValueClass CarLibrary.EngineState 


这 里 ，TypDefName 标 记 用 来 建立 给 定 类 型 的 名 称 ， 这 里 是 自 定义 的 CarLibrary.Engine 枚 举 。 而 
Extends 元 数据 标记 用 来 记录 给 定 .NET 类 型 的 基 类 型 ( 在 本 例 中 ， 就 是 被 引用 的 类 型 System.Enum )。 每 
个 枚 举 中 的 字段 使 用 Field 和 扣 来 标记 。 为 简洁 起 见 ， 我 只 是 列 出 了 CarLibrary.EngineState. 
engineAlive 的 元 数据 。 


15.1.2 ”查看 〈 部 分 ) Car 类 型 的 元 数据 


这 里 是 Car 类 的 部 分 转 储 信息 ， 它 阐释 了 以 下 几 点 。 
口 如 何 用 .NET 元 数据 定义 字段 。 

口 如 何 通过 .NET 元 数据 说 明 方 法 。 

口 如 何在 .NET 元 数据 中 表示 一 个 自动 属性 。 


TypeDef #3 (02000004) 
TypDefName: CarLibrary.Car (02000004) 
Flags : [Public] [AutoLayout] [Class] [Abstract] 
[AnsiClass] [BeforeFieldInit] (00100081) 
Extends : 01000002 [TypeRef] System.0bject 


Field #2 (0400000a) 

Field Name: <PetName>k BackingField (0400000A) 
Flags : [Private] (00000001) 

CallCnvntn: [FIELD] 

Field type: String 


Method #1 (06000001) 
MethodName: get PetName (06000001) 
Flags : [Public] [HideBySig] [ReuseSlot] [SpecialName] (00000886) 
RVA : Ox000020d0 
ImplFlags : [IL] [Managed] (00000000) 
CallCnvntn: [DEFAULT] 
hasThis 
ReturnType: String 
No arguments. 





Method #2 (06000002) 

MethodName: set PetName (06000002) 

Flags : [Public] [HideBySig] [ReuseSlot] [SpecialName] (00000886) 
RVA : Ox000020e7 

ImplFlags : [IL] [Managed] (00000000) 

CallCnvntn: [DEFAULT] 
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hasThis 
ReturnType: Void 
1 Arguments 
Argument #1: String 
1 Parameters 
(1) ParamToken : (08000001) Name : value flags: [none] (00000000) 


Property #1 (17000001) 


Prop.Name : PetName (17000001) 


Flags : [none] (00000000) 
CallCnvntn: [PROPERTY] 
hasThis 


ReturnType: String 
No arguments. 


DefltValue: 

Setter : (06000002) set PetName 
Getter : (06000001) get PetName 
0 Others 


首先 ， 注意 Car 类 元 数据 标记 了 类 型 的 基 类 ( System.0bject ), 并 且 包 括 了 描述 该 类 型 如 何 被 构造 
的 多 个 标记 ( 比如 [Public] 、[Abstract] 等 )。 而 方法 ( 比如 car 的 构造 函数 ) 描述 了 它 的 参数 、 返 回 
值 和 名 称 。 

注意 ， 在 本 例 中 ， 自 动 属 性 如 何 使 编译 器 生成 了 一 个 私有 的 支持 字段 ( 名 为 <PetName>k_Backing- 
Field ) 和 两 个 方法 ( 如 果 是 读 / 写 属性 的 话 ) get_PetName() 和 set_pPetName()。 最 后 , 注意 如 何 使 用 .NET 
元 数据 的 Setter/Getter 标 记 将 属性 映射 到 它们 内 部 的 获取 方法 /设置 方法 上 。 


15.1.3 ”研究 TypeRef 
前 面 已 经 说 到 ， 程 序 集 的 元 数据 不 仅 可 以 描述 一 组 内 部 类 型 ( 比如 Car 、Enginestate 等 )， 而 且 也 
可 以 描述 任何 一 个 被 内 部 类 型 引用 的 外 部 类 型 。 举 例 来 说 ，CarLibrary.dll 定 义 了 两 个 枚 举 ， 可 以 找到 


System.Enum 类 型 的 TypeRef 块 ， 如 下 所 示 : 
TypeRef #1 (01000001) 


Token: Ox01000001 
ResolutionScope: 0x23000001 
TypeRefName: System.Enum 


15.1.4 记录 定义 的 程序 集 


ildasm.exe 元 数据 窗口 中 可 以 看 到 使 用 Assembly 标 记 描 述 程序 集 自身 的 .NET 元 数据 ,如 下 面 ( 部 分 ) 
列表 中 所 示 , 在 Assembly 表 中 记录 的 信息 与 通过 MANIFEST 图 标 看 到 的 信息 是 相同 的 ( 太 令 人 惊讶 了 )。 
这 里 是 CarLibrary.dll 清 单 中 的 部 分 转 储 信息 ( 版 本 2.0.0.0 ): 

Assembly 


Token: 0x20000001 
Name : CarLibrary 
Public Key : 00 24 00 00 04 80 00 00 // 等 等 


15.1 类 型 元 数据 的 必要 性 453 


Hash Algorithm : Ox00008004 
Major Version: Ox00000002 
Minor Version: Ox00000000 
Build Number: Ox00000000 
Revision Number: Ox00000000 
Locale: <null> 

Flags : [Publickey] ... 


15.1.5 记录 引用 的 程序 集 


除了 Assembly 标 记 、TypeDef 和 TypeRef 块 组 外 ，.NET 元 数据 也 使 用 AssemblyRef #n 标 记 来 记录 每 个 
外 部 的 程序 集 。 由 于 CarLibrary.dll 使 用 了 System.Windows.Forms.MessageBox 类 ， 所 以 可 以 找到 
System.Windows .Forms 的 AssemblyRef， 例 如 : 

AssemblyRef #2 (23000002) 


Token: 0x23000002 

Public Key or Token: b7 7a 5c 56 19 34 e0 89 
Name: System.Windows.Forms 
Version: 4.0.0.0 

Major Version: Ox00000004 
Minor Version: Ox00000000 
Build Number: Ox00000000 
Revision Number: Ox00000000 
Locale: <null> 

HashValue Blob: 

Flags: [none] (00000000) 


15.1.6 ”记录 字符 串 字 面 量 


关于 .NET 元 数据 ， 最 后 要 提 的 一 点 是 ， 事实 上 代码 中 的 每 个 字符 串 字面 量 都 记录 在 User Strings 
标记 下 ， 例 如 : 


User Strings 


70000001 : (11) L"Jamming {0}" 

70000019 : (13) L"Quiet time..." 

70000035 : (23) L"CarLibrary Version 2.0!" 
70000065 : (14) L"Ramming speed!" 

70000083 : (19) L"Faster is better..." 
700000ab : (16) L"Time to call AAA" 
700000cd : (16) L"Your car is dead" 


说 明 如 这 段 元 数据 代码 所 示 ， 要 始终 注意 所 有 的 字符 串 都 清晰 地 记录 在 程序 集 元 数据 中 。 如 果 使 
用 字符 串 字 面 量 来 获取 密码 、 信 用 卡号 或 其 他 敏感 信息 ， 将 带 来 很 大 的 安全 问题 。 

下 一 个 关注 的 问题 可 能 是 ( 最 好 的 情形 ) “我 如 何 能 在 我 的 应 用 程序 中 使 用 这 些 信 息 ”, 或 者 是 ( 最 
差 的 情形 ) "为 什么 我 需要 关注 元 数据 "。 为 了 回答 这 些 问题 ,我 们 需要 介绍 一 下 .NET 反 射 服务 。 虽 然 
接 下 来 ( 直到 本 章 最 后 ) 的 内 容 或 诈 有 些 令 人 头痛 ， 但 是 它们 真 的 非常 有 用 ， 所 以 请 跟 紧 些 。 
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说 明 ”你 也 会 在 MetaInfo 窗 口 的 显示 中 发 现 许多 CustomAttribute 标 记 , 它 记 录 了 特性 在 代码 库 中 的 应 
用 。 在 本 章 稍 后 会 学 习 .NET 特 性 的 作用 。 





15.2 反射 


在 .NET 中 ,反射 (reflection ) 是 一 个 运行 库 类 型 发 现 的 过 程 。 使 用 反射 服务 ， 可 以 通过 编程 使 用 
一 个 友好 的 对 象 模 型 得 到 与 通过 ildasm.exe 显 示 的 相同 的 元 数据 信息 。 举 例 来 说 , 通过 反射 ,可 以 得 到 
一 个 给 定 *.dll 或 *.exe 程 序 集 所 包含 的 所 有 类 型 的 列表 ， 这 个 列表 包括 给 定 类 型 定义 的 方法 、 字 段 、 属 
性 和 事件 。 也 可 以 动态 发 现 一 组 给 定 类 型 支持 的 接口 、 方 法 的 参数 和 其 他 相关 细节 ( 基 类 、 命名 空间 、 
清单 数据 等 )。 

与 其 他 命名 空间 一 样 ，System.Reflection ( 定义 在 mscorlib.dll ) 包含 了 大 量 相关 类 型 。 表 15-1 列 
出 了 常用 的 一 些 核心 类 型 。 

表 15-1 System.Reflection 命 名 空间 成 员 示例 

类 型 作 用 

Assembly 该 抽象 类 包含 了 许多 静态 方法 ， 通 过 它 可 以 加 载 、 了 解 和 操纵 一 个 程序 集 

AssemblyName 使 用 该 类 可 以 找到 大 量 隐藏 在 程序 集 的 身份 中 的 细节 ( 版 本 信息 、 区 域 信息 等 ) 

EventInfo 该 抽象 类 保存 给 定 事件 的 信息 





FieldInfo 该 抽象 类 保存 给 定 字段 的 信息 

MemberInfo 该 类 是 抽象 基 类 , 它 为 EventInfo、FieldInfo、MethodInfo 和 PropertyInfo 类 型 定义 了 公共 的 行为 
MethodInfo 该 抽象 类 包含 给 定 方法 的 信息 

Module 该 抽象 类 使 你 可 以 访问 多 文件 程序 集中 的 给 定 模块 


ParameterInfo 该 类 保存 给 定 参 数 的 信息 
PropertyInfo 该 抽象 类 保存 给 定 属性 的 信息 


要 理解 如 何 使 用 System.Reflection 命 名 空间 编程 读 取 .NET 元 数据 ， 首 先 需 要 理解 system.Type 类 。 


15.2.1 System.Type 类 


System.Type 类 定义 了 很 多 成 员 ， 可 以 用 来 检查 某 个 类 型 的 元 数据 ， 它 们 返回 的 类 型 大 多 位 于 
System.Reflection 命 名 空间 中 。 举 例 来 说 ，Type.GetMethods() 返 回 一 个 MethodInfo 类 型 的 数组 ， 
Type.GetFields() 返 回 一 个 FieldInfo 类 型 的 数组 等 。System.Type 提 供 的 完整 的 成 员 组 是 很 容易 扩展 
的 ， 表 15-2 提 供 了 部 分 由 System.Type 支 持 的 成 员 ( 详 见 .NET Framework 4.5 SDK 文 档 )。 
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表 15-2 System.Type 的 部 分 成 员 
类 型 作 用 
IsAbstract、IsArray、IsClass、IsCOMObject、IsEnum、 这 些 属性 (还 有 其 他 的 ) 允许 我 们 发 现 许多 所 引用 类 型 的 基 
IsGenericTypeDefinition、 IsGenericParameter、 本 特性 ( 比如 ， 它 是 否 是 抽象 方法 、 数 组 、 概 套 类 等 ) 
IsIinterface、 IsPprimitive、 IsNestedprivate、 
IsNestedPublic、 IsSealed、 IsValueType 





GetConstructors()、 GetEvents()、 GetFields().、 这 些 方法 (还 有 其 他 的 ) 允许 我 们 得 到 表示 感 兴趣 项 目 ( 接 
GetInterfaces() 、GetMembers() 、GetMethods()、 口 、 方 法 、 属 性 等 ) 的 数组 ,每 个 方法 返回 一 个 相关 数组 ( 举 
GetNestedTypes()、GetProperties() 例 来 说 ，GetFields() 返 回 一 个 FieldInfo 数 组 ，GetMethods() 


返回 一 个 MethodInfo 数 组 等 )。 要 知道 每 个 方法 都 有 单数 的 版 
本 ( 比如 ，GetMethod() 、GetpProperty() 等 )， 可 以 通过 名 称 得 
到 指定 的 项 ， 而 不 是 得 到 有 关 项 的 数组 


FindMembers() 该 方法 根据 查询 条 件 返 回 一 个 MemberInfo 类 型 的 数组 

GetType() 该 静态 方法 返回 一 个 Type 实 例 ， 给 定 一 个 字符 串 名 称 

InvokeMember() 该 方法 允许 对 给 定 项 目的 晚期 绑 定 ,本章 后 面 会 详细 介绍 “ 晚 
期 绑 定 ” 





15.2.2 ”使 用 System.0bject.GetType() 得 到 Type 引用 


可 以 用 多 种 方法 得 到 一 个 Type 类 的 实例 。 但 是 ， 由 于 Type 是 一 个 抽象 类 ， 所 以 不 能 直接 使 用 new 
关键 字 创 建 一 个 Type 对 象 。 对 此 我 们 的 首选 是 : 使 用 System.0bject 定 义 的 GetType() 方 法 , 它 返回 了 一 
个 表示 当前 对 象 元 数据 的 Type 类 的 实例 : 


// 使 用 一 个 SportsCar 实 例 得 到 类 型 信息 
SportsCar sc = new SportsCar(); 
Type t = sc.GetType(); 


显而易见 ， 要 想 使 用 这 个 方法 ， 必 须 得 到 类 型 的 编译 时 信息 ( 这 里 是 SportsCar 类 )， 并 且 当 前 在 
内 存 中 有 类 型 实例 。 由 于 无 法 对 自 定义 的 程序 集 进 行 编译 , 类 似 ildasm.exe 的 工具 并 没有 通过 直接 调用 
System.0bject.GetType() 来 得 到 每 个 类 型 的 类 型 信息 。 


15.2.3 ”使 用 typeof() 得 到 Type 引用 


另 一 个 获取 类 型 信息 的 方法 是 使 用 C# typeof 操 作 符 ， 如 下 所 示 : 


// 使 用 typeof 得 到 类 型 
Type t = typeof(SportsCar); 


类 似 System.0bject.GetType(), 使 用 typeof 操 作 符 , 我 们 不 需要 先 建立 一 个 实例 来 提取 类 型 信息 。 
但 是 ,仍然 需要 知道 类 型 的 编译 时 信息 ， 因 为 typeof 需 要 的 是 类 型 的 强 类 型 名 称 ， 而 不 是 文本 表示 。 


15.2.4 ”使 用 System.Type.GetType() 得 到 Type 引用 


为 了 以 更 灵活 的 方式 得 到 类 型 信息 ， 我 们 可 以 调用 System.Type 类 的 静态 成 员 GetType() ， 然 后 指 
定 类 型 的 完全 限定 名 。 采 用 这 种 方法 ， 我 们 不 需要 得 到 正 从 中 提取 元 数据 的 类 型 的 编译 时 信息 ， 假 如 
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Type.GetType() 取 无 所 不 在 的 System.Sstring 的 实例 。 





说 明 ”我 说 的 “对 于 调用 Type.GetType() ， 我 们 不 需要 编译 时 的 知识 ”是 指 这 个 方法 可 以 接受 任何 字 
符 串 值 ( 而 不 是 强 类 型 的 变量 )。 当 然 ， 我 们 仍然 需要 知道 类 型 名 字 的 字符 串 形式 ! 


Type.GetType() 方 法 被 重 载 ， 人 允许 我 们 指定 两 个 布尔 类 型 的 参数 ， 一 个 用 来 控制 当 类 型 找 不 到 时 
是 否 抛 出 异常 ， 另 一 个 用 来 指示 是 否 区 分 字符 串 大 小 写 。 举 例 来 说 ， 考 虑 下 面 的 情况 : 


// 使 用 静态 的 Type.GetType() 方 法 获取 类 型 信息 (如 果 SportsCar 没 有 找到 ， 则 忽略 不 抛 出 异常 信息 ) 
Type t = Type.GetType("Carlibrary.SportsCar", false, true); 


在 上 面 的 例子 中 ， 注 意 传 人 GetType() 的 字符 串 没有 包含 类 型 所 在 的 程序 集 信 息 。 在 这 种 情况 下 ， 
该 类 型 便 被 认为 是 定义 在 当前 执行 的 程序 集中 的 。 但 是 ， 当 希望 得 到 一 个 外 部 私有 程序 集 的 类 型 元 数 
据 时 ,字符 串 参 数 必须 使 用 类 型 完全 限定 名 , 加 上 类 型 所 在 程序 集 的 友好 名 字 ( 每 一 个 都 用 逗号 隔 开 ): 


// 得 到 外 部 程序 集中 类 型 的 类 型 信息 
Type t = Type.GetType("Carlibrary.SportsCar, CarlLibrary"); 


另外 , 传人 Type.GetType() 的 字符 串 可 以 指定 一 个 + 标记 来 表示 一 个 谋 套 类 型 。 如果 希 望 得 到 一 个 
嵌 套 在 JamesBondCar 类 中 的 枚 举 类 型 ( Spy0ptions ) 的 类 型 信息 ， 可 以 写成 下 面 这 样 : 


// 得 到 当前 程序 集中 号 套 枚 举 的 类 型 信息 
Type t = Type.GetType("CarLibrary.]JamesBondCar+SpyOptions"); 


15.3 ”构建 自 定 义 的 元 数据 查看 器 


为 了 说 明 反 射 的 基本 过 程 (和 System.Type 的 意义 )， 建 立 一 个 名 为 MyTypeViewer 的 控制 台 程 序 。 
这 个 程序 将 显示 mscorlib.dll ( 回想 一 下 ， 所 有 .NET 应 用 程序 都 自动 访问 这 个 核心 框架 类 库 ) 和 
MyTypeViewer 中 类 型 的 方法 、 属 性 、 字 段 和 支持 的 接口 ( 除 一 些 指 针 外 ) 的 细节 。 创 建 好 这 个 应 用 程 
序 后 ， 确 保 其 中 引入 了 System.Reflection 命 名 空间 。 


// 需要 为 反射 导入 泛 命名 空间 
using System.Reflection; 


15.3.1 反射 方法 


修改 Program 类 ， 定 义 一 些 静 态 方法 ,每 个 都 带 有 一 个 System.Type 人 参数 并 返回 void 类 型 。 首 先 ， 编 
写 ListMethods() 方 法 ， 它 (如 读者 猜想 的 那样 ) 能 够 输出 传人 类 型 定义 的 每 个 方法 的 名 称 。 注 意 
Type.GetMethods() 如 何 返 回 一 个 System.Reflection.MethodInfo 类 型 的 数组 ， 它 使 用 标准 的 foreach 循 
环 枚 举 ， 如 下 所 示 : 

// 显示 类 型 的 方法 名 称 

static void ListMethods(Type t) 


Console.WriteLine("***** Methods 半 半 水 冰冰”) ; 

MethodInfo[] mi = t.GetMethods(); 

foreach(MethodInfo m in mi) 
Console.WriteLine("->{0}", m.Name); 
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Console.WriteLine(); 


这 里 ， 只 是 使 用 MethodInfo.Name 属 性 输出 方法 的 名 称 。 如 你 猜测 的 那样 ，MethodInfo 有 许多 其 他 
成 员 可 以 让 你 决定 方法 是 否 是 静态 的 、 虚 拟 的 、 泛 型 的 或 抽象 的 。 此 外 ， 使 用 MethodInfo 类 型 还 能 够 
获取 方法 的 返回 值 和 参数 集 。 过 一 会 儿 我 们 再 来 整理 ListMethods() 的 实现 。 

如 果 愿 意 , 你 可 以 建立 一 个 合适 的 LINQ 查 询 来 枚 举 各 个 方法 的 名 称 。 回忆 第 12 章 , LINQ to Object 
可 以 对 内 存 中 的 对 象 集合 构建 强 类 型 的 查询 。 一 般 而 言 ， 只 要 有 循环 或 条 件 编程 逻辑 ， 就 可 以 使 用 相 
关 的 LINQ 查 询 。 例 如 ， 可 以 像 下 面 这 样 修改 上 面 的 方法 : 

static void ListMethods(Type t) 


Console.WriteLine("***** Methods *****") ; 

var methodNames = from n in t.GetMethods() select n.Name; 

foreach (var name in methodNames) 
Console.WriteLine("->{0}", name); 

Console.WritelLine(); 


15.3.2 ”反射 字段 和 属性 


ListFields() 的 实现 和 ListMethods() 非 常 相似 ， 不 过 值得 注意 的 不 同 是 : ListFields() 调 用 了 
Type.GetFields() 并 且 它 的 返回 值 是 FieldInfo 数 组 。 此 外 , 为 了 简明 , 我 们 使 用 LINQ 查 询 只 输出 了 每 
个 字段 的 名 称 。 

// 显示 类 型 的 字段 名 

static void ListFields(Type t) 


Console.WriteLine("***** Fie]ds *****") ; 

var fieldNames = from f in t.GetFields() select f.Name; 

foreach (var name in fieldNames) 
Console.WritelLine("->{0}", name); 

Console.WritelLine(); 


显示 类 型 属性 的 方法 与 此 类 似 : 
// 显示 类 型 的 属性 名 称 
static void ListProps(Type t) 


Console.Writeline("***** properties ******"); 
var propNames = from p in t.GetProperties() select p.Name; 
foreach (var name in propNames) 
Console.WritelLine("->{0}", name); 
Console.Writeline(); 


15.3.3 反射 实现 的 接口 

接 下 来 ,我们 将 建立 一 个 名 为 ListInterfaces() 的 方法 , 它 将 输出 传人 类 型 支持 的 所 有 接口 名 称 。 
这 里 值得 关注 的 是 : 对 GetInterfaces() 的 调用 返回 一 个 System.Type 类 型 的 数组 ! 这 也 可 以 理解 ,因为 
其 实 接口 也 是 一 种 类 型 . 
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// 显示 实现 的 接口 
static void ListInterfaces(Type t) 


Console.WriteLine("***** Interfaces *****"); 

var ifaces = from i in t.GetInterfaces() select i; 

foreach(Type i in ifaces) 
Console.WritelLine("->{0}", i.Name); 


说 明 注意 ，System.Type 中 的 大 多 数 get 方 法 (GetMethods()、GetInterfaces() 等 ) 都 包含 指定 
BindingFlags 枚 举 值 的 重 载 ， 可 以 对 要 搜索 的 内 容 进 行 较 大 的 控制 ( 如 只 搜索 静态 成 员 或 只 
搜索 公共 成 员 和 私有 成 员 等 )。 详 细 内 容 请 参考 .NET Framework 4.5 SDK 文 档 。 





15.3.4 ”显示 其 他 信息 


最 后 ， 可 以 使 用 一 个 辅助 方法 来 显示 关于 传人 类 型 的 各 种 统计 信息 ( 表示 该 类 型 是 否 是 泛 型 ， 基 
类 是 什么 ， 类 型 是 否 密封 ， 等 等 )。 


// 为 了 更 好 的 检测 
static void ListVariousStats(Type +t) 


Console.WriteLine("***** Various Statistics *****"); 
Console.WriteLine("Base class is: {0}", t.BaseType); 
Console.WritelLine("Is type abstract? {0}", t.IsAbstract); 
Console.Writeline("Is type sealed? {0}", t.IsSealed); 
Console.WritelLine("Is type generic? {0}", t.IsGenericTypeDefinition); 
Console.WriteLine("Is type a class type? {0}", t.IsClass); 
Console.WriteLine(); 


} 


15.3.5 ”实现 Main() 


在 Program 类 中 ,Main() 方 法 提示 用 户 输入 类 型 的 完全 限定 名 。 一 旦 得 到 了 这 个 字符 串 数 据 ， 就 把 
它 传 人 到 Type.GetType() 方 法 中 ， 然 后 把 ( 通过 Type.GetType() ) 得 到 的 System.Type 类 型 再 送 到 每 个 
辅助 方法 中 。 这 个 过 程 可 以 不 断 重复 ， 直 到 键入 “Q” 终 止 程序 : 

static void Main(string[] args) 


Console.WriteLine("***** Welcome to MyTypeViewer ****A*"); 
string typeName = ""; 


do 
{ 


Console.WriteLine("\nEnter a type name to evaluate"); 
Console.Write("or enter Q to quit: "); 


// 得 到 类 型 的 名 称 
typeName = Console.ReadLine(); 


// 询问 用 户 是 否 想 退出 
if (typeName.ToUpper() == "0") 
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break; 


// 测试 显示 类 型 

try 
Type t = Type.GetType(typeName); 
Console.WriteLine(""); 
ListVariousStats(t); 
ListFields(t); 
ListProps(t); 
ListMethods(t); 
ListInterfaces(t); 


} 


catch 


{ 
Console.WriteLine("Sorry, can't find type"); 


} 
} while (true); 


现在 ， 开 始 测试 这 个 MyTypeViewerexe。 举 例 来 说 ， 运 行 应 用 程序 并 输入 下 面 的 完全 限定 名 ( 注 
意 Type.GetType() 要 求 大 小 写 完 全 匹配 字符 串 ): 

口 System.Int32 

DQ System.Collections.ArrayList 

口 System.Threading.Thread 

口 System.Void 

口 System.10.BinaryWriter 

口 System.Math 

DQ System.Console 

口 MyTypeViewer.Program 


例如 ， 下 面 显示 了 当 指 定 System.Math 时 的 部 分 输出 。 





***** Welcome to MyTypeViewer 冰冰 冰冰 六 


Enter a type name to evaluate 
or enter 0 to quit: System.Math 


六 冰冰 水 米 Various Statistics ***** 
Base class is: System.0bject 
Is type abstract? True 

Is type sealed? True 

Is type generic? False 

Is type a class type? True 


六 六 六 六 六 Fields ****A* 


->PI 
->E 


六 六 六 六 来 Properties 米 闵 冰冰 六 


炒米 闵 米 米 Methods 米 米 六 炒米 
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->Acos 
->Asin 
->Atan 
->Atan2 
->Ceiling 
->Ceiling 
->Cos 


RODE I EE RI Te SPE OE PE 2 ee er i te er 


15.3.6 ”反射 泛 型 类 型 


如 果 我 们 调用 Type.GetType() 来 获取 泛 型 类 型 的 元 数据 描述 ， 就 必须 使 用 包含 “ 反 勾 号 ”(` ) 加 
上 数字 值 的 语法 来 表示 类 型 支持 的 类 型 参数 个 数 。 例 如 ， 如 果 我 们 希望 输出 System.Collections. 
Generic.List<T> 元 数据 描述 ， 就 需要 为 我 们 的 应 用 程序 传人 如 下 字符 串 : 

System.Collections.Generic.List 1 

在 这 里 ,我们 使 用 了 数值 1， 这 是 因为 List<T > 只 有 一 个 类 型 参数 。 但 如 果 希 望 反射 DicTinary 
<TKey,TValue>， 就 需要 提供 值 2>， 如 下 所 示 : 


System.Collections.Generic.Dictionary 2 


15.3.7 反射 方法 参数 和 返回 值 


到 目前 为 止 ,一 切 顺 利 ! 接 下 来 对 当前 应 用 程序 做 一 个 小 的 改进 ,我 们 需要 特别 修改 ListMethods() 
辅助 方法 ， 使 其 不 仅 列 出 给 定 方法 的 名 称 ， 而 且 还 列 出 方法 的 返回 类 型 和 输入 参数 类 型 。 为 此 ， 
MethodInfo 类 型 提供 了 ReturnType 属 性 和 GetParameters() 方 法 。 在 下 面 的 代码 中 ， 注 意 ， 我 们 在 用 柑 套 
的 foreach 循 环 构造 一 个 包括 每 个 参数 的 类 型 和 名 称 的 字符 串 类 型 ( 没有 使 用 LINQ ): 


static void ListMethods(Type t) 


Console.WriteLine("***** Methods *****"); 
MethodInfo[] mi = t.GetMethods(); 
foreach (MethodInfo m in mi) 


// 得 到 返回 类 型 
string retVal = m.ReturnType.FullName; 
string paramInfo = "( "; 
// 得 到 参数 
foreach (ParameterInfo pi in m.GetParameters()) 
paramInfo += string.Format("{0} {1} ", pi.ParameterType, pi.Name); 
paramInfo += " )"; 


// 现在 显示 基本 方法 
Console.WriteLine("->{0} {1} {2}", retVal, m.Name, paramInfo); 


Console.WriteLine(); 


如 果 现 在 运行 修改 后 的 程序 , 将 对 给 定 类 型 的 方法 有 更 多 的 了 解 。 如 果 输入 System.0bject,， 将 显 
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示 下 面 的 方法 : 





米 闵 六 冰冰 Methods 米 闵 闵 冰 闵 

->System.String ToString ( ) 

->System.Boolean Equals ( System.Object obj ) 

->System.Boolean Equals ( System.Object objA System.Object objB ) 
->System.Boolean ReferenceEquals ( System.Object objA System.Object objB ) 
->System.Int32 GetHashCode ( ) 

->System.Type GetType ( ) 





ListMethods() 当 前 的 实现 很 有 用 ， 因 为 我 们 可 以 直接 使 用 System.Reflection 对 象 模型 来 调查 每 一 
个 参数 和 方法 的 返回 类 型 ,还 可 以 有 一 个 捷径 ,我 们 知道 每 一 个 XXXInfo 类 型 ( MethodInfo PropertyInfo、 
EventInfo 等 ) 都 重 写 了 ToString() 方 法 来 显示 请 求 项 的 签名 。 因 此 ， 我 们 也 可 以 按 如 下 所 示 实 现 
ListMethods() 方 法 (这 里 再 次 使 用 LINQ， 其 中 只 选择 所 有 的 MethodInfo 方 法 ， 而 不 是 Name 值 ): 


static void ListMethods(Type t) 


Console.WriteLine("***** Methods 六 冰冰 沙 半 ”) ; 

var methodNames = from n in t.GetMethods() select nj; 

foreach (var name in methodNames) 
Console.WriteLine("->{0}", name); 

Console.WritelLine(); 


} 

很 有 意思 吧 ? 很 明显 , System.Reflection 命 名 空间 和 System.Type 类 人 允许 我 们 反射 的 内 容 大 大 超过 
了 MyTypeViewer 当 前 显示 的 。 如 读者 所 希望 的 ， 我 们 可 以 获取 类 型 的 事件 ， 得 到 某 个 成 员 的 泛 型 参数 
列表 以 及 其 他 的 更 多 细节 。 

然而 ， 对 于 当前 创建 的 这 个 (还 有 些 用 的 ) 对 象 浏 览 器 ， 其 主要 的 限制 在 于 ; 仅仅 能 访问 当前 的 
程序 集 ( MyTypeViewer ) 和 总 能 访问 的 mscorlib.dll。 故 此 , 接 下 来 的 问题 是 :“ 如 何 能 使 应 用 程序 加 载 
(并 反射 ) 在 编译 时 并 不 知道 的 程序 集 ? ” 


源 代码 ”MyTypeViewer 项 目的 源 代 码 位 于 Chapter 15 子 目录 下 。 


15.4 动态 加 载 程序 集 


在 第 14 章 中 ， 我 们 学 习 了 CLR 如 何 根据 程序 集 清 单 来 探测 一 个 外 部 引用 的 程序 集 。 虽 然 这 很 好 ， 
但 是 在 很 多 时 候 ， 我 们 需要 在 运行 时 以 编程 的 方式 动态 载 人 程序 集 ， 即 使 那些 程序 集 没 有 记录 在 程序 
清单 中 。 正 式 地 说 ， 这 种 按 需 加 载 外 部 程序 集 的 操作 被 称 为 动态 加 载 。 

System.Reflection 定 义 了 一 个 名 为 Assembly 的 类 。 使 用 这 个 类 ， 我 们 可 以 动态 加 载 程序 集 ， 并 找 
到 关于 程序 集 自身 的 属性 。 而 且 使 用 Assembly 类 型 ， 我 们 还 可 以 动态 加 载 私 有 或 共享 程序 集 ， 还 能 够 
加 载 任意 位 置 的 程序 集 。 从 本 质 上 说 ，Assembly 类 提供 的 方法 (尤其 是 Load() 和 LoadFrom() ) 使 你 可 
以 用 编程 的 方式 提供 和 客户 端 *.config 文 件 中 同样 的 信息 。 

为 了 说 明 动 态 加 载 , 我 们 建立 一 个 魏 新 的 名 为 ExternalAssemblyReflector 的 控制 台 程 序 。 我 们 的 任 
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务 是 构造 一 个 Main() 方 法 ， 它 将 提示 用 户 输入 要 动态 加 载 的 程序 集 友 好 名 称 。 据 此 得 到 的 Assembly 引 
用 将 被 传人 名 为 DisplayTypes() 的 辅助 方法 ， 它 将 只 输出 所 包含 的 每 个 类 、 接 口 、 结 构 、 枚 举 和 委托 
的 名 称 。 实 现代 码 非常 简单 ; 


using Systemj 

using System.Collections .Generic; 
using System.Linq; 

using System.Text; 


using System.Reflection; 
using System.IO; // 为 文件 找 不 到 时 抛 出 异常 (FileNotFoundException) 而 定义 


namespace ExternalAssemblyReflector 
class Program 
static void DisplayTypesInAsm(Assembly asm) 


Console.WriteLine("\n***** Types in Assembly *****"); 
Console.WriteLine("->{0}", asm.FullName); 
Type[] types = asm.GetTypes(); 
foreach (Type t in types) 

Console.WriteLine("Type: {0}", t+); 
Console.WritelLine(""); 


3 
static void Main(string[] args) 


Console.WritelLine("***** External Assembly Viewer *****"); 


mm。 
3) 


string asmName = 
Assembly asm = null; 


do 
{ 


Console.WritelLine("\nEnter an assembly to evaluate"); 
Console.Write("or enter Q to quit: "); 


// 得 到 程序 集 名 称 
asmName = Console.ReadLine(); 


// 用 户 是 否 想 退出 
if (asmName.ToUpper() == "0") 


break; 


} 


// 尝试 加 载 程序 集 
try 


{ 
asm = Assembly.Load(asmName); 
DisplayTypesInAsm(asm); 


* catch 
Console.WritelLine("Sorry, can't find assembly."); 


} 
} while (true); 
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} 
} 
} 


注意 ,静态 Assembly.Load() 方 法 仅仅 传人 了 一 个 要 加 载 到 内 存 的 程序 集 的 友好 名 称 。 因 此 ， 如 果 
希望 反射 CarLibrary.dll， 需 要 把 CarLibrary.dll 二 进 制 文件 复制 到 ExternalAssemblyReflector 应 用 程序 的 
\bin\Debug 目 录 ， 然 后 再 来 运行 这 个 程序 。 之 后 得 到 的 输出 结果 类 似 于 下 面 所 示 : 





洲 冰冰 沙沙 External Assembly Viewer ***** 


Enter an assembly to evaluate 
or enter 0 to quit: CarLibrary 


****** Types in Assembly ***** 

->CarLibrary, Version=2.0.0.0, Culture=neutral, PublicKeyToken=33a2bc294331e8b9 
Type: CarLibrary.MusicMedia 

Type: CarLibrary.EngineState 

Type: CarlLibrary.Car 

Type: CarLibrary.SportsCar 

Type: CarLibrary.MiniVan 





如 果 和 希望 使 ExternalAssemblyReflector 更 灵活 , 可 以 用 Assembly.LoadFrom() 而 不 是 Assembly.Load() 
方法 加 载 外 部 程序 集 ， 如 下 : 
try 


asm = Assembly.LoadFrom(asmName); 
DisplayTypesInAsm(asm); 


这 样 就 可 以 输入 要 查看 的 程序 集 的 绝对 路 径 ( 如 C:\MyApp\IMyAsm.dll )。 实 质 上 ，Assembly. 
LoadFrom() 人 允许 你 以 编程 方式 提供 ccodeBase> 值 。 这 样 修改 之 后 ， 你 可 以 将 一 个 完整 路 径 传递 给 控制 
台 应 用 程序 。 因 此 ， 如 果 CarLibrary.dll 位 于 C:\MyCode 下， 可 以 得 到 如 下 输出 结果 : 





六 阔 冰冰 米 External] Assembly Viewer ***** 


Enter an assembly to evaluate 
or enter Q to quit: C:\MyCode\CarLibrary.d1l 


沙沙 玉米 六 Types in Assembly 冰冰 冰冰 六 
->CarLibrary，Version=2.0.0.0，Culture=neutral，PublickeyToken=33a2bc294331e8b9 
Type: CarLibrary.EngineState 

Type: CarlLibrary.Car 

Type: CarLibrary.SportsCar 

Type: CarLibrary.MiniVan 





源 代 码 ”ExternalAssemblyReflector 项 目的 源 代码 位 于 Chapter 15 子 目录 下 。 
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15.5 反射 共享 程序 集 


Assembly.Load() 方 法 被 重 载 很 多 次 了 。Assembly.Load() 的 一 种 变化 是 允许 指定 一 个 区 域 设置 (为 
本 地 化 程序 集 )、 一 个 版 本 号 和 公 钥 标记 值 ( 为 共享 程序 集 )。 整 体 来 说 ,识别 一 个 程序 集 的 一 组 术语 
称 为 显示 名 称 ( display name ) 。 显 示 名 称 的 格式 以 程序 集 友 好 名 称 开 头 ， 其 后 加 上 以 逗号 分 隔 的 名 
称 / 值 对 字符 串 ， 后 接 可 选 先 的 标识 符 (并 可 以 按 任意 顺序 出 现 )。 下 面 是 模板 ( 可 选项 出 现在 括号 中 ): 


Name (,Version = major.minor.build.revision) (,Culture = culture token) 
(,PublicKkeyToken= public key token) 


在 显示 名 称 中 ，PublickKeyToken=null 通 常 表示 需要 绑 定 和 匹配 一 个 非 强 名 称 的 程序 集 。 而 
culture=”" 表 示 匹 配 目标 机 需 默 认 的 区 域 设 置 ， 举 例 来 说 : 
// 使 用 默认 的 区 域 设 置 加 载 CarLibrary 的 1.0.0.0 版 本 


Assembly a = 
Assembly.Load(@"CarLibrary, Version=1.0.0.0, PublickeyToken=null, Culture="""); 


为 外 ，System.Reflection 命 名 空间 提供 了 AssemblyName 类 型 ， 它 允许 用 手工 编写 的 对 象 变量 来 表 
示 前 面 的 字符 串 信 息 。 通常， 该 类 和 System.Version ( 用 面向 对 象 封装 了 程序 集 的 版 本 号 ) 结合 使 用 。 
以 这 种 方式 建立 了 显示 名 称 后 ， 就 可 以 把 它 传人 到 重 载 的 Assembly.Load() 方 法 ， 如 下 所 示 : 

// 使 用 AssemblyName 定 义 显示 名 称 

AssemblyName asmName; 

asmName = new AssemblyName(); 

asmName.Name = "CarlLibrary"; 

Version v = new Version("1.0.0.0"); 


asmName.Version = Vj 
Assembly a = Assembly.Load(asmName); 


要 加 载 一 个 GAC 中 的 共享 程序 集 ，Assembly.Load() 参 数 必须 指定 publikeytoken 公 钥 标记 值 。 举 

例 来 说 , 假定 希望 加 载 由 .NET 基 础 类 库 提供 的 System.Windows.Forms.dll 程 序 集 的 4.0.0.0 版 本 。 由 于 此 

程序 集中 类 型 的 数量 非常 大 ， 所 以 下 面 的 应 用 程序 仅仅 输出 公有 枚 举 的 名 称 ( 通过 简单 的 LINQ 
查询 ): 


using System; 

using System.Collections.Generic; 
using System.Linqg; 

using System.Text; 


using System.Reflection; 
using System.10; 


namespace SharedAsmReflector 
public class SharedAsmReflector 
private static void DisplayInfo(Assembly a) 
Console. WriteLine("***** Info about Assembly a 
Console.WriteLine("Loaded from GAC? {0}", a.GlobalAssemblyCache); 
Console.WriteLine("Asm Name: {0}", a.GetName(). Name); 


Console.WritelLine("Asm Version: {0}", a.GetName().Version); 
Console.WritelLine("Asm Culture: {0}", 
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a.GetName().CultureInfo.DisplayName); 
Console.WriteLine("\nHere are the public enums:"); 


// 用 LINQ 查 询 找 到 公有 枚 举 

Type[] types = a.GetTypes(); 

var publicEnums = from pe in types where pe.IsEnum && 
pe.IsPublic select pe; 


foreach (var pe in publicEnums) 四 
Console.WriteLine(pe); 


} 
static void Main(string[] args) 
Console.WritelLine("***** The Shared Asm Reflector App *****\n"); 


// 从 GAC 中 加 载 System.Windows.Forms.dll 

string displayName = null; 

displayName = "System.Windows.Forms," + 
"Version=4.0.0.0," + 
"PublicKkeyToken=b77a5c561934e089," + 
@"Culture="""; 

Assembly asm = Assembly.Load(displayName); 

DisplayInfo(asm); 

Console.WriteLine("Done!"); 

Console.ReadLine(); 





到 这 里 , 读者 应 当 理 解 了 如 何在 运行 时 使 用 System.Reflection 命 名 空间 中 的 核心 成 员 来 获得 元 数 
据 。 当 然 ， 虽 然 这 很 “ 酷 "， 但 是 在 工作 中 可 能 不 需要 建立 这 样 的 自 定义 对 象 浏览 器 。 尽 管 如 此 ， 反 
射 服 务 仍然 不 可 或 缺 ， 它 是 许多 非常 通用 的 编程 开发 的 基础 ， 包 括 晚期 绑 定 。 


15.6 ”晚期 绑 定 


简单 地 说 ， 晚 期 绑 定 (late binding ) 是 一 种 创建 一 个 给 定 类 型 的 实例 并 在 运行 时 调用 其 成 员 ， 而 
不 需要 在 编译 时 知道 它 存在 的 一 种 技术 。 当 建立 一 个 晚期 绑 定 到 外 部 程序 集 类 型 的 应 用 程序 时 ， 因 为 
没有 设置 该 程序 集 的 引用 ， 因 此 ， 调 用 程序 清单 没有 直接 列 出 这 个 程序 集 。 

乍 一 看 ， 晚 期 绑 定 的 作用 似乎 不 那么 明显 。 如 果 可 以 “早期 绑 定 ”一 个 类 型 ( 比如 ， 设 定 一 个 程 
序 集 引 用 并 使 用 C# new 关 键 字 分 配 类 型 ) 的 话 ， 我 们 当然 选择 早期 绑 定 。 因 为 早期 绑 定 能 在 编译 时 判 
断 ( 类 型 ) 是 否 错误 ， 而 不 是 在 运行 时 判断 。 但 是 晚期 绑 定 对 于 程序 的 可 扩展 性 来 说 至 关 重 要 。 本 章 
15.13 节 会 构建 可 扩展 应 用 程序 ， 到 那 时 ， 我 们 再 看 Activator 类 的 作用 。 
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15.6.1 System.Activator 类 


System.Activator 类 ( 定义 在 mscorlib.dll ) 是 .NET 晚 期 绑 定 过 程 中 的 关键 所 在 。 对 于 我 们 当前 的 
例子 ， 只 需 关 注 Activator.CreateInstance() 方 法 ,， 它 用 来 建立 一 个 晚期 绑 定 类 型 的 实例 。 为 了 适应 多 
种 情况 ，CreateInstance() 方 法 经 过 了 多 次 重 载 。 其 中 最 简单 的 变化 是 带 有 一 个 有 效 的 Type 对 象 ， 描 
述 希 望 动态 分 配 的 实体 。 

为 了 说 明 该 方法 ， 接 下 来 新 建 一 个 名 为 LateBindingApp 的 应 用 程序 ， 使 用 C# using 关 键 字 导入 
System.I0 和 System.Reflection 命 名 空间 。 现 修改 Program 类 如 下 : 


// 这 个 程序 将 加 载 一 个 外 部 库 并 使 用 晚期 绑 定 创建 一 个 对 象 


public class Program 
static void Main(string[] args) 
Console.WritelLine("***** Fun with Late Binding *****"); 
// 尝试 加 载 一 个 本 地 的 CarLibrary 副 本 
Assembly a = null; 
try 
a = Assembly.Load("CarlLibrary"); 


catch(FileNotFoundException ex) 


Console.WritelLine(ex.Message); 
return; 


if(a != null) 
CreateUsingLateBinding(a); 


Console.ReadLine(); 


static void CreateUsingLateBinding(Assembly asm) 
try 


{ 
// 得 到 Minivan 类 型 的 元 数据 
Type miniVan = asm.GetType("CarLibrary.MiniVan"); 


// 在 运行 时 建立 Minivan 
object obj = Activator.CreateInstance(miniVan); 
Console.WritelLine("Created a {0} using late binding!", obj); 


catch(Exception ex) 
Console.WritelLine(ex.Message); 


} 
} 


在 运行 该 应 用 之 前 ， 需 要 使 用 Windows Explorer 将 CarLibrary.dll 手 工 复制 到 bin\iDebug 文 件 夹 中 。 
这 是 因为 我 们 使 用 的 是 Assembly.Load() ， 因 此 CLR 将 只 探测 客户 端 文件 夹 ( 如 果 你 愿意 ， 可 以 使 用 
Assembly.LoadFrom() 疝 程序 集 输入 一 个 路 径 ， 尽 管 这 没有 必要 )。 
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说 明 不 要 在 本 例 中 使 用 Visual Studio 引 用 CarLibrary.dll。 这 会 在 客户 端 清单 上 记录 该 库 。 晚 期 绑 定 
的 要 点 是 试图 创建 编译 时 未 知 的 对 象 。 


注意 ，Activator.CreateInstance() 方 法 返回 一 个 基本 的 System.0bject 类 型 ， 而 不 是 一 个 强 类 型 
的 MiniVan。 因 此 ， 如 果 在 obj 变 量 上 用 点 (. ) 操作 ， 将 不 会 看 到 任何 Minivan 类 的 成 员 。 乍 一 看 ， 我 
们 可 以 用 显 式 强 制 类 型 转换 解决 这 个 问题 : 

// 是 否 需要 通过 强制 转换 来 访问 MiniVan 的 成 员 

// 不 ! 编译 器 错误 

object obj = (MiniVan)Activator.CreateInstance(minivan); 

但 由 于 程序 没有 引用 CarLibrary.dll， 你 不 能 使 用 C# using 关 键 字 引入 CarLibrary 命 名 空间 ， 因 此 不 
能 在 转换 操作 中 使 用 Minivan。 请 记 住 ， 晚 期 绑 定 的 重点 是 建立 编译 时 未 知 对 象 的 实例 。 因 此 , 我 们 如 
何 才 能 调用 存储 在 System.0bject 引 用 中 的 Minivan 对 象 的 底层 方法 呢 ? 回答 当然 是 使 用 


反射 。 


15.6.2 ”调用 没有 参数 的 方法 


假定 希望 调用 MiniVan 中 的 TurboBoost() 方 法 。 回 想 一 下 ， 这 个 方法 设置 引擎 的 状态 为 “dead” 并 
显示 一 个 消息 框 。 第 一 步 是 使 用 Type.GetMethod() 方 法 为 TurboBoost() 方 法 得 到 一 个 MethodInfo 对 象 。 
接着 ,可 以 使 用 MethodInfo 类 型 的 Invoke() 方 法 来 调用 MiniVan.TurboBoost。MethodInfo.Invoke() 需 要 
把 所 有 的 参数 送 到 MethodInfo 代 表 的 方法 中 。 这 些 参数 用 一 组 System.0bject 类 型 表示 ( 作为 方法 的 参 
数 ， 可 以 是 任意 数量 的 不 同 对 象 实体 )。 

由 于 TurboBoost() 不 需要 参数 ， 所 以 只 需 传送 nul1 ( 意思 是 “这 个 方法 没有 参数 ”)。 按 如 下 代码 
所 示 修 改 CreateUsingLateBinding() 方 法 : 


static void CreateUsingLateBinding(Assembly asm) 
{ 
try 


// 得 到 MiniVan 类 型 的 元 数据 
Type miniVan = asm.GetType("CarLibrary.MiniVan"); 


// 在 运行 中 建立 MiniVan 
object obj = Activator.CreateInstance(miniVan); 
Console.WritelLine("Created a {0} using late binding!", obj); 
// 得 到 TurboBoost 的 信息 

MethodInfo mi = miniVan.GetMethod("TurboBoost"); 


// 调用 方法 ( "nul1 "意味 着 没有 参数 ) 
mi.Invoke(obj, null); 


catch(Exception ex) 
Console.WritelLine(ex.Message); 


} 
至 此 ,一旦 调用 TurboBoost() 方 法 ， 就 可 以 看 到 如 图 15-2 所 示 的 消息 框 。 
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图 15-2 ”晚期 绑 定 方法 调用 


15.6.3 ”调用 有 参数 的 方法 


在 使 用 晚期 绑 定 调用 需要 参数 的 方法 时 , 要 将 参数 打包 到 一 个 object 类 型 的 数组 中 。CarLibrary.dll 
2.0.0.0 版 在 Car 类 中 定义 了 以 下 方法 : 
public void TurnOnRadio(bool musicOn, MusicMedia mm) 
if (musicon) 
MessageBox.Show(string.Format("Jamming {0}", mm)); 


else 
MessageBox.Show("Quiet time..."); 


该 方法 包含 两 个 参数 : 布尔 值 表示 汽车 的 音乐 系统 是 否 关闭 ， 枚 举 值 表示 音乐 播放 器 的 类 别 。 该 
枚 举 的 结构 如 下 : 


public enum MusicMedia 


musicCd, // 0 
musicTape, a 
musicRadio, // 2 
musicMp3 // 3 


以 下 是 Program 类 的 新 方法 ， 它 调用 Turn0nRadio()。 注 意 , 我 们 使 用 MusicMedia 枚 举 的 数字 值 来 表 
示 “radio” 媒 体 播放 器 : 


static void InvokeMethodwithArgsUsingLateBinding(Assembly asm) 


{ 
try 


// 首先 ， 得 到 运动 汽车 的 元 数据 描述 
Type sport = asm.GetType("CarLibrary.SportsCar"); 


// 然后 创建 运动 汽车 
object obj = Activator.CreateInstance(sport); 


// 调用 包含 参数 的 TurnOnRadio() 
MethodInfo mi = sport.GetMethod("TurnOnRadio"); 
mi.Invoke(obj, new object[] { true, 2 }); 


catch (Exception ex) 
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Console.Writeline(ex.Message); 
i 
} 
这 时 ， 你 可 以 看 到 反射 、 动 态 加 载 和 晚期 绑 定 之 间 的 关系 。 当 然 ， 反 射 API 所 提供 的 特性 远 远 不 
止 这 里 提 到 的 这 些 ， 如 果 感 兴趣 可 以 深入 研究 。 
但 你 还 是 不 清楚 究竟 何 时 可 以 在 应 用 程序 中 使 用 这 些 技术 。 本 章 结束 部 分 会 解释 这 个 问题 ， 紧 接 
下 来 我 们 先 研 究 .NET 特 性 的 作用 。 


源 代码 ”LateBindingApp 项 目的 源 代码 位 于 Chapter 15 子 目录 下 。 
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本 章 开始 已 经 说 明 ,，.NET 编 译 器 的 任务 之 一 是 为 所 有 定义 和 引用 的 类 型 生成 元 数据 描述 。 除 了 程 
序 集中 标准 的 元 数据 外 ，.NET 平 台 人 允许 程序 员 使 用 特性 (attribute ) 把 更 多 的 元 数据 媒人 入 到 程序 集中 。 
简 言 之 ， 特 性 就 是 用 于 类 型 ( 比如 类 、 接 口 、 结 构 等 )、 成 员 〈 比如 属性 、 方 法 等 )、 程 序 集 或 模块 的 
代码 注解 。 

.NET 特 性 是 扩展 了 抽象 的 System.Attribute 基 类 的 类 类 型 。 当 浏览 NET 命名 空间 时 ， 将 发 现 许多 
预定 义 特性 ， 可 以 在 应 用 程序 中 使 用 它们 。 此 外 ,可 以 创建 自 定义 特性 ,通过 从 Attribute 派 生出 新 类 
型 进一步 修饰 类 型 的 行为 。 

.NET 基 础 类 库 在 不 同 的 命名 空间 中 提供 了 大 量 特性 。 表 15-3 给 出 了 一 些 ( 绝对 不 是 全 部 ) 预定 义 
特性 。 


表 15-3 ”预定 义 特性 的 少数 几 个 例子 


特 性 作 用 

[CLSCompliant] 强制 被 注释 项 遵从 CLS。 前 面 已 经 说 过 ， 符 合 CLS 的 类 型 将 确保 无 颖 地 跨越 所 有 的 .NET 编 程 
语言 

[DllImport] 允许 -NET 代码 调用 任意 非 托管 的 C 或 C++ 基础 类 库 ， 包 括 操作 系统 中 的 API。 注 意 当 与 基于 
COM 软 件 通信 时 ，[D11Import] 不 能 使 用 

[Obsolete] 标记 一 个 不 用 的 类 或 成 员 。 如 果 其 他 程序 员 试 图 使 用 该 项 ， 他 们 将 会 收 到 一 个 描述 出 错 信 息 
的 编译 警告 

[Serializable] 标记 一 个 类 或 结构 可 以 被 “序列 化 ”， 意 味 着 它 可 以 将 当前 状态 持久 化 到 数据 流 中 


[Nonserialized] 指定 类 或 结构 中 的 某 个 字段 不 能 在 序列 化 过 程 中 被 持久 化 
[ServiceContract] 标记 一 个 方法 是 由 WCF 服 务实 现 的 契约 


当 在 代码 中 应 用 特性 时 ， 如 果 它 们 没有 被 另 一 个 软件 显 式 地 反射 ,那么 让 入 的 元 数据 基本 没什么 
作用 。 反 之 ， 艇 入 程序 集中 的 元 数据 介绍 将 被 忽略 不 计 ， 而 并 无 害处 。 
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15.7.1 特性 的 使 用 者 


与 读者 所 猜想 的 一 样 ，.NET Framework 4.5 SDK 中 的 许多 工具 都 需要 查找 各 种 特性 。C# 编 译 器 
(csc.exe ) 本 身 就 要 在 编译 周期 中 寻找 各 种 特性 是 否 存在 。 举 例 来 说 , 如 果 C# 编 译 器 遇 到 [CLSCompilant] 
特性 ， 它 将 自动 检查 特性 项 ， 确 保 它 只 公开 符合 CLS ( 公共 语言 规范 的 结构 )。 再 举 另 外 一 个 例子 ， 如 
果 C# 编 译 器 发 现 一 个 带 有 [0bsolete] 特 性 的 项 , 它 将 在 Visual Studio 的 错误 列表 窗口 中 显示 一 个 编译 器 
警告 。 

除了 开发 工具 ，.NET 基 础 类 库 中 的 许多 方法 也 被 设 定 为 要 反射 指定 的 特性 。 举 例 来 说 ， 如 果 和 希望 
将 一 个 对 象 的 状态 持久 化 到 文件 中 ， 需 要 做 的 就 是 使 用 [Serializable] 特 性 来 注释 类 。 如 果 Binary- 
Formatter 类 的 Serialize() 方 法 遇 到 这 个 特性 ， 对 象 自 动 以 紧凑 的 二 进 制 形 式 被 持久 化 到 文件 中 。 

最 后 , 我 们 可 以 构建 反射 自 定 义 特 性 和 .NET 基 础 类 库 中 特性 的 应 用 程序 。 而 这 么 做 , 本 质 上 来 说 ， 
是 能 够 构建 一 组 被 特定 的 某 些 程序 集 理解 的 “关键 字 ”。 


15.7.2 ”在 C# 中 使 用 特性 


为 了 举例 说 明 在 C# 中 使 用 特性 的 过 程 ， 先 创建 一 个 名 为 ApplyingAttributes 的 新 控制 台 应 用 程序 。 
假定 希望 建立 名 为 Motorcycle 的 类 ， 它 可 以 被 持久 化 为 二 进 制 格式 。 要 实现 它 ， 只 需 在 类 的 定义 中 应 
用 [Serializable] 特 性 。 如 果 有 一 个 字段 不 想 被 持久 化 ， 可 以 应 用 [NonSerialized] 特 性 : 


// 该 类 可 以 保存 到 磁盘 
[Serializable] 
public class Motorcycle 


// 可 是 这 个 字段 不 能 被 持久 化 
[NonSerialized] 
float weightOofCurrentPassengers; 


// 这 些 字段 要 被 持久 化 
bool hasRadioSystem; 
bool hasHeadSet; 

bool hasSissyBar; 


说 明 一 个 特性 只 能 被 应 用 在 紧 接 下 来 的 对 象 。 举例 来 说 ,在 Motorcycle 类 中 不 能 被 序列 化 的 字段 仅 
是 weightOfCurTentpPassengers。 而 由 于 整个 类 中 注释 有 [Serializable]， 所 以 其 他 字段 都 可 以 
被 序列 化 。 


这 里 ， 不 考虑 实际 的 对 象 序列 化 过 程 〈 第 20 章 将 学 习 详 细 内 容 )。 我 们 只 需要 注意 ， 当 应 用 一 个 
特性 时 ， 特 性 的 名 称 被 放 在 方 括号 中 。 

类 被 编译 后 , 可 以 使 用 ildasm.exe 查 看 更 多 的 元 数据 。 注 意 , 这 些 被 记录 的 特性 使 用 了 serializable 
(参见 MotorCycle 类 中 的 红 三 角 ) 和 notserialized 标 记 ( 在 weight0fCurrentPassengers 字 段 ， 如 图 15-3 
所 示 )。 


15.7 .NET 特性 的 作用 


Ie- C'\iMyCode\ApplyingAttributes\bin\Debug\ApplyingAttributes.exe 
| bp MANIFEST 
所 一 ApplyingAttributes 
已 - 共 ApplyingAttributes,NMotorcycle 
.class public auto ansi serializable beforefieldinit 
“< hasHead5et ; private bool 
< hasRadioSystem : private bool 


< has5issyBar : private bool 
ro ontOrCurentbassenders : ptivate notserialized float32 
一 国 .ctor : void0) 
由 - s 区 ApplyingAttributes.Program 


图 15-3 ”在 ildasm.exe 中 显示 的 特性 
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同 读者 猜想 的 一 样 ， 一 个 项 可 以 被 加 上 多 种 特性 。 假 使 有 一 个 遗留 的 C# 类 类 型 (HorseAndBuggy ) 
被 标记 为 序列 化 的 , 但 现在 认为 该 类 型 对 当前 的 开发 来 说 已 经 过 时 。 不 必 将 类 定义 从 代码 库 中 删除 ( 可 
能 会 破坏 已 有 的 软件 ), 可 以 用 [0bsolete] 特 性 标记 这 个 类 。 可 以 应 用 多 个 特性 到 一 个 单独 项 上 ， 只 需 


使 用 逗号 分 隔 列 出 : 


[Serializable, Obsolete("Use another vehicle!")] 
public class HorseAndBuggy 
{ 


A is 
} 
此 外 ， 也 可 以 像 下 面 一 样 在 每 个 项 上 应 用 多 个 特性 ( 最 终结 果 是 一 样 的 ): 
[Serializable] 


[Obsolete("Use another vehicle!")] 
public class HorseAndBuggy 
{ 


Vs 
} 


15.7.3 ”C# 特 性 简化 符号 


如 果 仔 细 阅 读 .NET Framework 4.5 SDK 文 档 ， 可 能 注意 到 带 有 [0bsolete] 特 性 的 实际 类 名 是 
ObsoleteAttribute， 而 不 是 0bsolete。 当 名 称 转换 时 ， 所 有 .NET 特 性 ( 包括 自己 建立 的 自 定 义 特 性 ) 
都 将 加 上 一 个 Attribute 标 记 的 后 级 。 但 是 ， 为 简化 应 用 特性 的 过 程 ，C# 噩 言 不 需要 输入 Attribute 后 


级 。 因 此 ， 下 面 HorseAndBuggy 类 型 的 迭代 和 先前 是 一 样 的 ( 仅仅 是 多 敲 几 个 键 而 已 ): 
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[SerializableAttribute] 
[ObsoleteAttribute("Use another vehicle!")] 
public class HorseAndBuggy 

{ 


Ws 
} 


注意 ， 这 是 C# 支 持 的 ， 不 是 所 有 的 .NET 语 言 都 支持 这 个 特性 。 


15.7.4 为 特性 指定 构造 参数 
注意 ，[0bsolete] 特 性 可 以 接受 一 个 构造 参数 。 如 果 使 用 Code Definition 窗 口 (可 以 使 用 Visual 
Studio 的 View 菜 单打 开 ) 查看 [0bsolete] 特 性 的 正式 定义 ， 将 发 现 这 个 类 提供 了 一 个 构造 函数 ， 它 接 
受 一 个 System. String: 
public sealed class ObsoleteAttribute : Attribute 
public ObsoleteAttribute(string message, bool error); 
public ObsoleteAttribute(string message); 
public ObsoleteAttribute(); 


public bool IsError { get; } 
public string Message { get; } 


当 给 特性 提供 构造 参数 时 ， 直 到 该 参数 被 其 他 类 型 或 外 部 工具 反射 后 ， 特 性 才 被 分 配 到 内 存 中 。 
定义 在 特性 级 的 字符 串 数 据 只 是 作为 元 数据 介绍 被 存储 在 程序 集中 。 


15.7.5 ”0bsolete 特 性 
既然 HorseAndBuggy 被 标记 了 0bsolete 特 性 ， 如 果 要 使 用 该 类 的 实例 : 


static void Main(string[] args) 


HorseAndBuggy mule = new HorseAndBuggy(); 


将 发 现 提供 的 字符 串 数据 被 提取 并 显示 在 Visual Studio 的 Error List 窗 口中 , 并 且 当 鼠标 悬 放 在 出 错 
代码 行 的 过 期 类 型 上 时 ， 也 将 显示 该 字符 串 数据 ( 如 图 15-4 所 示 )。 


Program.cs +b X Object Browser 





- 中. Main{stringl) args) 





从， ApplyingAttributes.Program 
i 二 
二 class Progrs + 
{ 
= static void Main(string[] args) 
HerasdrdBuagy mule = new HocseandaugE0O); 
} } ep YA bes HorseAndBuggy is obsolete: Use another vehicle! 醒 
} | 
100% ~ » 


图 15-4 ”特性 
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在 本 例 中 ,反射 [obsolete] 特 性 的 “ 另 一 个 软件 ”是 C# 编 译 器 。 和 希望 此 时 你 了 解 有 关 .NET 特 性 的 
要 点 。 

口 特性 是 派生 自 System.Attribute 的 类 。 

口 特性 导致 租 入 的 元 数据 。 

口 直到 被 其 他 代理 反射 ， 特 性 才 发 挥 使 用 。 

口 特性 在 C# 中 用 方 括号 来 应 用 。 

接 下 来 ， 让 我 们 学 习 如 何 构建 自 定 义 特性 ， 以 及 如 何 编写 自 定 义 的 程序 来 反射 戏 入 的 元 数据 。 


源 代码 ”ApplyingAttributes 项 目的 源 代码 位 于 Chapter 15 子 目录 下 。 


15.8 ”构建 自 定义 特性 


构建 自 定义 特性 的 第 一 步 是 建立 一 个 新 的 派生 自 System.Attribute 的 类 。 继 续 使 用 贯穿 于 本 书 的 
汽车 的 例子 ,假定 构建 了 一 个 田 新 的 名 为 AttributedCarLibrary 的 C# 类 库 ， 这 个 程序 集 定义 了 一 些 库 ， 
每 一 个 都 使 用 名 为 VehicleDescriptionAttribute 的 自 定义 特性 来 描述 ， 如 下 所 示 : 


// 自 定 义 特 性 
public sealed class VehicleDescriptionAttribute : System.Attribute 


public string Description { get; set; } 
public VehicleDescriptionAttribute(string vehicalDescription) 
Description = vehicalDescription; 


public VehicleDescriptionAttribute(){ } 


可 见 ，VehicleDescriptionAttribute 使 用 自动 属性 (Description ) 来 维护 一 个 字符 串 数据 。 该 类 
除了 派生 自 System.Attribute 之 外 ， 其 定义 没有 什么 特别 的 。 


说 明 ”出 于 安全 性 的 原因 ， 考虑 把 所 有 的 自 定义 特性 都 设计 成 密封 的 是 .NET 中 一 个 好 习惯 。 事实 上 ， 
Visual Studio 提 供 名 为 Attribute 的 代码 段 ， 它 会 将 继承 自 System.Attribute 的 新 类 转 储 到 代码 
窗口 中 。 第 2 章 完整 第 介绍 了 代码 段 的 使 用 。 记 住 ， 你 可 以 输入 代码 段 的 名 称 然后 按 两 次 Tab 
键 ， 这 样 就 可 以 展开 任何 代码 段 。 


15.8.1 应 用 自 定义 特性 


考虑 到 VehicleDescriptionAttribute 派 生 自 System.Attribute， 可 以 为 汽车 添加 合适 的 注释 。 为 
了 便于 测试 ， 在 你 的 新 类 库 中 添加 如 下 的 类 定义 : 


// 使 用 named property (命名 属性 ) 为 description 赋 值 
[Serializable] 
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[VehicleDescription(Description = "My rocking Harley")] 
public class Motorcycle 


} 


[SerializableAttribute] 

[ObsoleteAttribute("Use another vehicle!")] 

[VehicleDescription("The old gray mare, she ain't what she used to be...")] 
public class HorseAndBuggy 

{ 


} 


[VehicleDescription("A very long, slow, but feature-rich auto")] 
public class Winnebago 


} 


15.8.2 ”命名 属性 语法 


注意 ,Motorcycle 的 描述 采用 了 一 种 新 的 描述 方法 , 用 到 一 个 新 的 特性 语法 一 一 命名 属性 (named 
property ) 。 在 第 一 个 [VehicleDescription] 特 性 的 构造 函数 中 ,使 用 Description 属 性 设置 下 面 的 字符 
串 数 据 。 如 果 该 特性 被 一 个 外 部 代理 反射 ， 该 值 将 写 人 到 Description 属 性 ( 只 有 特性 提供 一 个 可 写 
的 .NET 属 性 ， 命 名 属性 的 语法 才 是 合法 的 )。 

与 之 相 比 ，HorseAndBuggy 和 Winnebago 类 型 没有 使 用 命名 属性 的 语法 ,而 只 是 通过 自 定义 构造 函 
数 传 递 了 字符 串 数据 。 编 译 完 AttributedCarLibrary 程 序 集 后 ， 可 以 使 用 ildasm.exe 查 看 在 类 型 中 放 入 的 
元 数据 描述 。 例如 , 图 15-5 显 示 了 一 个 代入 的 Winnebago 类 的 描述 , 特别 是 ildasm.exe 中 beforefieldinit 
中 的 数据 。 


ng) =( 81 89 28 44 2876 65 72 79 29 6C 6F 6E 57 2E 28 /ff ..(A very long, 
‘| 73 6€ 6F 77 2C 28 62 75 74 28 66 65 61 78 75 72 jf slow, but featur 
65 2D 72 #69 63 68 26 61 75 74 6F 88 98 ) 1f e-rich auto.. 








图 15-5 骨 入 的 汽车 描述 数据 


15.8.3 ”限制 特性 使 用 
默认 情况 下 ， 自 定义 特性 可 以 被 应 用 在 代码 中 几乎 所 有 的 方面 (方法 、 类 、 属 性 等 )。 因 此 ， 只 
要 恰当 ， 可 以 使 用 VehicleDescription 修 饰 方法 、 属 性 或 字段 (或 其 他 的 内 容 ): 


[VehicleDescription("A very long, slow, but feature-rich auto")] 
public class Winnebago 
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[VehicleDescription("My rocking CD player")] 
public void PlayMusic(bool On) 


} 


某 些 情况 下 ， 这 样 就 能 够 满足 需要 。 但 是 ， 有 时 候 也 许 想 建立 这 样 一 个 自 定义 特性 : 它 只 被 应 用 
到 选 定 的 代码 元 素 上 。 如 果 和 希望 限制 自 定义 特性 的 应 用 范围 ， 需 要 在 自 定义 特性 的 定义 中 应 用 
[AttributeUsage] 特 性 。[AttributeUsage] 特 性 支持 AttributeTargets 枚 举 值 的 任意 组 合 (通过 OR 操作 ): 

// 这 个 枚 举 定义 了 一 个 特性 可 能 的 目标 值 

public enum AttributeTargets 


All, Assembly, Class, Constructor, 

Delegate, Enum, Event, Field, GenericParameter, 
Interface, Method, Module, Parameter, 

Property, ReturnValue, Struct 


此 外 ，[AttributeUsage] 也 允许 我 们 随意 设置 命名 属性 ， 比 如 AllowMultiple， 它 用 来 指示 在 相同 
项 上 特性 是 否 可 被 应 用 多 次 ( 默认 值 为 false )。 而 [AttributeUsage] 也 允许 我 们 使 用 Inherited 命 名 属 
性 指示 特性 是 否 能 够 被 派生 类 继承 ( 默认 值 为 true )。 

为 了 设 定 [VehicleDescription] 特 性 只 能 在 类 或 结构 中 应 用 一 次 ， 可 以 修改 VehicleDescription- 
Attribute 定 义 如 下 : 

// 这 次 ， 我 们 使 用 AttributeUsage 特 性 来 注释 我 们 的 自 定义 特性 

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct, 


Inherited = false)] 
public sealed class VehicleDescriptionAttribute : System.Attribute 


基于 此 ， 如 果 开 发 者 试图 应 用 [VehicleDescription] 特 性 到 类 或 结构 以 外 的 其 他 地 方 ， 就 会 遇 到 
编译 时 错误 。 


15.9 程序 集 级 别 特性 


使 用 和 [assembly:] 标 签 , 在 给 定 程序 集 的 所 有 类 型 上 应 用 特性 也 是 可 以 的 。 举 例 来 说 ,假定 你 希 
望 确保 定义 在 程序 集中 的 每 个 公共 类 型 都 是 符合 CLS ( 公共 语言 规范 ) 的 。 


说 明 第 1 章 提 到 了 遵循 CLS 的 程序 集 的 作用 。 遵 循 CLS 的 程序 集 可 用 于 所 有 .NET 编 程 语言 。 如 果 公 
共 类 型 的 公共 成 员 公 开 了 未 遵循 CLS 的 编程 结构 ( 如 无 符号 数据 或 指针 参数 )， 其 他 .NET 语 言 
将 无 法 使 用 这 些 功能 。 因 此 ， 如 果 要 构建 可 用 于 各 种 .NET 语 言 的 C# 代 码 库 ， 则 必须 遵循 CLS。 


要 实现 这 个 目标 , 只 需 在 每 个 C# 源 代码 文件 项 部 中 加 入 下 面 的 程序 集 级 别 特性 。 注 意 程 序 集 或 者 
模块 级 别 特性 必须 在 命名 空间 范围 外 定义 ! 如 果 向 项 目 添加 程序 集 (或 模块 ) 级 别 特性 ， 推 荐 的 文件 
布局 如 下 : 
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// 首先 列 出 using 语 各 

using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 


// 现在 列 出 所 有 程序 集 / 模 块 级 别 特性 
// 强制 所 有 在 程序 集中 的 公共 类 型 符合 CLS 
[assembly: CLSCompliant(true)] 


// 下 面 列 出 命名 空间 和 类 型 
namespace AttributedCarLibrary 


{ 
// 类 


如 果 现 在 增加 不 符合 CLS 的 代码 ( 如 未 标记 数据 的 公开 点 ): 


// Ulong 类 型 不 符合 CLS 
public class Winnebago 


public ulong notCompliant; 
就 会 收 到 一 个 编译 器 错误 。 


Visual Studio Assemblylnfo.cs 文 件 


默认 情况 下 ，Visual Studio 生 成 一 个 名 为 AssemblyInfo.cs 的 文件 ( 如 图 15-6 所 示 )。 可 以 通过 扩展 
Solution Explorer 的 Properties 图 标 来 查看 它 。 


: SOLUTION EXPLORER : 


人 2 各 司 * 回 | oa 
: Search Solution Explorer (Ctrl+;} 
Solution 'AttributedCarLibrary’ (1 prcject) 
4 [EAttributedCarlibrary 
4 i Properties 
bp Co Assemblyinfo.cs 
b wR References 
b Cc Types.cs 





SOLUTION EXPLORER TEAM EXPLORER CLASSVIEW 


图 15-6 ”AssemblyInfo.cs 文 件 


这 个 文件 用 于 放置 程序 集 级 别 使 用 的 特性 。 第 14 章 讨论 过 .NET 程 序 集 , 其 中 的 清单 包含 程序 集 级 
别 的 元 数据 ， 表 15-4 列 出 了 一 些 需 要 注意 的 程序 集 级 别 的 特性 。 
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表 15-4 ”部 分 程序 集 级 别 特性 





特 性 含义 
[AssemblyCompany] 保存 基本 的 公司 信息 
[AssemblyCopyright] 保存 产品 或 程序 集 的 版 权 信息 
[AssemblyCulture] 提供 程序 集 ht 区 域 或 语言 信息 
[AssemblyDescription] 保存 组 成 程序 集 的 产品 或 模块 的 描述 
[AssemblyKeyFile] 指定 包含 用 于 签名 程序 集 的 密 钥 对 的 文件 的 名 称 〈 例如 建立 一 个 强 名 称 ) 
[AssemblyProduct] 提供 产品 信息 
[AssemblyTrademark] 提供 商标 信息 
[AssemblyVersion] 指定 程序 集 的 版 本 信息 ， 用 <major.minor.build. revision> 格 式 

















源 代码 ne 目 i Wd 于 Chapter 15 子 目录 下 。 
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记 住 ， 一 个 特性 直到 另 一 个 软件 反射 它 的 值 时 才 有 用 。 给 定 的 特性 被 发 现 后 ， 软 件 可 以 采取 任何 
需要 的 行为 。 现 在 ， 和 应 用 程序 一 样 ， 这 个 “ 男 一 个 软件 ” 也 可 以 使 用 早期 或 晚期 绑 定 找到 一 个 自 定 
义 特 性 。 如 果 和 硕 望 使 用 早期 绑 定 , 则 相应 的 特性 需要 客户 应 用 程序 在 编译 时 定义 ( 在 本 例 中 是 Vehicle- 
DescriptionAttribute )。 既然 AttributedCarLibrary 程 序 集 把 这 个 自 定 义 特 性 定义 为 公用 类 , 早期 绑 定 就 是 
最 好 的 选择 。 

为 说 明 反 射 自 定义 特性 的 过 程 ， 创 建 一 个 新 的 C# 控 制 台 程序 ， 命 名 为 VehicleDescriptionAttribute- 
Reader。 然 后 ， 设 置 AttributedCarLibrary 程 序 集 的 引用 。 最 后 ， 用 下 面 代码 修改 初始 *.cs 文 件 ; 


// 使 用 早期 绑 定 反射 自 定义 特性 

using Systemj 

using System.Collections.Generic; 

using System.Linq; 

using System.Text; 

using AttributedCarlLibrary; 

namespace VehicleDescriptionAttributeReader 

class Program 
static void Main(string[] args) 

Console.WriteLine("***** Value of VehicleDescriptionAttribute *****\n"); 
ReflectOnAttributesUsingEarlyBinding(); 
Console.ReadLine(); 


private static void ReflectOnAttributesUsingEarlyBinding() 


{ 
// 得 到 一 个 表现 Winnebago 的 类 型 
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Type t = typeof(Winnebago); 


// 得 到 Minnebago 所 有 的 特性 
object[] customAtts = t.GetCustomAttributes(false); 


// 输出 描述 
foreach (VehicleDescriptionAttribute v in customAtts) 
Console.WiriteLine("-> {0}\n", v.Description); 


} 
} 


Type.GetCustmeAttributes() 方 法 返回 一 个 对 象 数 组 , 表示 了 应 用 到 Type 代表 的 成 员 上 的 所 有 特性 
(Type 是 布尔 类 型 的 参数 ， 控 制 是 否 扩展 搜索 到 继承 链 )。 得 到 特性 列表 后 ， 遍 历 每 个 Vehicle- 
DescriptionAttribute 类 并 输出 Description 属 性 的 值 。 


源 代码 ”VehicleDescriptionAttributeReader 应 用 程序 的 源 代码 位 于 Chapter 15 子 目录 下 。 


15.11 使 用 晚期 绑 定 反射 特性 


前 面 的 例子 使 用 早期 绑 定 输出 由 nnebago 类 型 汽车 的 描述 数据 ， 这 是 因为 VehicleDescription- 
Attribute 类 类 型 在 AttributedCarLibrary 程 序 集中 被 定义 为 公共 成 员 。 也 可 以 使 用 动态 加 载 和 晚期 绑 定 
来 反射 特性 。 

创建 新 的 名 为 VehicleDescriptionAttributeReaderLateBinding 的 项 目 ， 将 AttributedCarLibrary.dll 
复制 到 项 目的 \bin\Debug 目 录 下 ， 现 在 ， 修 改 Program 类 如 下 : 

using Systemj 

using System.Collections.Generic; 


using System.Linq; 
using System.Text; 


using System.Reflection; 
namespace VehicleDescriptionAttributeReaderLateBinding 
class Program 
static void Main(string[] args) 
Console.WritelLine("***** Value of VehicleDescriptionAttribute *****\n"); 
ReflectAttributesUsingLateBinding(); 
Console.ReadLine(); 
private static void ReflectAttributesUsingLateBinding() 
try 


// 加 载 本 地 的 AttributedCarLibrary 的 副本 
Assembly asm = Assembly.Load("AttributedCarLibrary"); 


// 得 到 VehicleDescriptionAttribute 的 类 型 信息 
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Type vehicleDesc = 
asm.GetType("AttributedCarlLibrary.VehicleDescriptionAttribute"); 


// 得 到 Description 属 性 的 类 型 信息 
PropertyInfo propDesc = vehicleDesc.GetProperty("Description"); 


// 得 到 程序 集中 所 有 类 型 
Type[] types = asm.GetTypes(); 


// 遍历 每 个 类 型 ， 得 到 所 有 的 VehicleDescriptionAttributes 
foreach (Type t in types) 


object[] objs = t.GetCustomAttributes(vehicleDesc, false); 


// 遍历 每 个 VehicleDescriptionAttribute 并 使 用 晚期 绑 定 输出 描述 
foreach (object o in objs) 


Console.WriteLine("-> {0}: {1i}\n", 
t.Name, propDesc.GetValue(o, null)); 


} 
catch (Exception ex) 


Console.WritelLine(ex.Message); 


} 
} 
} 


如 果 读 者 一 直 在 看 本 章 中 的 例子 程序 ， 这 段 代码 应 该 ( 多 多 少 少 ) 不 需 加 以 说 明了 。 仅 需要 关注 
的 是 PropertyInfo.GetValue() 方 法 的 使 用 , 它 用 来 触发 属性 的 访问 者 .下 面 显 示 了 当前 示例 的 输出 结果 : 





六 水 灶 冰 炒 Value of VehicleDescriptionAttribute ***** 
-> Motorcycle: My rocking Harley 
-> HorseAndBuggy: The old gray mare, she ain't what she used to be... 


-> Winnebago: A very long, slow, but feature-rich auto 





源 代 码 ”VehicleDescriptionAttributeReaderLateBinding 应 用 程序 的 源 代 码 位 于 Chapter 15 子 目录 下 。 


15.12 反射、 晚期 绑 定 和 自 定 义 特 性 的 使 用 背景 


尽管 已 经 运行 了 这 些 技术 的 多 个 示例 ,读者 可 能 仍然 想 知道 什么 时 候 在 程序 中 使 用 反射 、 动 态 加 
载 、 晚 期 绑 定 和 自 定义 特性 。 的 确 ， 这 些 有 趣 的 主题 似乎 有 一 点 学 院 派 的 味道 (有 的 读者 可 能 认为 这 
不 是 什么 坏事 )。 为 帮助 将 这 些 主题 应 用 到 实际 情况 中 ， 需 要 一 个 实际 的 例子 。 假 定 现在 读者 在 一 个 
编程 团队 中 ， 该 团队 需要 按照 下 面 的 需求 建立 一 个 应 用 程序 。 
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口 产品 必须 可 以 通过 使 用 第 三 方 工具 进行 扩展 。 
然而 ,什么 是 可 扩展 的 呢 ? 想 想 Visual Studio IDE。 当 应 用 程序 开发 时 ， 各 种 “ 钧 子 ” 被 插入 ,多 
许 其 他 软件 提供 商 在 IDE 开 发 环境 中 插入 自 定 义 模块 。 显 然 ，Visual Studio 团 队 没 有 办 法 设置 引用 还 未 
编写 的 外 部 .NET 程 序 集 ( 因此 ， 不 能 使 用 早期 绑 定 )， 所 以 ， 如 何 让 应 用 程序 提供 需要 的 钩子 呢 ? 下 
面 是 解决 这 个 问题 的 一 个 可 能 的 办 法 。 
口 首先 ， 可 扩展 的 应 用 程序 必须 提供 一 些 输入 手段 ， 允 许 用 户 指定 被 插入 的 模块 〈 比如 一 个 对 
话 框 或 命令 行 标志 )。 这 需要 动态 加 载 。 
口 其 次 ， 为 了 插入 到 环境 中 ， 可 扩展 的 应 用 程序 必须 要 确定 模块 是 否 支持 正确 的 功能 ( 比如 一 
组 需要 的 接口 )。 这 需要 反射 。 
口 最 后 ， 可 扩展 的 应 用 程序 必须 获取 一 个 需要 的 基础 架构 的 引用 ( 例如 接口 类 型 ) 并 调用 成 员 
触发 底层 功能 。 这 经 常 需要 晚期 绑 定 。 
简单 来 说 ， 如 果 可 扩展 的 应 用 程序 预 编程 为 查询 指定 的 接口 ， 则 它 可 以 在 运行 时 确定 类 型 是 否 可 
以 被 激活 ,一 旦 验证 测试 通过 ,类 型 便 可 以 支持 额外 的 接口 ,为 它们 的 功能 提供 多 种 结构 。 这 正 是 Visual 
Studio 团 队 采 取 的 做 法 ， 我 觉得 一 点 都 不 困难 。 


15.13 构建 可 扩展 的 应 用 程序 


下 面 通过 一 个 完整 的 例子 说 明 构 建 一 个 可 扩展 的 Windows 窗 体 应 用 程序 的 过 程 ， 它 可 以 使 用 外 部 
程序 集 来 扩展 功能 。 如 果 没 有 用 Windows Forms API 构 建 过 GUI， 你 应 该 加 载 提供 的 解决 方案 代码 ， 然 
后 继续 。 


说 了 明 Windows Forms 是 .NET 平 台 最 初 的 桌面 API。 但 从 NET3.0 开 始 ，WPF API 迅 速成 为 GUI 框架 的 
首选 。 尽 管 如 此 ， 本 书 仍 将 使 用 Windows Forms 作 为 一 些 客户 端 GUI 的 示例 ， 因 为 它 的 代码 与 
相应 WPF 代 码 相 比 ， 要 稍 显 直 观 。 


如 果 不 熟悉 建立 Windows 窗 体 应 用 程序 的 过 程 ， 只 需要 打开 提供 的 示例 代码 ， 然 后 按照 下 面 的 步 
又 来 做 。 具 体 说 明 一 下 ， 我 们 的 可 扩展 应 用 程序 需要 下 列 程序 集 。 

口 CommonSnappableTypes.dll: 该 程序 集 包 含 将 被 每 个 插件 对 象 实现 的 类 型 定义 ,该 类 型 定义 将 

会 被 Windows 窗 体 应 用 程序 直接 引用 。 

口 CSharpSnapIn.dll: 一 个 用 C# 编 写 的 插件 ， 它 使 用 CommonSnappableTypes.dll 类 型 。 

口 VbSnapIn.dll: 一 个 用 Visual Basic 编 写 的 插件 ， 它 使 用 CommonSnappableTypes.dll 类 型 。 

口 MyExtendableApp.exe: 这 个 Windows 窗 体 应 用 程序 将 成 为 可 以 被 每 个 插件 功能 扩展 的 实体 。 

另外 , 这 个 应 用 程序 可 以 使 用 动态 加 载 、 反 射 和 晚期 绑 定 来 动态 获取 预先 不 知道 的 程序 集 的 功能 。 


15.13.1 构建 CommonSnappableTypes.dll 


第 一 步 是 建立 一 个 程序 集 ， 它 将 包含 能 将 插件 插入 可 扩展 Windows 窗 体 应 用 程序 中 的 类 型 。 
CommonSnappableTypes 类 库 项 目 定义 了 两 个 类 型 . 
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namespace CommonSnappableTypes 
public interface IAppFunctionality 


void DoIt(); 


[AttributeUsage(AttributeTargets.Class)] 
public sealed class CompanyInfoAttribute : System.Attribute 


public string CompanyName { get; set; } 
public string CompanyUr] { get; set; } 
} 
IAppFunctionality 接 口 为 可 被 可 扩展 Windows 窗 体 应 用 程序 使 用 的 所 有 插件 提供 了 一 个 多 态 接 
口 。 当 然 ， 这 纯粹 是 举例 ， 所 以 我 们 只 提供 单个 DoIt() 方 法 。 为 了 接近 实际 的 例子 ， 想 象 有 这 样 一 个 
接口 (或 一 组 接口 ), 它 ( 们 ) 可 以 允许 插件 产生 脚本 代码 ， 可 以 在 应 用 程序 工具 箱 中 生成 图 像 或 整 
合 到 承载 程序 的 主 菜单 中 。 
CompanyInfoAttribute 类 型 是 一 个 自 定义 特性 ， 可 以 用 于 希望 插 到 容器 中 的 任意 类 类 型 。 通 过 该 
类 的 定义 可 以 知道 ，[CompanyInfo] 人 允许 插件 的 开发 者 提供 一 些 关 于 组 件 来 源 的 基本 细节 。 


15.13.2 ”构建 C# 插 件 


接 下 来 , 需要 建立 一 个 实现 IAppFunctionality 接 口 的 类 型 。 当 然 , 为 集中 精力 做 可 扩展 应 用 程序 的 总 
体 设计 , 我 们 只 用 一 个 小 的 类 型 。 假定 新 的 C# 代 码 库 项 目 命名 为 CSharpSnapm, 它 定 义 了 一 个 CSharpModule 
类 型 。 该 类 必须 使 用 CommonSnappableTypes 中 定义 的 类 型 ， 因 此 ， 请 保证 设置 了 对 这 个 二 进 制 文件 的 引 
用 (另外 ， 用 于 消息 提示 的 System.Windows.Forms.dll 也 要 引用 进来 )。 说 了 这 么 多 ， 这 里 是 代码 : 


using Systemj; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 


using CommonSnappableTypes; 
using System.Windows.Forms; 


namespace CSharpSnapIn 
[CompanyInfo(CompanyName = "My Company", 


CompanyUrl = "www.MyCompany.com")] 
public class CSharpModule : IAppFunctionality 


void IAppFunctionality.DoIt() 
{ 


MessageBox.Show("You have just used the C# snap in!"); 


: 
} 
注意 ， 当 支持 IAppFunctionality 接 口 时 ,选择 了 显 式 的 接口 实现 。 虽 然 这 并 不 是 必需 的 ,但 这 里 
主要 考虑 到 系统 中 需要 与 该 接口 类 型 直接 交互 的 部 分 只 有 承载 的 Windows 程 序 。 通 过 显 式 实现 接口 ， 
DoIt() 方 法 没有 直接 从 CSharpModule 类 型 中 公开 。 
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15.13.3 ”构建 Visual Basic 插 件 


有 些 第 三 方 厂商 更 喜欢 用 Visual Basic 而 不 用 C#， 为 模拟 它们 的 角色 ， 构 建 一 个 新 的 Visual Basic 
类 库 ( VbNetSnapIn )， 与 前 一 个 CSharpSnapIn 项 目 引 用 相同 的 外 部 程序 集 。 
说 明 默认 情况 下 ，Visual Basic 项 目 在 Solution Explorer 中 不 显示 References 文 件 夹 。 要 在 VB 项 目 中 
添加 引用 ， 可 以 使 用 Visual Studio 中 的 Project 一 Add Reference... 菜 单 选 项 。 


代码 〈 再 次 ) 有 意 写 得 比较 简单 : 


Imports System.Windows .Forms 
Imports CommonSnappableTypes 


<CompanyInfo(CompanyName:="Chucky's Software", CompanyUrl:="www.ChuckySoft.com")> 
Public Class VbSnapIn 


Implements IAppFunctionality 


Public Sub DoIt() Implements CommonSnappableTypes.IAppFunctionality.DoIt 
MessageBox.Show("You have just used the VB snap in!") 
End Sub 


End Class 


要 注意 的 是 ，Visual Basic 中 特性 的 应 用 是 使 用 尖 括 号 ( < > ) 而 不 是 方 括号 ([ ] )。 还 要 注意 ， 
Implements 关 键 字 用 来 在 指定 的 类 或 结构 上 实现 接口 类 型 。 


15.13.4 构建 可 扩展 的 Windows Forms 应 用 程序 


最 后 一 步 是 建立 一 个 新 的 Windows Forms 应 用 程序 ( MyExtendableApp )， 它 能 够 让 用 户 使 用 标准 
的 Windows Open 对 话 框 选择 一 个 捅 件 程序 。 如 果 你 以 前 没 创建 过 Windows Forms 应 用 程序 ， 可 以 选择 
Visual Studio 中 New Project 对 话 框 中 的 Windows Forms Application 项 目 (如 图 15-7 所 示 )。 


New Pr 过 








pret ise) 天 攻 Sesrch natalled Templates P| 
3 Type: VisvualC# | 
1 A project tor cresting an application witha | 
| Nee | 2 区 Windows Forms user interlace 
| | WPF Application f | 
3 
Ee 
[Ee Console AppEcation 


机 
a Class Library Visual Cs 


a Portsble Class Library 


Visoval C# 


图 15-7 使 用 Visual Studio 创 建 Windows Forms 项 目 
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现在 ,添加 CommonSnappableTypes.dll 的 引用 ， 不 用 添加 CSharpSnapIn.dll 或 VbSnapIn.dll 的 引用 。 
同时 ， 在 窗 体 的 主 代码 文件 ( 右 击 窗 体 设计 器 ， 选 择 View Code， 可 以 打开 主 代 码 文件 ) 中 引入 
System.Reflection 和 CommonSnappableTypes 命 名 空间 。 记 住 ， 该 应 用 程序 的 唯一 目标 ， 就 是 利用 晚期 
绑 定 和 反射 来 决定 由 第 三 方 厂商 所 创建 的 独立 二 进 制 文件 的 “可 插 取 性 ”。 

我 不 想 在 这 里 说 明 Windows Forms 开 发 的 细节 (参见 附录 A )。 但 是 假定 在 窗 体 模板 中 放置 了 一 个 
MenuStrip 组 件 ， 定 义 一 个 置顶 的 菜单 项 ,命名 为 File， 它 提供 一 个 名 为 Snap In Module 的 子 菜单 项 。 该 
Windows 窗 体 也 将 包含 ListBox 类 型 ( 这 里 被 重 命名 为 1stLoadedsnapIns ), 该 类 型 用 于 显示 由 用 户 加 载 
的 每 一 个 插件 程序 的 名 称 。 图 15-8 显 示 了 最 终 的 GUI 界面 。 


MainForm.cs [Design] 中 X .Object Browser ， 





局 | mainMenuStrip 


图 15-8 MyExtendableApp 的 GUI 界面 


处 理 File Snap In Module 菜 单项 的 Click 事 件 的 代码 (在 设计 时 编辑 器 中 双击 菜单 项 即 可 创建 ) 显 
示 一 个 FileOpen 对 话 框 ， 并 且 取 出 所 选 文件 的 路 径 。 假 定 用 户 没有 选择 CommonsnappableTypes.d11 程 
序 集 ( 因为 这 完全 是 基础 结构 ), 这 个 路 径 传递 到 一 个 名 为 LoadExternalModule() 的 辅助 方法 中 来 处 理 。 
当 不 能 找到 实现 IAppFunctionality 的 类 时 ， 这 个 方法 将 返回 false: 
private void snapInModuleToolStripMenuItem Click(object sender, 
EventArgs e) 


// 允许 用 户 选择 一 个 程序 集 加 载 
OpenFileDialog dlg = new OpenFileDialog(); 
if (dlg.ShowDialog() == DialogResult .OK) 


if(dlg.FileName.Contains("CommonSnappableTypes")) 
MessageBox.Show("CommonSnappableTypes has no snap-ins!"); 

else if(!LoadExternalModule(dlg.FileName)) 
MessageBox.Show("Nothing implements IAppFunctionality!"); 


} 
LoadExternalModule() 方 法 执行 下 列 任务 : 
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口 将 程序 集 动态 加 载 到 内 存 中 ; 

口 确定 程序 集 是 否 包含 实现 IAppFunctionality 的 类 型 ; 

口 用 晚期 绑 定 实现 类 型 。 

如 果 发 现 一 个 实现 IAppFunctionality 的 类 型 ，DoIt() 方 法 将 被 调用 ， 并且 类 型 的 完全 限定 名 将 被 
添加 到 ListBox 中 ( 注意 foreach 循 环 将 遍历 程序 集中 的 所 有 类 型 ， 以 应 对 一 个 单一 程序 集 拥 有 多 个 插 
件 的 可 能 性 )。 


private bool LoadExternalModule(string path) 


bool foundSnapIn = false; 
Assembly theSnapInAsm = null; 


try 
{ 
// 动态 加 载 选 中 的 程序 集 
theSnapInAsm = Assembly.LoadFrom(path); 
} 
catch(Exception ex) 


MessageBox.Show(ex.Message); 
return foundSnapIn; 


// 得 到 程序 集中 所 有 的 IAppFunctionality 兼 容 的 类 

var theClassTypes = from t in theSnapInAsm.GetTypes() 
Where t.IsClass && 
(t.GetInterface("IAppFunctionality") != null) 
select +t; 

// 创建 对 象 对 调用 DoIt() 方 法 

foreach (Type t in theClassTypes) 

{ 


foundSnapIn = true; 

// 使 用 晚期 绑 定 建立 类 型 

IAppFunctionality itfApp = 
(IAppFunctionality)theSnapInAsm.CreateInstance(t.FullName, true); 

itfApp.DoIt(); 

lstLoadedSnapIns.Items.Add(t.FullName); 


return foundSnapIn; 


到 这 里 就 可 以 运行 应 用 程序 了 。 当 选择 CSharpSnapIn.dll 或 VbSnapIn.dll 程 序 集 时 ,将 看 到 正确 的 
信息 显示 。 最 后 的 任务 是 显示 被 [CompanyInfo] 特 性 支持 的 元 数据 ,为 此 ,只 需 修改 LoadExternalModule() 
方法 ， 在 退出 foreach 语 句 块 前 调用 一 个 名 为 DisplayCompanyData() 的 新 辅助 方法 。 注 意 该 方法 带 有 一 
个 System.Type 的 参数 。 

private bool LoadExternalModule(string path) 


‘foreach (Type t in theClassTypes) 
{ 
// 显示 公司 信息 
DisplayCompanyData(t); 


return foundSnapIn; 
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使 用 传人 的 类 型 ， 反 射 得 到 [ CompangInfo ] 特性 ， 如 下 所 示 : 
private void DisplayCompanyData(Type +) 


// 获取 [CompanyInfo] 数据 

var compInfo = from ci in t.GetCustomAttributes(false) where 
(ci.GetType() == typeof(CompanyInfoAttribute)) 
select ci; 

// 显示 数据 

foreach (CompanyInfoAttribute c in compInfo) 


MessageBox.Show(c.CompanyUrl, 
string.Format("More info about {0} can be found at", c.CompanyName)); 


} 
} 
图 15-9 显 示 了 可 能 的 运行 情况 。 


(8 My Ertensible App! EE 


File | 和 人 
















| CShapSnapin.CShapModule 








图 15-9 ”插入 外 部 程序 集 


太 棒 了 ,我们 完成 了 这 个 应 用 程序 示例 。 希望 到 这 里 读者 可 以 看 到 本 章 表现 的 主题 在 实际 环境 中 
非常 有 用 ， 并 且 对 构建 工具 没有 限制 。 


源 代 码 CommonSnappableTypes 、CSharpSnapIn 、VbSnapIn 和 MyExtendableApp 项 目的 源 代 码 位 于 
Chapter 15 子 目录 下 。 
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反射 是 健壮 的 面向 对 象 环境 中 非常 有 意思 的 特性 。 在 ,NET 中， 反射 服务 与 System.Type 类 和 
system.Reflection 命 名 空间 紧密 相关 。 我 们 已 经 看 到 ,反射 在 运行 时 把 一 个 类 型 放置 在 放大 镜 下 ， 理 115 
解 一 个 给 定 项 是 谁 、 做 什么 、 在 哪里 、 什 么 时 候 、 为 什么 做 和 怎样 做 的 过 程 。 

晚期 绑 定 是 创建 类 型 并 调用 其 成 员 的 过 程 ， 它 无 须 预 先知 道成 员 的 特定 名 称 。 晚 期 绑 定 是 动态 加 
载 的 直接 结果 ， 它 允许 通过 编程 方式 在 内 存 中 加 载 NET 程 序 集 。 在 本 章 的 可 扩展 应 用 程序 示例 中 可 以 
看 到 ， 这 是 在 工具 构建 和 使 用 中 非常 有 用 的 技术 。 本 章 还 学 习 了 基于 特性 编程 的 作用 。 使 用 特性 修饰 
类 型 ， 结 果 是 增加 了 底层 程序 集 元 数据 。 
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借 软 在 .NET 4.0 中 为 C 娄 | 人 了 一 个 新 的 关键 字 dynamic， 它 允许 我 们 在 类 型 安全 的 分 号 和 花 括 
号 之 间 的 强 类 型 世界 里 使 用 脚本 化 的 行为 。 使 用 这 种 松散 的 类 型 ， 可 以 极 大 地 简化 一 些 复 
杂 的 编码 任务 ,而且 还 可 以 获得 与 大 量 基于 .NET 的 动态 语言 ( 如 IronRuby、IronPython ) 交互 的 能 力 。 

本 章 ,我 们 将 学 习 C# dynamic 关 键 字 的 方方面面 ,理解 如 何 使 用 DLR™( Dynamic Language Runtime， 
动态 语言 运行 时 ) 将 松散 的 类 型 映射 到 正确 的 内 存 对 象 。 理 解 了 DLR 提 供 的 诸多 服务 之 后 ， 你 将 看 到 
一 些 示例 ， 它 们 使 用 动态 类 型 来 简化 后 期 绑 定 方法 的 调用 ( 通过 反射 服务 ) 并 且 可 以 方便 地 与 遗留 的 
COM 库 进行 通信 。 


说 明 不 要 混淆 C# 中 的 dynamic 关 键 字 和 动态 程序 集 ( 见 第 18 章 ) 的 概念 。 虽 然 在 创建 动态 程序 集 时 
可 以 使 用 dynamic 关 键 字 ， 但 它们 其 实 是 两 个 完全 不 同 的 概念 。 


16.1 dynamic 关键 字 的 作用 


在 第 3 章 中 我 们 学 习 了 var 关 键 字 。 使 用 var 可 以 定义 本 地 变量 , 该 变量 的 实际 数据 类 型 取决 于 编译 
时 ， 是 在 初次 分 配 时 确定 的 ( 称 为 隐 式 类 型 )。 在 初次 分 配 之 后 ， 你 将 拥有 一 个 强 类 型 的 变量 ,任何 
不 相 容 的 赋值 操作 都 会 导致 编译 错误 。 

在 开始 深入 研究 C# 的 dynamic 关 键 字 之 前 ， 先 创建 一 个 名 为 DynamicKeyword 的 控制 台 应 用 程序 。 
接 下 来 ， 在 Program 类 中 创建 下 面 的 方法 ， 并 确保 如 果 没 有 注释 掉 最 后 一 行 语句 将 会 触发 一 个 编译 时 
错误 。 

static void ImplicitlyTypedVariable() 


// a 为 List<int> 类 型 
var a = new List<int>(); 
a.Add(90); 


// 下 面 这 一 行将 导致 编译 时 错误 
) J a= "Hello, 





GD DLR 是 以 NET 为 基础 的 诸如 IronPython 和 IronRuby 之 类 的 动态 语言 核心 。 它 提供 了 一 个 环境 ， 可 以 很 容易 地 实现 
动态 语言 ， 以 及 添加 动态 能 力 到 C# 这 样 的 静态 类 型 语言 。 编者 注 
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仅仅 为 了 使 用 隐 式 类 型 而 使 用 隐 式 类 型 被 很 多 人 认为 是 一 个 糟糕 的 编程 风格 ( 如 果 你 确定 需要 一 
个 List<int>， 那 就 声明 一 个 List<int> 吧 )。 但 是 在 第 13 章 中 你 已 经 看 到 ， 隐 式 类 型 对 于 LINQ 来 说 是 
非常 有 用 的 ， 因 为 很 多 LINQ 查 询 都 会 返回 ( 经 过 投影 的 ) 匿名 类 型 的 枚 举 ， 而 这 种 匿名 类 是 无 法 在 
C# 代 码 中 直接 声明 的 。 但 即使 在 这 种 情况 下 ， 这 些 隐 式 类 型 变量 实际 上 也 是 强 类 型 的 。 

同样 ， 在 第 6 章 中 我 们 了 解 到 System.0bject 是 .NET Framework 的 顶级 父 类 ， 可 以 代表 任何 类 型 。 
那么 如 果 声 明了 一 个 object 类 型 的 变量 ， 就 会 得 到 一 个 强 类 型 的 数据 ， 尽 管 它 所 指向 的 内 存 区 域 会 因 
引用 的 分 配 而 有 所 不 同 。 为 了 访问 内 存 中 该 对 象 引 用 所 指向 的 成 员 ， 需 要 进行 显示 转换 。 

假设 有 一 个 Person 类 ， 它 包含 两 个 类 型 为 string 的 自动 属性 ( FirstName 和 LastName )。 如 下 面 的 代 
码 所 示 : 

static void UseObjectVarible() 


// 假设 已 经 存在 一 个 名 为 Person 的 类 
object o = new Person() { FirstName = "Mike", LastName = "Larson" }; 


// 要 访问 Person 的 属性 ， 必 须 将 object 转 换 为 Person 
Console.WriteLine("pPerson's first name is {0}", ((Person)o).FirstName); 


随 着 .NET 4.0 的 发 布 ，C#i 在 言 引 入 一 个 关键 字 dynamic。 从 高 层 看 ,我 们 可 以 把 任何 值 设 置 为 动态 
的 数据 类 型 ， 因 此 可 以 认为 dynamic 关 键 字 是 一 个 特殊 形式 的 System.0bject。 乍 看 上 去 ， 这 似乎 很 容 
易 混 淆 ， 因 为 我 们 已 经 有 了 三 种 定义 数据 的 方法 ， 这 些 数据 的 实际 类 型 不 是 直接 在 代码 库 中 指定 的 。 
例如 下 面 的 方法 : 


static void PrintThreeStrings() 


Var s1 = "Greetings"; 
object s2 = "From"; 
dynamic s3 = "Minneapolis"; 


Console.WriteLine("s1 is of type: {0}", si1.GetType()); 


Console.WritelLine("s2 is of type: {0}", s2.GetType()); 
Console.WritelLine("s3 is of type: {0}", s3.GetType()); 


将 打印 出 如 下 的 内 容 : 





s1 is of type: System.String 
S2 is of type: System.String 
s3 is of type: System.String 





动态 类 型 之 所 以 与 隐 式 声明 的 类 型 或 者 通过 System.0bject 引 用 声明 的 类 型 有 着 巨大 的 不 同 , 是 因 
为 动态 类 型 不 是 强 类 型 的 。 或 者 说 ， 动 态 数据 不 是 静态 类 型 (statically typed )。 对 于 C# 编 译 器 来 说 ， 
通过 dynamic 关 键 字 声明 的 数据 点 可 以 分 配 任意 初始 值 ， 而 且 可 以 在 其 生命 周期 内 重新 分 配 任何 新 的 
(甚至 可 能 无 关 的 ) 值 。 来 看 下 面 的 代码 及 其 输出 结果 : 


static void ChangeDynamicDataType() 
{ 


// 声明 一 个 名 为 t 的 动态 数据 点 
dynamic t = "Hello!"; 
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Console.WritelLine("t is of type: {0}", t.GetType()); 


t = false; 
Console.WritelLine("t is of type: {0}", t.GetType()); 


t = new List<int>(); 
Console.WritelLine("t is of type: {0}", t.GetType()); 





t is of type: System.String 
t is of type: System.Boolean 
t is of type: System.Collections.Generic.List 1[System.Int32] 





在 学 习 过 程 中 你 会 发 现 ， 上 面 的 代码 如 果 把 变量 t 声 明 为 System.0bject， 那 么 编译 过 程 和 执行 结 
果 会 完全 相同 。 但 是 一 会 儿 你 就 会 察觉 ，dynamic 关 键 字 提供 了 很 多 其 他 特性 。 


16.1.1 调用 动态 声明 的 数据 的 成 员 


由 于 动态 数据 类 型 可 以 在 运行 时 代表 任何 类 型 ( 就 像 一 个 System.0bject 类 型 的 变量 )， 那 么 接 下 
来 你 可 能 要 问 如 何 调 用 动态 变量 的 成 员 ( 属性 、 方 法 、 索 引 器 、 注 册 事 件 ， 等 等 )。 其 实 ， 在 语法 上 
它们 仍然 没有 什么 区 别 。 你 只 需要 在 动态 数据 变量 后 面 加 一 个 点 (“.”)， 然 后 指定 其 公共 成 员 ， 并 在 
必要 时 提供 相应 的 参数 。 

但 是 ， 编 译 器 将 不 会 检查 你 所 指定 的 成 员 的 有 效 性 ! 记 住 , 与 5ystem.0bject 定 义 的 变量 不 同 , 动 
态 数据 不 属于 静态 类 型 。 直 到 运行 时 你 才 会 知道 所 调用 的 动态 数据 是 否 支持 指定 的 成 员 、 所 传递 的 参 
数 是 否 正确 以 及 成 员 的 拼写 是 否 准确 无 误 ， 等 等 。 因 此 ， 下 面 的 代码 可 以 通过 编译 ， 尽 管 它 看 上 去 可 
能 很 奇怪 : 


static void InvokeMembersOnDynamicData() 


dynamic textDatal = "Hello"; 
Console. WriteLine(textDatal ToUpper()); 


// 你 可 能 认为 下 面 的 代码 会 有 编译 错误 ， 但 实际 上 它们 能 通过 编译 
Console.Writeline(textData1.toupper()); 
Console.WritelLine(textData1.Foo(10, "ee", DateTime.Now)); 


你 可 能 会 注意 到 第 二 次 调用 WriteLine() 时 程序 试图 调用 动态 数据 点 的 toupper() 方 法 。 如 你 所 见 ， 
textDatal 为 string 类 型 ， 并 不 包含 所 有 字母 均 为 小 写 的 同名 方法 。 并 且 ，string 也 不 包含 名 为 Foo() 
参数 分 别 为 int 、string、DateTime 类 型 的 方法 ! 

但 是 这 已 经 符合 了 C# 编 译 器 的 要 求 。 只 不 过 在 Main() 方 法 中 调用 该 方法 时 ， 将 会 得 到 如 下 所 示 的 
运行 时 错误 : 





未 处 理 的 异常 : Microsoft.CSharp.RuntimeBinder.RuntimeBinderException: 
“String "不 包含 名 为 "toupper 的 定义 。 
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调用 动态 数据 的 成 员 与 调用 强 类 型 数据 的 成 员 之 时 ， 另 一 个 明显 的 差别 是 ， 如 果 在 动态 数据 之 后 
输入 “.” 操 作 符 ，Visual Studio 将 不 会 显示 期 望 的 智能 感知 ， 而 是 得 到 如 图 16-1 所 示 的 提示 。 








Program.cs” +H X Object Browser : | 2 ba 
DynamicKeyword.Program ~ ®, InvokeMembersOnDynamicData0) = 
} - 
ie static void InvokeMembersOnDynamicDatat ) 
{ 
Fo textDatal = "Hello”; 
Consoles,. = ,WritelLine(textDatali .ToUpper()); 
textDatal. PE A as 
| | Chia expression) | 区 
， 77 YOu wou This operation will be resolved at runtime, | 三 
FA But wh 让 和 i | | 
| Console， WriteLine(textDatal. toupper ()); 
| Console,.WritelLine(textDatai.Foo(10, "ee”, DateTime .Now)); 
100% 人 | ee se ddd ee 2 二 i | 


图 16-1 动态 数据 不 会 激活 智能 感知 


动态 数据 无 法 使 用 智能 感知 是 可 以 理解 的 。 但 这 也 意味 着 在 编写 包含 这 种 数据 点 的 C# 代 码 时 需要 
格外 小 心 。 任 何 成 员 的 拼写 或 大 小 写 错误 都 会 抛 出 运行 时 错误 ， 通 常 是 RuntimeBinderException 类 的 
一 个 实例 。 


16.1.2 ”Microsoft.CSharp.dll 程 序 集 的 作用 


当 使 用 Visual Studio 新 建 一 个 C# 项 目 时 , 将 自动 引用 一 个 名 为 Microsoft.CSharp.dll 的 程序 集 ( 可 以 
在 Solution Explorer 的 References 文 件 夹 下 找到 )。 这 个 库 非常 小 ， 只 定义 了 一 个 命名 空间 
( Microsoft.CSharp.RuntimeBinder ) 和 两 个 类 ( 如 图 16-2 所 示 )。 


Pregram'cs .Object Browser + X 
Browse: My Solution ww | ji [oe 。 - 
<Search> » -= 
b DynamicKeyword 区 


Ps Microsott.Coharp 


4 {} Microsoft .CSharp,RuntimeBinder 





| Assembly Microsoft.CSharp jn 


b We RurtimeBinderExceptien | rg 
b By RuntimeBinderintemalCompilerException 到 | Member of .NET Framework 4.5 MY La 
1 ‘Solution 
bw mocorlib | 有 
《APrograrm Files (X86jXReference 
bP System | 生生 
Di “Assemblies\Microsoft\Franmework 
Ee ~ \NETFramework\vd4.5\Microsoft.Csharpdil 
by wr Systerri.Data 
> Systern. Do. DataSetExtensions - Attributes: S 


图 16-2 ”Microsoft.CSharp.dll 程 序 集 
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顾名思义 ， 这 两 个 类 为 强 类 型 的 异常 类 。RuntimeBinderException 是 最 普通 的 类 ， 如 果 试 图 调用 
一 个 不 存在 的 动态 数据 类 型 的 成 员 , 将 会 抛 出 该 异常 ( 比如 调用 toupper() 和 Foo() 方 法 )。 如 果 调 用 了 
一 个 存在 的 成 员 但 却 指定 了 错误 的 参数 数据 ， 将 同样 会 抛 出 该 异常 。 
由 于 动态 数据 的 这 种 不 确定 性 ， 在 调用 用 C# 的 dynamic 关 键 字 声明 的 变量 的 成 员 时 ， 可 以 用 合适 
的 try/catch 块 来 包 庄 ， 并 以 一 种 优雅 的 方式 来 处 理 异 常 。 如 下 所 示 : 
static void InvokeMembersOnDynamicData() 
dynamic textDatal = "Hello"; 
try 
Console.Writeline(textData1. ToUpper()); 
Console.WriteLine(textData1.toupper()); 
Console.WritelLine(textData1.Foo(10, "ee", DateTime.Now)); 
catch (Microsoft.CSharp.RuntimeBinder.RuntimeBinderException ex) 
Console.WriteLine(ex.Message); 
} 
} 
在 调用 这 个 方法 时 ， 会 发 现 对 ToUpper() 方 法 ( 注意 T 和 U 这 两 个 字母 ) 的 调用 正确 无 误 ， 但 控制 
台 上 还 是 会 显示 一 条 错误 数据 。 





HELLO 
"String” does not contain a definition for “touppeT” 





当然 ,如 果 将 所 有 动态 方法 的 调用 都 用 try/catch 块 来 包 右 ， 这 个 过 程 将 是 十 分 麻烦 的 。 只 要 注意 
了 拼写 和 参数 传递 ， 就 没有 必要 都 进行 包 右 。 但 是 ， 当 你 不 确定 目标 类 型 是 否 包含 某 个 成 员 的 时 候 ， 
如 果 用 try/catch 块 来 进行 包 奢 的话， 那么 异常 的 捕获 就 会 十 分 方便 了 。 


16.1.3 ”dynamic 关 键 字 的 作用 域 


( 用 var 关 键 字 声明 的 ) 隐 式 类 型 数据 只 能 作为 一 个 成 员 范 围 内 的 本 地 变量 。var 关 键 字 不 能 用 于 
返回 值 、 参 数 或 类 /结构 的 成 员 。 但 对 于 dynamic 关 键 字 来 说 ， 这 都 不 是 问题 。 来 看 下 面 这 个 类 的 定义 : 


class VeryDynamicClass 


// 动态 字段 
private static dynamic myDynamicField; 


// 动态 属性 
public dynamic DynamicProperty { get; set; } 


// 动态 返回 值 类 型 和 动态 参数 类 型 


public dynamic DynamicMethod(dynamic dynamicparam) 


// 动态 本 地 变量 
dynamic dynamicLocalVar = "Local variable"; 


int myInt = 10; 
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if (dynamicParam is int) 
return dynamicLocalVar; 
else 


return myInt; 


} 
} 


现在 你 可 以 如 愿 调用 这 些 公共 成 员 了 , 但 由 于 所 操作 的 是 动态 方法 和 属性 ， 因 此 并 不 能 完全 确定 
它们 的 数据 类 型 ! 可 以 肯定 ， 这 个 VeryDynamicClass 类 在 实际 的 应 用 程序 中 用 处 不 大 ， 但 它 确实 演示 
了 dynamic 关 键 字 的 作用 域 。 


16.1.4 _ dynamic 关键 字 的 限制 


虽然 dynamic 关 键 字 可 以 定义 很 多 东西 , 但 它 使 用 起 来 也 存在 一 些 限 制 。 尽 管 甫 不 掩 瑜 , 但 你 仍然 
要 清楚 的 是 ， 在 调用 一 个 动态 数据 的 方法 时 ， 不 能 使 用 Lambda 表 达 式 和 C# 匿 名 方法 。 例 如 ， 即 使 目 
标 方法 的 参数 确实 是 一 个 值 为 string 并 返回 void 的 委托 ， 但 下 面 的 代码 也 总 是 会 报错 。 

dynamic a = GetDynamicObject(); 

// 错误 ! 动态 数据 的 方法 不 能 使 用 Lambda 表 达 式 

a.Method(arg => Console.Writeline(arg)); 

要 避免 这 个 限制 , 可 以 直接 使 用 基本 的 委托 , 详 见 第 10 章 中 描述 的 各 种 技术 ( 匿名 方法 、Lambda 
表达 式 等 )。 另 一 个 限制 是 动态 数据 点 无 法 理解 扩展 方法 ( 见 第 11 章 )。 不 幸 的 是 ，LINQ API 所 提供 的 
所 有 扩展 方法 也 都 包含 在 内 。 因 此 ， 用 dynamic 关 键 字 声明 的 变量 不 能 用 于 LINQ to Object 以 及 其 他 
LINQ 技 术 : 

dynamic a = GetDynamicObject(); 


// 错 误 ! 无 法 找到 动态 数据 的 Select() 扩 展 方法 
var data = from d in a select di 


16.1.5 ”dynamic 关 键 字 的 实际 用 途 


动态 数据 不 是 强 类 型 的 ， 无 法 进行 编译 时 检查 ， 不 能 触发 智能 感知 并 且 无 法 进行 LINQ 查 询 ， 因 
此 ， 认 为 为 了 使 用 dynamic 关 键 字 而 使 用 它 是 非常 差 的 编程 实践 一 点 也 没有 错 。 

但 是 在 某 些 场景 中 , dynamic 关 键 字 可 以 显著 地 减少 手工 输入 的 代码 量 。 特别 是 在 构建 一 个 需要 大 
量 使 用 后 期 绑 定 (通过 反射 ) 的 .NET 应 用 程序 时 ，dynamic 关 键 字 可 以 节省 大 量 打字 时 间 。 同 样 ， 如 
果 构 建 一 个 需要 与 遗留 的 COM 库 ( 如 微软 Office 产 品 ) 进行 交互 的 .NET 应 用 程序 ， 可 以 使 用 dynamic 
关键 字 极 大 地 简化 代码 库 。 

和 其 他 “捷径 ”一 样 ， 你 需要 权衡 利弊 。 使 用 dynamic 关 键 字 是 在 用 类 型 的 安全 性 来 换取 代码 的 简 
洁 度 。 由 于 C# 本 质 上 还 是 一 门 强 类 型 的 语言 ， 因 此 你 需要 分 析 应 用 场景 来 决定 是 否 使 用 动态 行为 。 要 
记 住 dynamic 关 键 字 并 不 是 必需 的 。 你 总 是 可 以 手工 编写 替换 代码 ( 通常 要 远 远 多 于 使 用 dynamic 关 键 
字 的 代码 ) 来 得 到 同样 的 结果 。 
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源 代码 DynamicKeyword 项 目的 源 代码 位 于 Chapter 16 子 目录 下 。 


16.2 DLR 的 作用 


既然 已 经 理解 了 什么 是 “动态 数据 "， 接 下 来 我 们 将 学 习 如 何 处 理 这 种 动态 数据 。DLR 随 .NET4.0 
一 起 发 布 ， 它 是 作为 CLR ( Common Language Runtime， 公 共 语 言 运行 时 ) 的 补充 的 运行 时 环境 。“ 动 
态 运 行 库 ”( dynamic runtime ) 当然 不 是 新 概念 。 事 实 上 很 多 编程 语言 ， 如 Smalltalk 、LISP、Ruby 和 
Python， 已 经 使 用 这 个 概念 很 多 年 了 。 简 单 地 说 ， 动 态 运 行 时 允许 动态 语言 完全 在 运行 时 发 现 类 型 ， 
而 不 进行 编译 时 检查 。 

如 果 你 有 强 类 型 语言 (包括 不 含 动态 类 型 的 C# 香 言 ) 的 背景 知识 ,这 种 运行 时 的 概念 可 能 看 上 去 
不 太 受 欢迎 。 毕 竟 在 任何 可 能 的 地 方 ， 你 只 希望 得 到 编译 时 错误 ， 而 不 是 运行 时 错误 。 不 过 动态 语言 
/运行 时 确实 提供 了 下 面 一 些 有 趣 的 特性 。 

口 极其 灵活 的 代码 库 。 在 重 构 时 不 需要 频繁 修改 数据 类 型 。 

口 在 不 同 平 台 和 编程 语言 所 创建 的 对 象 类 型 之 间 进 行 互 操作 非常 简便 。 

口 可 以 在 运行 时 为 内 存 中 的 类 型 添加 或 移 除 成 员 。 

DLR 的 一 个 作用 是 使 不 同 的 动态 语言 能 够 在 .NET 运行 时 运行 ， 并 提供 一 种 与 其 他 .NET 代 码 进行 
交互 的 方式 。 两 个 最 受 欢 迎 的 使 用 DLR 的 动态 语言 是 IronPython 和 IronRuby。 这 两 种 语言 属于 动态 领域 ， 
它们 的 类 型 只 有 在 运行 时 才能 被 发 现 。 不 过 它们 都 可 以 使 用 .NET 丰富 的 基础 类 库 。 更 妙 的 是 ， 由 于 
dynamic 关 键 字 的 引入 ， 它 们 的 代码 库 可 以 与 C# 进 行 互 操作 〈 反 之 亦 然 )。 


说 明 本 章 不 会 介绍 如 何 用 DLR 与 动态 语言 集成 。 详 细 内 容 请 参考 IronPython ( http://ironpython. 
codeplex.com ) 和 IronRuby (http://rubyforge.org/projects/ironruby ) 网 站 。 


16.2.1 表达 式 树 的 作用 
DLR 在 非特 定 条 件 下 使 用 表达 式 树 来 获取 动态 调用 的 含义 。 例 如 ， 当 DLR 遇 到 如 下 的 C# 代 码 时 ; 


dynamic d = GetSomeData(); 
d.SuperMethod(12); 


它 将 自动 创建 一 个 表达 式 树 ,“ 调 用 对 象 d 的 SuperMethod 方 法 ， 并 将 数字 12 作 为 参数 ”。 然 后 ， 该 
信息 (正式 的 名 称 为 有 效 载荷 ) 被 传递 给 正确 的 运行 时 绑 定 器 ( binder )， 可 能 仍然 是 C# 动 态 绑 定 器 ， 
也 可 能 为 IronPyton 动 态 绑 定 器 ， 甚 至 遗留 的 COM 对 象 ( 稍 后 会 进行 解释 )。 

这 时 ， 请 求 被 映射 到 目标 对 象 所 需 的 调用 结构 。 表 达 式 树 ( 实际 上 我 们 并 不 需要 手动 创建 它们 ) 
所 带 来 的 好 处 是 ,我们 可 以 编写 固定 的 C# 河 句 ， 而 不 必 担 心 潜在 的 目标 究竟 是 什么 (COM 对 象 、 
IronPython 和 IronRuby 代 码 库 ， 等 等 )。 图 16-3 从 较 高 的 层次 演示 了 表达 式 树 的 概念 。 
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IronRuby 或 


dynamic d = GetSomeData(); Troripvth ee 
d.SuperMethod(12); COM 绑 定 器 都 定 器 .NET 绑 定 器 
大- 卡 .NET 动 态 语 言 运行 时 
表达 式 树 ”一 《DER 


.NET 公 共 语 言 运行 时 (CLR) 
图 16-3 ”表达 式 树 在 非特 定 条 件 下 获取 动态 调用 并 通过 绑 定 器 进行 处 理 


16.2.2 ”System.Dynamic 命 名 空间 的 作用 


System.Dynamic 命 名 空间 放置 于 System.Core.dl] 程 序 集 中 。 说 实话 ， 我 们 几乎 不 需要 使 用 该 命名 空 
间 中 的 类 型 。 但 如 果 作 为 一 个 语言 供应 商 ， 和 希望 让 自己 的 动态 语言 与 DLR 进行 交互 ， 那 么 就 需要 使 用 
System.Dynamic 命 名 空间 来 创建 一 个 自 定义 的 运行 时 绑 定 器 。 

同样 也 不 必 深 究 本 书 提 到 的 System.Dynamic 中 的 类 型 ， 但 如 果 感 兴趣 可 以 随时 查询 .NET Framewrok 4.5 
SDK 文 档 。 出 于 实际 的 目的 ， 只 需要 简单 地 知道 该 命名 空间 提供 了 必要 的 结构 ,使 得 一 门 .NET 语 言 具 
备 动态 的 特性 。 


16.2.3 ”表达 式 树 的 动态 运行 时 查找 


如 前 所 述 ，DLR 将 表达 式 树 传 递 给 目标 对 象 。 但 这 种 指派 会 受到 一 些 因素 的 影响 。 如 果 动 态 数据 
类 型 指向 一 个 内 存 中 的 COM 对 象 ， 那 么 表达 式 树 将 被 发 送 给 一 个 低级 别 的 COM 接 口 IDispatch。 正 如 
你 可 能 知道 的 那样 ， 该 接口 以 COM 的 方式 合并 了 它 本 身 的 动态 服务 集 。 虽 然 你 可 以 在 .NET 应 用 程序 
中 不 通过 DLR 和 C# 的 dynamic 关 键 字 而 使 用 COM 对 象 ， 但 这 往往 会 导致 更 加 复杂 的 C# 代 码 ( 稍 后 将 会 
看 到 )。 

如 果 动 态 数据 指向 的 不 是 COM 对 象 ， 那 么 表达 式 树 将 可 能 传递 给 实现 了 IDynamicobject 接 口 的 对 
象 。 该 接口 在 后 台 使 用 ， 它 支持 类 似 IronRuby 那 样 的 语言 接收 一 个 DLR 表达 式 树 ， 并 将 其 映射 到 Ruby 
特性 (Ruby Specifics )。 

最 后 ， 如 果 动 态 数据 既 不 指向 COM 对 象 ， 也 不 指向 实现 IDynamicObject 接 口 的 对 象 ， 而 是 指向 一 
个 普通 的 ,NET 对象， 那么 表达 式 树 会 指派 给 C# 和 运行 时 绑 定 器 来 进行 处 理 ， 并 且 会 将 其 映射 到 NET 的 
细节 。 这 个 映射 过 程 包含 了 反射 服务 。 

表达 式 树 交 给 一 个 给 定 的 绑 定 器 进行 处 理 后 ， 当 包含 必要 参数 的 方法 被 正确 地 调用 之 后 ， 动 态 数 
据 将 被 解析 为 真正 的 内 存 中 的 数据 类 型 。 现 在 ， 让 我 们 来 看 一 些 DLR 的 实际 应 用 ， 就 从 简化 后 期 绑 定 
的 .NET 调 用 开始 吧 。 
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16.3 ”使 用 动态 类 型 简化 后 期 绑 定 调用 


在 使 用 反射 服务 时 , 你 也 许 会 决定 使 用 dynamic 关 键 字 , 特别 在 是 进行 后 期 绑 定 的 方法 调用 时 。 在 
第 15 章 中 ,我 们 举 了 一 些 例子 介绍 了 使 用 这 种 非常 有 用 的 方法 的 最 佳 时 机 是 在 创建 扩展 的 应 用 程序 
时 。 在 第 15 章 我 们 学 习 了 如 何 使 用 Activator.CreateInstance() 方 法 创建 一 个 object, 除了 它 的 显示 名 
称 之 外 , 我 们 不 知道 任何 有 关 这 个 对 象 的 编译 时 信息 。 接 下 来 可 以 使 用 System.Reflection 命 名 空间 下 
的 类 型 通过 后 期 绑 定 来 调用 其 成 员 。 回 忆 一 下 第 15 章 中 的 这 个 例子 : 

static void CreateUsingLateBinding(Assembly asm) 


ty 


// 获取 Minivan 类 型 的 元 数据 
Type miniVan = asm.GetType("CarlLibrary.MiniVan"); 


// 在 运行 时 创建 Minivan 类 型 
object obj = Activator.CreateInstance(miniVan); 


// 获取 TurboBoost 的 信息 
MethodInfo mi = miniVan.GetMethod("TurboBoost"); 


// 调用 方法 ('null' 代 表 没 有 参数 ) 
mi.Invoke(obj, null); 


catch (Exception ex) 
Console.WritelLine(ex.Message); 
) } 
虽然 这 段 代码 运行 良好 ， 但 却 不 得 不 承认 它 有 一 点 笨拙 。 我 们 必须 手动 使 用 MethodInfo 类 、 手 动 
查询 元 数据 ， 等 等 。 现 在 我 们 使 用 C# 的 dynamic 关 键 字 和 DLR 来 重 写 这 个 方法 : 
void InvokeMethodwithDynamicKeyword(Assembly asm) 
try 


// 获取 Minivan 类 型 的 元 数据 
Type miniVan = asm.GetType("CarLibrary.MiniVan"); 


// 在 运行 时 创建 Minivan 并 调用 其 方法 
dynamic obj = Activator.CreateInstance(miniVan); 
obj.TurboBoost(); 
catch (Exception ex) 
Console.WritelLine(ex.Message); 
} 
使 用 dynamic 关 键 字 来 声明 obj 变 量 ， 可 以 用 DLR 优 雅 地 实现 烦琐 的 反射 操作 。 
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利用 dynamic 关 键 字 传递 参数 


当 你 需要 通过 后 期 绑 定 调用 包含 参数 的 方法 时 ，DLR 的 好 处 就 更 加 明显 了 。 使 用 “ 宛 长 ”的 反射 调 
用 时 ， 需 要 将 所 有 参数 打包 到 一 个 object 数 组 中 ， 然 后 将 这 个 数组 传递 给 MethodInfo 的 Invoke() 方 法 。 

为 了 用 一 个 全 新 的 示例 来 进行 演示 ， 我 们 先 来 创建 一 个 C# 控 制 台 应 用 程序 LateBinding- 
WithDynamic。 然后 在 当前 解决 方案 下 添加 一 个 类 库 项 目 MathLibrary ( 使 用 File 一 Add New Project... 菜 
单项 )。 将 MathLibrary 项 目 初始 的 Classl.cs 文 件 重 命名 为 SimpleMath.cs， 并 用 如 下 的 代码 来 实现 : 


public class SimpleMath 
public int Add(int x, int y) 
{ 
return x + yj 
3} 
} 
在 编译 MathLibrary .dl1 程 序 集 时 ， 将 其 复制 一 份 放 到 LateBindingWithDynamic 项 目的 \bin\iDebug 文 
件 夹 下 (也 可 以 单 击 Solution Explorer 下 各 个 项 目的 Show All Files 按 钮 ， 然 后 在 项 目 之 间 拖 忠文 件 )。 
这 时 ，Solution Explorer 将 如 图 16-4 所 示 。 


:SOLUTION EXPLORER : a 
臣 疙 全 国名 | 上 | 国 @ | 加 钱 


Search Solution Explorer (Ctri+a 
图 Solution 'LateBindingWithDynamic' (2 projects) 
4 EE LateBindingWithDynamic 
b ££ properties 
b wu References 
i bin 


LateBindingWithDynamic.exe 

LateBindingWithDynamic.exe,.config 

LateBindingWithDynamic.pdb 

LateBindingWithDynamic.vshost.exe 

LateBindingWithDynamic.vshost,exe.config 

LateBindingWithDynamic.yshost,exe.manifest 
网 Mathtibrary.di 


外 App.config 
pb ce Program.cs 
4 MathLibrary 
b ££ Properties 
bp 亚 攻 References 


Ei obj 
b cs SimplelMath, Cs 
SOLUTION EXPLORER TEAM EXPLORER 





图 16-4 LateBindingWithDynamic 项 目 包 含 一 个 私有 的 MathLibrary.dll 副 本 
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说 明 记 住 ， 后 期 绑 定 的 关键 在 于 允许 应 用 程序 在 没有 某 个 对 象 的 清单 数据 ( manifest ) 的 情况 下 创 
建 该 对 象 。 因 此 我 们 将 MathLibrary.dl11 手 动 复制 到 控制 台 项 目的 输出 文件 夹 下 ， 而 没有 使 用 

Visual Studio 添 加 该 程序 集 的 引用 。 





现在 ， 在 控制 台 应 用 程序 项 目的 Program.cs 文 件 中 引入 System.Reflection 命 名 空间 。 然 后 在 
Program 类 中 添加 如 下 的 方法 。 该 方法 使 用 典型 的 反射 API 调 用 Add() 方 法 。 
private static void AddwithReflection() 
Assembly asm = Assembly.Load("MathLibrary"); 


try 


// 获取 SimpleMath 类 型 的 元 数据 
Type math = asm.GetType("MathLibrary.SimpleMath"); 


// 在 运行 时 创建 SimpleMath 
object obj = Activator.CreateInstance(math); 


// 获取 Add 方 法 的 信息 
MethodInfo mi = math.GetMethod("Add"); 


// 调用 方法 (包含 其 参数 ) 

object[] args = { 10, 70 }; 

Console.WriteLine("Result is: {0}", mi.Invoke(obj; args)); 
catch (Exception ex) 


Console.WriteLine(ex.Message); 


} 
现在 ， 思考 一 下 如 何 通 过 下 面 的 新 方法 使 用 dynamic 关 键 字 来 简化 上 述 逻 辑 : 
private static void AddwithDynamic() 

Assembly asm = Assembly.Load("MathLibrary"); 


try 
{ 
// 获取 SimpleMath 类 型 的 元 数据 
Type math = asm.GetType("MathLibrary.SimpleMath"); 


// 在 运行 时 创建 SimpleMath 
dynamic obj = Activator.CreateInstance(math); 
Console.WriteLine("Result is: {0}", obj.Add(10, 70)); 
catch (Microsoft.CSharp.RuntimeBinder.RuntimeBinderException ex) 
Console.WriteLine(ex.Message); 
于 
不 错 吧 ! 在 Main() 方 法 中 调用 这 两 个 方法 将 得 到 同样 的 输出 结果 。 但 是 使 用 dynamic 关 键 字 可 以 节 
省 相当 多 的 工作 量 。 使 用 动态 定义 的 数据 时 ， 你 不 必 手 动 将 参数 打包 成 对 象 数组 ， 也 不 必 手 动 查询 程 
序 集 元 数据 等 其 他 类 似 的 细节 。 如 果 你 正在 构建 大 量 使 用 动态 加 载 和 后 期 绑 定 的 应 用 程序 ， 你 肯定 会 
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发 现 ， 随 着 时 间 的 推移 ， 这 种 节省 代码 量 的 效果 会 越 来 越 明显 。 





源 代码 ”LateBindingWithDynamic 项 目的 源 代码 位 于 Chapter 16 子 目录 下 。 
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现在 我 们 来 看 看 dynamic 关 键 字 在 一 个 与 COM 互 操作 的 项 目 中 所 发 挥 的 巨大 作用 。 如 果 你 没有 丰 
富 的 COM 开 发 背景 ， 那 么 只 需要 知道 本 例 中 编译 好 的 COM 库 和 其 他 .NET 库 一 样 包含 元 数据 ， 只 不 过 
它们 的 格式 是 完全 不 同 的 。 因 此 ， 如 果 某 个 ,NET 程序 要 与 COM 对 象 通信 ， 第 一 个 步 又 就 是 生成 一 个 
大 家 所 熟悉 的 “ 互 操作 程序 集 ”( 稍 后 会 介绍 )。 这 一 步 是 非常 简单 的 ， 只 需要 激活 Add Reference 对 话 
框 ， 选 择 COM 选 项 卡 找到 要 使 用 的 COM 库 〈 如 图 16-5 所 示 )。 


Reference Manager - LateBindingWithDynamic 





Pb Acsemblies arch COM 


i Name i i i S Name: 
TA es 1 Accessibility 
~ AccessibilityCpIAdmin 1 10° Type Library 1 Created by: 
Acrobst Access 30 Type Library Microsoft Corporation 
AcroBrokerLib 4 Version: 
AcrolfHeiper 10 Type Library 3 
AcrolfHeiperShim 1.0 Type Library 
Active DS Type Library 
Adobe Acrobat 7.0 Browser Control Type Library... 
Adobe Acrobat 8.0 Type Library 11 
Adobe Reader File Preview Type Library 
AFormAu 1.0 Type Library 
AgControl 4.0 Type Library 
AgControl 50 Type Library 
AP Client 1.0 Helppane Type Libtary 
Ap Chient 10 Type Library 
AppldPolicyEngineApi 1.0 Type Library 
Apple Bonicur Library 10 
Apple Nicbile Documents AP! 
Annie NairyTime Contrnl 





File Yersion: | 
7000 (win7spi_gdr116826-1504} 


sj [ok fg Censel | | 
图 16-5 Add Reference 对 话 框 的 COM 选 项 卡 显示 了 电脑 中 所 有 已 注册 的 COM 库 











说 明 要 知道 一 些 重要 的 微软 对 象 模型 ( 包括 Office 产 品 ) 现在 已 经 可 以 通过 COM 互 操作 来 访问 了 。 
因此 ， 即 使 你 没有 直接 构建 COM 应 用 程序 的 经 验 ， 也 可 以 在 .NET 程 序 中 使 用 它们 。 

选择 了 一 个 COM 库 后 ，IDE 将 为 我 们 生成 一 个 全 新 的 程序 集 ， 该 程序 集 包 含 COM 元 数据 的 .NET 
描述 。 其 正式 的 名 称 为 互 操 作 程 序 集 (interoperability assembly， 或 简写 为 interop assembly )。 互 操作 
程序 集中 除了 有 一 小 部 分 将 COM 事 件 转换 为 .NET 事 件 的 代码 之 外 ， 不 包含 任何 实现 代码 。 互 操作 程 
序 集 使 ,NET 代码 库 避 人 免 了 内 部 COM 的 复杂 性 ， 因 此 是 非常 有 用 的 。 

由 于 CLR (如 果 使 用 dynamic 关 键 字 的 话 就 是 DLR ) 可 以 自动 对 .NET 数 据 类 型 和 COM 类 型 进行 映 
射 ， 因 此 可 以 直接 在 C# 代 码 中 使 用 互 操 作 程 序 集 。 在 后 台 ， 使 用 Runtime Callable Wrapper (RCW ) 对 
数据 进行 封 送 ， 使 其 在 NET 和 COM 应 用 程序 之 间 交 互 。 从 根本 上 说 ，RCW 是 一 个 动态 生成 的 代理 ， 
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它 对 .NET 数 据 类 型 进行 封装 并 转换 为 COM 类 型 ， 将 COM 的 返回 值 映射 为 等 价 的 .NET 类 型 。 图 16-6 显 
示 了 .NET 与 COM 进 行 交 互 的 全 景 图 。 


忆 


CO- 未 托管 

A ROW -六 QO co 对 象 

未 托管 > O 〇 一 未 托管 
COM 对 象 Bn a GO- 一 COM 对 象 
A OO 一 未 托管 

ROW 一 co 对 象 


图 16-6 使 用 RCW 代理 使 .NET 程序 与 COM 对 象 交 互 


16.4.1 主 互 操作 程序 集 的 作用 


COM 库 供应 商 创 建 的 很 多 COM 库 ( 如 可 以 访问 微软 Office 产 品 的 对 象 模型 的 微软 COM 库 ) 都 提供 了 
一 个 “官方 ”的 互 操作 程序 集 ， 称 为 主 互 操作 程序 集 ， 简 称 PIA。PIA 是 优化 的 互 操作 程序 集 。 使 用 Add 
Reference 对 话 框 添加 COM 库 的 引用 时 会 生成 一 些 代 码 ，PIA 要 比 这 些 代 码 更 整洁 ， 也 更 具 扩 展 性 。 

PIA 与 核心 的 NET 库 一 样 存 在 于 Add Reference 对 话 框 的 Assemblies 的 列表 中 ( 位 于 Extensions 子 区 
域 )。 事 实 上 ， 如 果 在 Add Reference 对 话 框 的 COM 选 项 卡 中 引用 了 一 个 COM 库 ，Visual Studio 不 会 像 
往常 那样 生成 一 个 新 的 互 操作 库 ， 而 是 会 使 用 提供 的 PIA。 图 16-7 显 示 了 微软 Office Excel 对 象 模型 的 
PIA， 我 们 将 在 下 一 个 示例 中 用 到 它 。 


Raferance Manager ~ ‘latedindingWithDymensc 








Targeting: .NET Framework 4.5 Sesrch Assernbfes 


Name Version Men 
Niicrosoft.Office.Interop.Access 14000 Microsoft.Office.Interop.Excel 
Microsoft.Office.Interop.Access 14000 Created by: 
Microsoft.Office.Interop.Access.Dao 140.00 Microsoft Corporation 
Microsoft.Office.Interop.Access,Dao 12000 dee 
Microsoft.Office.Interop.Access.Dao 140.00 

_ Microsoft.Office interop. Excel N1005 |] 14047561000 
Microsoft.Office Interop,Excel 14000 
Microsoft.Office,Intercp.Excel 12000 
Microsoft,Office,Interop.Graph 14000 
Nicrosoft.Office.Interop.Graph 14000 
Microsoft.Officeinterop.Graph 12000 
Microscf.OfficejnteropjJnfopath 140010 
Nicrosoft.Office.Interop InfoPath 12000 
Microsoft.Office.Interop.InfoPath 14000 
Microsoft.Office,Interop,InfoPath.SemiTrust 11000 
Microsoft.Office.Interop.InfoPath.,SemiTrust 11000 
Microsoft.Office.Interop,InfoPath.SemiTrust 11000 
Nicrnsntt .Office nterne infnpath, Xml lannn 











Browse ] [cence .| | | 
图 16-7 ”PIA 存在 于 Add Reference 对 话 框 .NET 选 项 卡 的 列表 中 
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16.4.2” 骨 入 互 操作 元 数据 


在 .NET 4.0 发 布 之 前 ， 如 果 C# 应 用 程序 要 使 用 COM 库 ( PIA 或 其 他 )， 我 们 需要 确保 客户 端 计 算 机 
上 包含 该 互 操作 程序 集 的 副本 。 这 不 但 会 增加 应 用 程序 安装 包 的 尺寸 ， 而 且 安 装 脚 本 还 必须 检查 PIA 
程序 集 是 否 存 在 ， 如 果 不 存在 还 要 在 GAC 中 安装 副本 。 

然而 在 .NET 4.0 或 更 高 版 本 下 ， 你 可 以 选择 将 互 操 作 数 据 直 接 租 人 到 编译 的 .NET 应 用 程序 中 。 这 
样 ， 必 要 的 互 操作 元 数据 已 经 硬 编码 到 .NET 程 序 中 ,我 们 就 不 必 在 .NET 应 用 程序 中 携带 互 操作 程序 
集 的 副本 了 。 

默认 情况 下 ， 当 使 用 Add Reference 对 话 框 选择 一 个 COM 库 ( PIA 或 其 他 ) 时 ，IDE 会 自动 将 该 库 
的 Embed Interop Types 属 性 设置 为 True。 在 Solution Explorer 的 References 文 件 夹 中 选择 一 个 引用 的 互 操 
作 库 ， 然 后 打开 其 Properties 窗 口 ， 在 该 窗口 中 可 以 第 一 时 间 看 到 这 项 设置 ( 如 图 16-8 所 示 )。 

C# 编 译 器 将 仅 包含 互 操作 程序 集中 你 所 真正 使 用 的 那 部 分 。 因 此 ， 如 果 互 操作 库 包 含 许多 COM 
对 象 的 .NET 描 述 , 你 所 能 得 到 的 仅仅 是 在 C# 代 码 里 真正 使 用 的 那 部 分 子 集 的 定义 。 这 样 做 除了 能 减 小 
发 布 到 客户 端的 应 用 程序 的 规模 ， 而 且 由 于 不 必 在 目标 机 器 上 安装 所 有 缺失 的 PIA， 还 能 简化 安装 
路 径 。 


”DROPERTIES oe 入 人 各 和 人 和 让 仆仆 区 全 代 个 全 全 六 全 全 相 全 人 人 全 区 3 
Microsoft.Office.Interop.Excel Reference Properties 1 
Bl)| BE [80] 和 。 
得 Name) A np Office. | aca 

Aliases global 
Copy Local False 
Culture 

|Description 
True 
File Type Assembly 
Hentity Microsoft.Office.Interop.Excel 
Path C:\Program Files (X86)\Microsoft Visual 
Resolved True 
Runtime Yersion V2.0.50727 
Specific Version True 
Strong Name True 
Version 14.0.0.0 


Ed eres 和 re 
Indicates whether types defined in this assembly will be embedded into the 
target WE 





图 16-8 互 操 作 程序 集 罗 辑 可 以 直接 舱 入 到 .NET 应 用 程序 中 





16.4.3 ”普通 COM 互 操作 的 难点 


在 下 一 个 示例 之 前 ， 我 们 先 来 介绍 另 一 个 预备 话题 。 在 DLR 发 布 之 前 ， 在 编写 需要 使 用 COM 
库 (通过 互 操作 程序 集 ) 的 C# 代 码 时 ， 你 肯定 会 面 对 各 种 各 样 的 挑战 。 例 如 ， 很 多 COM 库 定义 的 
方法 使 用 了 可 选 参数 ，.NET 3.5 之 前 的 C# 不 支持 。 这 就 需要 为 每 个 可 选 参数 指定 Type. Missing 
值 。 比 如 一 个 COM 方 法 包含 5 个 参数 ， 并 且 都 是 可 选 的 ， 那 么 你 需要 编写 如 下 的 C# 代 码 来 接受 默 
认 的 值 : 

myComObj.SomeMethod(Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing); 

幸运 的 是 ， 如 果 不 指定 特殊 的 值 ， 则 可 以 编写 如 下 所 示 的 简化 代码 ，Type.Missing 值 将 在 编译 时 
插入 。 

myComObj .SomeMethod(); 

此 外 ， 很 多 COM 方 法 还 提供 了 对 命名 参数 的 支持 。 正 如 第 4 章 中 所 提 到 的 那样 ， 它 允许 以 任意 顺 
序 向 成 员 传递 参数 。 由 于 C 支 持 了 这 个 特性 ， 因 此 可 以 “ 跳 过 ”我 们 不 关心 的 那些 可 选 参数 ， 而 只 设 
置 我 们 关心 的 参数 。 

COM 互 操作 的 另 一 个 普遍 难点 是 ， 很 多 COM 方 法 的 参数 或 返回 值 都 是 非常 特殊 的 数据 类 型 ， 我 
们 称 之 为 Variant。 与 C# 的 dynamic 关 键 字 类 似 ， 可 以 在 运行 时 将 Variant 数 据 类 型 指定 为 任意 的 COM 
数据 类 型 ( 字符 串 、 接 口 、 引 用 、 数 值 等 )。 在 dynamic 关 键 字 诞 生 之 前 ， 要 想 传 递 和 接收 Variant 数 据 
点 需要 一 些 迁 回 方法 ， 比 如 大 量 的 转换 操作 。 

如 果 将 Embed Interop Types 属 性 设置 为 True， 所 有 的 COM Variant 类 型 都 将 自动 映射 为 dynamic 数 
据 。 这 不 仅 避免 了 在 使 用 COM Variant 数 据 类 型 时 进行 大 量 无 关 的 转换 操作 ,而 且 隐 藏 了 COM 的 一 些 
复杂 性 ， 如 COM 索 引 。 

现在 需要 创建 一 个 使 用 微软 Office 对 象 模型 的 应 用 程序 ， 以 展示 如 何 使 用 C# 的 可 选 参数 、 命 名 参 
数 以 及 dynamic 关 键 字 来 简化 COM 互 操作 。 在 整个 示例 中 ， 我 们 将 使 用 这 些 新 特性 ， 并 将 其 工作 量 与 
不 使 用 时 进行 对 比 。 





说 明 如果 你 没有 Windows Forms 的 背景 ， 可 以 简单 地 在 Visual Studio 中 加 载 完整 的 解决 方案 ， 并 实 
验 这 些 代码 。 不 要 手工 构建 应 用 程序 。 


16.5 ”使 用 C# 动态 数据 进行 COM 互 操作 


假设 我 们 有 一 个 名 为 ExportDataToOfficeApp 的 Windows Form GUI 应 用 程序 , 主 窗 体 中 承载 了 一 个 
名 为 dataGridCars 的 DataGridView 控 件 。 窗 体 中 还 有 两 个 Button 控 件 ， 其 中 一 个 可 以 打开 自 定义 对 话 框 
向 列表 中 插入 一 条 新 的 数据 ， 男 一 个 可 以 将 列表 中 的 数据 导入 到 一 个 Excel 表 格 中 。 图 16-9 显 示 了 完整 
的 GUI。 
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Add New Entry to Inventory 














16-9 COM 互 操作 示例 的 GUI 


我 们 通过 处 理 窗 体 的 Load 事 件 来 给 DataGridview 控 件 填充 一 些 初始 数据 (项目 中 的 car 类 包含 
Color、Make 、PetName 属 性 ， 它 将 作为 List<T> 泛 型 类 的 类 型 参数 ): 
public partial class MainForm : Form 
List<Car> carsInStock = null; 
public MainForm() 


InitializeComponent(); 


private void MainForm Load(object sender, EventArgs e) 
carsInStock = new List<Car> 


new Car {Color="Green", Make="VW", PetName="Mary"}, 
new Car {Color="Red", Make="Saab", PetName="Mel"}, 
new Car {Color="Black", Make="Ford", PetName="Hank"}, 
new Car {Color="Yellow", Make="BMW", PetName="Davie"} 


}; 
UpdateGrid(); 


private void UpdateGrid() 


// 重新 设置 数据 源 
dataGridCars.DataSource = null; 
dataGridCars.DataSource = carsInStock; 





} 
“Add New Entry to Inventory” 按钮 的 Click 事 件 将 打开 一 个 自 定义 的 对 话 框 ,用户 可 以 输入 一 个 Car 
对 象 的 新 数据 ， 然 后 单 击 OK 按 钮 ， 数 据 将 被 添加 到 列表 中 (我 不 打算 给 出 对 话 框 的 后 台 人 代码， 有关 
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细节 请 查看 所 提供 的 解决 方案 ) 并 将 NewCarDialog.cs、NewCarDialog.designer.cs、NewCarDialog. ey 
文件 添加 到 项 目 中 ( 所 有 这 些 文件 都 是 代码 的 一 部 分 )。 完 成 上 述 工作 后 ,为 “Add” 按 钮 在 主 窗 体 的 
click 处 理 程序 提供 如 下 实现 : 


private void btnAddNewCar Click(object sender, EventArgs e) 


NewCarDialog d = new NewCarDialog(); 
if (d.ShowDialog() == DialogResult.0K) 


和 
carsInStock.Add(d.theCar); 
UpdateGrid(); 

} 

“Export Current Inventory to Excel” 按 钮 的 Click 事 件 处 理 程 序 是 该 示例 的 核心 部 分 。 打 开 Add 
Reference 对 话 框 ， 添 加 对 Microsoft.Office.Interop.Excel.dll 主 互 操 作 程 序 集 的 引用 ( 如 前 面 的 图 16-7 所 
示 )。 在 窗 体 的 主 代码 文件 中 添加 如 下 的 命名 空间 别名 。 请 注意 定义 别名 并 不 是 与 COM 库 交互 时 所 必 
需 的 ， 但 这 么 做 可 以 为 所 有 引用 的 COM 对 象 提 供 一 个 方便 的 限定 符 。 当 某 些 COM 对 象 的 名 称 与 你 
的 .NET 类 型 名 称 发 生 冲 突 时 ， 这 么 做 是 十 分 便利 的 解决 方法 。 


// 为 Excel 对 象 模型 创建 一 个 别名 
using Excel = Microsoft.0ffice.Interop.Excel; 


“Export” 按 钮 的 Click 事 件 处 理 程序 调用 了 一 个 私有 的 辅助 函数 ExportToExcel() : 


private void btnExportToExcel Click(object sender, EventArgs e) 


ExportToExcel(carsInStock); 


由 于 我 们 使 用 Visual Studio 引 用 COM 库 ， 所 以 PIA 将 自动 配置 ， 所 需 的 元 数据 将 府 人 到 .NET 应 用 
程序 中 ( Embed Interop Types 属 性 的 作用 )。 因 此 ， 所 有 的 COM Variant 将 被 识别 为 动态 数据 类 型 。 此 
外 ， 我 们 还 可 以 使 用 C# 可 选 参数 和 命名 参数 。 考 虑 如 下 的 ExportToExcel() 实 现 : 


static void ExportToExcel(List<Car> carsInStock) 


// 加 载 Excel， 新 建 一 个 空 的 工作 薄 
Excel.Application excelApp = new Excel.Application(); 
excelApp.Workbooks .Add(); 


// 本 示例 需要 一 个 工作 表 
Excel. Worksheet workSheet = excelApp.ActiveSheet; 


人 7 和 入 和 抽检 于 
workSheet.Cells[1, " "A"] = "M 
workSheet.Cells[1, "B"] = "coer; 
workSheet.Cells[1, "C"] = "P 


// 现在 ,将 所 有 List<Car> 中 的 数据 映射 到 工作 表 中 
int row = 1; 
foreach (Car c in carsInStock) 


IOW++; 
workSheet.Cells[row, "A"] = c.Make; 
workSheet.Cells[row, "B"] = c.Color; 
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workSheet.Cells[row, "C"] = c.PetName; 


// 美化 表 数 据 
workSheet .Range[ "A1"] .AutoFormat( 
Excel.XlRangeAutoFormat .xlRangeAutoFormatClassic2); 


// 保存 文件 ， 退 出 Excel 并 将 信息 显示 给 用 户 
workSheet.SaveAs(string.Format(@"{0}\Inventory.xlsx", Environment.CurrentDirectory)); 


excelApp.Quit(); 
MessageBox.Show("The Inventory.xslx file has been saved to your app folder", 


"Export complete!"); 


该 方法 将 Excel 加 载 到 内 存 中 , 因此 在 电脑 桌面 上 是 看 不 到 文件 的 。 对 于 该 应 用 程序 来 说 , 我 们 只 
对 如 何 使 用 内 部 Excel 对 象 模 型 感 兴趣 。 不 过 ， 如 果 你 真 的 希望 显示 Excel 的 UI， 可 以 在 方法 中 添加 一 
行 代码 : 


static void ExportToExcel(List<Car> carsInStock) 


// 加 载 Excel， 新 建 一 个 空 的 工作 薄 
Excel.Application excelApp = new Excel.Application(); 


// 使 Excel 在 计算 机 中 可 见 


excelApp.Visible = true; 


} 

在 创建 一 个 新 的 工作 表 时 ， 我 们 添加 了 3 个 列 ， 它 们 的 名 字 与 Car 类 的 属性 名 相同 。 在 这 之 后 ,使 
用 List<Car> 中 的 数据 填充 单元 格 ， 然 后 将 文件 保存 为 ( 硬 编码 ) Inventory.xlsx。 

这 时 ， 如 果 运 行程 序 ， 添 加 新 的 记录 ， 并 将 数据 导出 到 Excel， 就 可 以 打开 Inventory.xlsx 文 件 了 ， 
它 保存 在 Windows Form 应 用 程序 的 \bin\Debug 文 件 夹 下 。 图 16-10 显 示 了 导出 的 结果 。 


二 
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图 16-10 将 数据 导出 到 Excel 文 件 
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16.6 不 使 用 C# 动态 数据 进行 COM 互 操作 


那么 ， 如 果 你 在 Solution Explorer 中 选择 Microsoft.Office.Interop.Excel.dll 程 序 集 ， 并 将 其 Embed 
Interop Type 属 性 设置 为 False， 那 么 COM Variant 将 无 法 识别 为 动态 数据 而 只 能 识别 为 System.0bject 
变量 ， 因 此 会 产生 编译 时 错误 。 这 就 需要 修改 ExportToExcel() 方 法 ， 添 加 一 些 显 式 转换 操作 。 

如 果 该 项 目 在 .NET 3.5 或 更 早 的 版 本 下 编译 ， 你 将 无 法 使 用 可 选 参数 和 命名 参数 ， 而 必须 显 式 标 
记 所 有 缺失 的 参数 。 使 用 早期 版 本 的 C# 所 编写 的 ExportToExcel() 方 法 如 下 (注意 代码 增加 的 复杂 性 ): 


static void ExportToExcel2008(List<Car> carsInStock) 


{ 
Excel.Application excelApp = new Excel.Application(); 


// 必须 标记 缺失 的 参数 
excelApp.Workbooks .Add(Type.Missing); 


// 必须 将 Object 转换 为 _Morksheet 
Excel. Worksheet workSheet = (Excel. Worksheet)excelApp.ActiveSheet; 


// 必须 将 每 个 0bject 转 换 为 Range 对 象 ， 然 后 调用 低 等 级 的 Value2 属 性 


((Excel.Range)excelApp.Cells[1, "A"]). Value2 = "Make"; 
((Excel.Range)excelApp.Cells[1, "B"]).Value2 = "Color"; 
((Excel.Range)excelApp.Cells[1, "C"]).Value2 = "Pet Name"; 


int row = 1; 
foreach (Car c in carsInStock) 
{ 

IOW++; 


// 必须 将 每 个 Object 转换 为 Range， 然 后 调用 低 等 级 的 Value2 属 性 


((Excel.Range)workSheet.Cells[row, "A"]). Value2 = c.Make; 
((Excel.Range)workSheet.Cells[row, "B"]).Value2 = c.Color; 
((Excel.Range)workSheet.Cells[row, "C"]).Value2 = c.PetName; 


} 


// 必须 调用 get_Range 方 法 ， 并 指定 缺失 的 参数 

excelApp.get Range("A1", Type.Missing).AutoFormat( 
Excel.XlRangeAutoFormat .xlRangeAutoFormatClassic2, 
Type.Missing, Type.Missing, Type.Missing, 
Type.Missing, Type.Missing, Type.Missing); 


// 必须 指定 所 有 缺失 的 参数 

WorkSheet .SaveAs(Sstring.Format(@"{0}\Inventory.xlsx"，Environment.CurrentDirectory)， 
Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing, 
Type.Missing, Type.Missing, Type.Missing); 


excelApp.Quit(); 
MessageBox.Show("The Inventory.xslx file has been saved to your app folder", 
"Export complete!"); 
} 


管 该 程序 运行 的 最 终结 果 相 同 , 但 该 方法 要 喝 嗪 得 多 , 我 相信 你 也 一 定 会 这 么 认为 。 C# dynamic 
关键 字 和 DLR 的 讲解 就 到 此 结束 了 。 希望 你 已 经 明白 这 些 特 性 是 如 何 简 化 复杂 的 编程 任务 的 。 或 许 更 
重要 的 一 点 是 ,在 使 用 过 程 中 知道 如 何 折 中 。 选 择 动态 数据 难免 会 形 失 类 型 安全 ， 并 且 代 码 也 容易 出 
现 运行 时 错误 。 
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尽管 关于 DLR 我 有 很 多 想 说 的 , 但 本 章 主要 关注 对 日 常 编程 来 说 更 实用 和 更 有 帮助 的 话题 。 如 果 
要 学 习 DLR 的 高 级 特性 ( 如 与 脚本 语言 集成 )， 请 参考 .NET Framework 4.5 SDK 文 档 ( 从 “Dynamic 
Language Runtime Overview” 话 题 开 始 )。 


源 代 码 “ExportDataToOfficeApp 项 目的 源 代 码 位 于 Chapter16 子 目录 下 。 





16.7 小结 


C#4.0 引 和 人 的 dynamic 关 键 字 可 以 创建 动态 数据 ， 在 运行 时 之 前 我 们 无 法 知道 这 些 动 态 数据 的 真正 
身份 。 当 使 用 动态 语言 运行 时 ( DLR ) 进行 处 理 时 ， 自 动 创 建 的 “表达 式 树 ”将 被 传递 给 正确 的 动态 
语言 绑 定 器 。 绑 定 器 解析 表达 式 树 并 传递 给 正确 的 对 象 成 员 。 

使 用 动态 数据 和 DLR 可 以 从 根本 上 简化 很 多 复杂 的 C# 编 程 任务 ,尤其 是 能 够 简化 在 .NET 应 用 程序 
中 使 用 COM 库 的 过 程 。 正 如 你 在 本 章 中 所 看 到 的 那样 , .NET 4.0 和 更 高 版 本 提供 了 大 量 简化 COM 互 操 
作 的 特性 〈 与 静态 数据 无 关 )， 如 在 应 用 程序 中 僚 人 COM 互 操作 数据 、 可 选 参数 和 命名 参数 。 

尽管 这 些 特性 可 以 使 我 们 的 代码 变 得 简单 明了 ,但 要 记 住 的 是 动态 数据 会 降低 Cy 代 码 的 类 型 安全 
性 ， 并 且 会 带 来 运行 时 错误 。 因 此 在 C# 项 目 中 使 用 动态 数据 时 务必 要 权衡 利 次， 并 做 好 相关 测试 。 
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14 章 和 第 15 章 研究 了 CLR 解 析 外 部 引用 程序 集 位 置 的 步骤 以 及 .NET 元 数据 的 作用 。 本 章 将 深 
人 探讨 程序 集 由 CLR 承 载 的 细节 ， 并 阐述 进程 、 应 用 程序 域 和 对 象 上 下 文 ( context ) 之 间 的 
简单 地 说 ， 进 程 可 以 承载 一 组 相关 的 .NET 程 序 集 ， 而 应 用 程序 域 ( 简称 AppDomain ) 是 对 该 进程 
的 逻辑 细 分 。 你 将 看 到 , 一 个 应 用 程序 域 进 一 步 被 细 分 成 多 个 上 下 文 边 界 , 这 些 边界 用 来 分 组 目的 相 
似 的 .NET 对 象 。 使 用 上 下 文 的 概念 ，CLR 便 能 够 确保 恰当 地 控制 那些 带 特殊 运行 时 要 求 的 对 象 。 
尽管 大 多 数 的 日 常 编程 任务 可 能 不 会 直接 使 用 进程 、 应 用 程序 域 或 对 象 上 下 文 ， 但 在 使 用 很 
多 .NET API 时 ， 理 解 这 些 话题 是 非常 重要 的 ， 如 WCF、 多 线程 和 并 行 处 理 以 及 对 象 序列 化 。 


17.1 Windows 进程 的 作用 


在 .NET 平 台 发 布 之 前 ， 进 程 的 概念 已 经 在 Windows 操 作 系 统 中 存在 很 久 了 。 简单 地 说 ， 进 程 是 一 
个 运行 程序 。 正 式 地 说 ， 进 程 是 一 个 操作 系统 级 别 的 概念 ， 用 来 描述 一 组 资源 ( 比如 外 部 代码 库 和 主 
线程 ) 和 程序 运行 所 必需 的 内 存 分 配 。 对 于 每 一 个 被 加 载 到 内 存 的 *.exe, 在 它 的 生命 周期 中 操作 系统 
会 为 之 创建 一 个 单独 且 隔 离 的 进程 。 : 

由 于 一 个 进程 的 失败 不 会 影响 其 他 进程 ， 使 用 这 种 隔离 方式 ， 运行 库 环境 将 更 加 健壮 和 稳定 。 此 
外 ， 一 个 进程 无 法 访问 另外 一 个 进程 中 的 数据 ， 除 非 使 用 WCF 这 种 分 布 式 计算 编程 的 API。 鉴 于 以 上 
几 点 ， 可 以 将 进程 理解 为 一 个 正在 运行 的 应 用 程序 的 固定 的 安全 的 边界 。 

现在 每 一 个 Windows 进 程 都 有 一 个 唯一 的 进程 标识 符 ( PID )， 当 需要 时 ， 它 们 能 被 操作 系统 加 载 
或 和 卸载 (也 可 通过 编程 调用 )。 读 者 可 能 知道 , 在 Windows 任 务 管 理 器 ( 可 通过 Ctrl+Shift+Esc 组 合 键 2 激 
活 ) 的 Processes 选 项 卡 中 ， 我 们 能 够 看 到 机 器 上 正在 运行 进程 的 统计 信息 ， 这 些 信息 包括 进程 标识 符 
( PID ) 和 映像 名 称 ( image name )， 如 图 17-1 所 示 。 


说 明 ”默认 情况 下 , 不 显示 Process 选 项 卡 中 的 PID 列 ,通过 在 Windows 任 务 管理 器 上 选择 View 一 Select 
Columns 菜 单项 ， 可 以 选择 想 要 显示 的 PID 复 选 框 。 


@ 或 Ctrl+AlttDelete 组 合 键 。 一 一 编者 注 
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| Processes: 90 CPU Usage 0% i lk | 





图 17-1 Windows 任 务 管理 器 


线程 的 作用 


每 一 个 Windows 进 程 都 恰好 包含 一 个 用 做 程序 人 口 点 ( entry point ) 的 主线 程 。 在 第 19 章 中 ， 我 
们 将 研究 在 .NET 平 台 下 构建 多 线程 应 用 程序 的 细节 。 然 而 ， 为 了 使 本 章 的 这 些 主题 更 容易 理解 ， 我 
们 必须 先 做 一 些 有 关 线 程 的 定义 。 首 先 ， 线 程 是 进程 中 的 基本 执行 单元 (a path of execution )。 正 式 
的 说 法 是 :进程 的 入口 点 创建 的 第 一 个 线程 被 称 为 主线 程 ,.NET 执 行程 序 ( 控制 台 应 用 程序 、Windows 
Forms 应 用 程序 、WPF 应 用 程序 等 ) 使 用 Main() 方 法 作为 程序 入口 点 。 当 调用 该 方法 时 ,会 自动 创建 
全 线程 。 

仅 包 含 一 个 主线 程 的 进程 是 线程 安全 的 , 这 是 由 于 在 某 个 特定 时 刻 只 有 一 个 线程 访问 程序 中 的 数 
据 。 然 而 ， 如 果 这 个 线程 正在 执行 一 个 复杂 的 操作 ( 比如 : 输出 一 个 宛 长 的 文本 文件 ， 运 行 一 个 耗 时 
的 计算 或 尝试 连接 一 个 数 千 公里 外 的 远程 服务 器 ), 那么 这 个 线程 所 在 的 进程 ( 特别 是 GUI 程序 ) 对 用 
户 来 说 会 显得 像 没有 响应 一 样 。 

由 于 单线 程 程序 的 这 个 潜在 缺陷 ，Windows API ( 和 .NET 平 台 ) 可 让 主线 程 使 用 如 CreateThread() 之 
类 的 Windows API 函 数 另 外 产生 次 线程 ( 术语 也 称 为 工作 者 线程 ，worker thread )。 每 一 个 线程 ( 无论 
主线 程 还 是 次 线程 ) 都 是 进程 中 的 一 个 独立 执行 单元 ， 它 们 能 够 同时 访问 那些 共享 数据 。 

可 以 猜 到 ,开发 者 使 用 多 线程 有 助 于 改善 程序 的 总 体 响 应 性 。 包 含 多 个 线程 的 进程 给 我 们 带 来 这 
样 一 种 感觉 ， 即 大 量 的 活动 几乎 在 同一 时 间 发 生 。 比 如 : 一 个 应 用 程序 可 以 产生 一 个 工作 者 线程 来 执 
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行 强度 大 的 工作 ( 比如 输出 大 文本 文件 )。 当 这 个 次 线程 正在 忙碌 的 时 候 ， 主 线程 仍然 对 用 户 的 输入 
保持 响应 , 这 使 得 整个 进程 具有 更 强 的 性 能 。 然而 , 事情 也 不 尽 然 , 如 果 单 个 进程 中 的 线程 过 多 的 话 ， 
性 能 反而 会 下 降 ， 因 为 CPU 需 要 花费 不 少时 间 在 这 些 活动 的 线程 之 间 来 回 切换 。 

在 一 些 机 器 上 ， 多 线程 是 操作 系统 带 给 我 们 最 常见 的 一 个 假象 。 单 CPU 的 计算 机 并 没有 能 力 在 同 
一 时 间 运 行 多 个 线程 。 确 切 地 说 ， 在 一 个 单位 时 间 ( 即 一 个 时 间 片 ) 内 ， 单 CPU 只 能 根据 线程 优先 级 
执行 一 个 线程 。 当 一 个 线程 的 时 间 片 用 完 的 时 候 ， 它 会 被 挂 起 ， 以 便 执行 其 他 线程 。 对 于 线程 来 说 ， 
它们 需要 在 挂 起 前 记 住 发 生 了 什么 , 它们 把 这 些 情 况 写 到 线程 本 地 存储 ( Thread Local Storage, TLS ) 
中 ,并 且 它 们 还 要 获得 一 个 独立 的 调用 栈 ( call stack )， 如 图 17-2 所 示 。 


[ 





单个 Windows 进 程 





共享 数据 




















图 17-2 Windows 进程 和 线程 关系 


如 果 线 程 的 概念 对 于 你 来 说 很 新 ， 那 么 不 必 考 虑 过 多 细节 。 我 们 只 需要 记 住 : 线程 是 Windows 进 
程 中 的 独立 执行 单元 。 每 一 个 进程 都 有 一 个 〈 在 可 执行 人 口 点 处 创建 的 ) 主线 程 ， 并 且 每 个 进程 还 可 
以 包含 以 编程 方式 创建 的 额外 线程 。 


17.2 .NET 平台 下 与 进程 进行 交互 


虽然 进程 和 线程 并 不 是 什么 新 概念 ， 但 是 在 .NET 平 台 下 使 用 它们 的 方式 改变 了 很 多 ( 也 变 得 更 
好 ) 。 为 了 后 面 更 好 地 理解 如 何 构建 多 线程 程序 集 ( 参见 第 19 章 )， 让 我 们 先 来 学 习 如 何 使 用 .NET 基 
础 类 库 来 和 进程 进行 交互 。 

System.Diagnostics 命 名 空间 定义 了 许多 类 型 ， 它 们 允许 我 们 以 编程 方式 访问 进程 和 许多 与 诊断 
( diagnostic ) 相关 的 类 型 ， 比 如 系统 事务 日 志和 性 能 计数 器 。 在 本 章 中 ,我 们 只 和 定义 在 表 17-1 中 的 
与 进程 相关 的 类 型 打交道 。 


表 17-1 System.Diagnostics 命 名 空间 中 的 部 分 成 员 











System.Diagnostics 命 名 空间 中 进程 相关 的 类 型 帮 用 
Process 提供 了 访问 本 地 和 远程 进程 的 功能 ， 人 允许 通过 编程 方式 开 
或 结束 进程 
ProcessModule 代表 一 个 加 载 到 特定 进程 的 模块 (*.dll 或 *.exe )。 它 能 够 表 


示 任 何 模块 一 一 基于 COM、 基 于 .NET 或 基于 传统 C 的 二 进 
制程 序 
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( 续 ) 
System.Diagnostics 命 名 空间 中 进程 相关 的 类 型 作 用 
processModuleCollection 提供 ProcessModule 对 象 的 强 类 型 集合 
ProcessStartInfo 指定 通过 Process.Start() 方 法 启动 进程 时 使 用 的 一 组 值 
ProcessThread 代表 指定 进程 中 的 线程 。 它 用 于 诊断 一 个 进程 的 线程 情况 ， 
并 不 用 于 在 进程 中 创建 线程 
ProcessThreadCollection 提供 ProcessThread 对 象 的 强 类 型 集合 


System.Diagnostics.Process 类 用 于 分 析 运 行 于 (本 地 或 远程 的 ) 机 器 上 的 进程 。Process 类 也 提 
供 了 成 员 ， 可 用 来 以 编程 方式 开始 、 结 束 进程 ， 设 定 进 程 的 优先 级 ， 以 及 获得 进程 中 活动 线程 的 列表 
并 且 加 载 给 定 进程 的 模块 。 表 17-2 显 示 了 System.Diagnostics.Process 的 部 分 关键 成 员 。 


表 17-2 ”Process 类 型 的 部 分 成 员 





成 员 作 用 
ExitTime 获取 终止 进程 相关 的 时 间 戳 (类 型 是 DateTime ) 
Handle 返回 操作 系统 分 配给 进程 的 句柄 ( 由 IntPtr 表 示 ) 。 当 构建 与 非 托管 代码 交互 的 .NET 程 
序 时 ， 该 属性 很 有 用 
Yd 获取 关联 进程 的 PID 
MachineName 获取 关联 进程 运行 的 计算 机 名 称 
MainWindowTitle 获取 进程 主 窗口 的 标题 ( 如 果 进 程 没 有 主 窗口 ， 则 返回 空 字符 串 ) 
Modules 可 以 访问 强 类 型 ProcessModuleCollection， 后 者 表示 一 组 加 载 到 当前 进程 的 模块 ( *.dll 
或 *.exe ) 
ProcessName 获取 进程 的 名 称 ( 也 就 是 应 用 程序 本 身 的 名 称 ) 
Responding 指示 进程 的 用 户 界 面 是 否 响 应 用 户 输入 (或 者 当前 是 否 被 “ 挂 起 ”) 
StartTime 获取 关联 进程 开始 的 时 间 ( 通过 DateTime 类 型 ) 
Threads 获取 运行 在 关联 进程 中 的 一 组 线程 的 设置 ( 由 ProcessThread 对 象 的 集合 表示 ) 
除了 上 面 的 属性 外 ，System.Diagnostics.Process 还 定义 了 一 些 有 用 的 方法 ( 见 表 17-3 )。 
表 17-3 ”Process 类 型 的 部 分 方法 
成 员 作 用 
CloseMainWindow() 通过 向 进程 的 主 窗口 发 送 关闭 消息 来 关闭 拥有 用 户 界 面 的 进程 
CetCurrentProcess() 这 个 静态 方法 返回 新 的 Process 对 象 以 表示 当前 活动 的 进程 
CetProcesses() 这 个 静态 方法 返回 运行 在 给 定 计算 机 上 的 新 Process 对 象 
Kill() 立即 停止 关联 的 进程 
Start() 启动 一 个 进程 
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为 了 说 明 如 何 操作 Process 类 型 ( 请 原 
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列举 运行 中 的 进程 


谅 见 长 ) ， 假 定 你 有 一 个 名 为 ProcessManipulator 的 C# 控 制 


台 程 序 ， 它 定义 了 Program 类 中 以 下 静态 辅助 方法 ( 请 确保 引入 了 System.Diagnostics 命 名 空间 ): 


static void ListAllRunningProcesses() 


{ 
// 得 到 本 机 的 所 有 进程 ， 按 PID 顺 序 


中 


var runningProcs = 


from proc in Process.GetProcesses( 


// 输出 每 个 进程 的 PID 和 名 称 


foreach(var p in runningProcs) 


string info 
p.Id，p.ProcessName); 


LD 


.") orderby proc.Id select proc; 


= string.Format("-> PID: {0}\tName: {1}", 


Console.WritelLine(info); 


Console .WriteLine( ”本本 本 本 灿 本 本 可 水 可 玉 素 末 否 水 束 玉 本 吉 玉 可 笠 可 求 本 未 束 来 来 来 本 来 术 本 本 NT ”3 


注意 ， 静 态 方法 Process.GetProcesses() 返 回 了 一 个 Process 对 象 数组 ， 这 个 数组 代表 目标 机 器 上 
运行 的 进程 (这 里 显示 的 “.” 符 号 表示 本 机 ) 。 获 得 了 process 对 象 数组 后 ， 便 可 以 调用 表 17-2 和 表 
17-3 中 所 列 的 成 员 了 。 在 本 例 中 , 我 们 只 显示 每 个 进程 的 PID 和 名 称 ， 这 些 进程 按 PID 排 序 。 如 果 修 改 
Main() 方 法 调用 ListAllRunningProcesses() 的 话 ， 将 看 到 如 下 所 示 的 输出 : 


static void Main(string[] args) 


} 


Console.WriteLine("***** Fun with Processes *****\n"); 
ListAllRunningProcesses(); 


Console.ReadLine(); 


你 将 在 本 地 机 器 上 看 到 所 有 进程 的 名 称 和 PID。 下 面 是 我 的 机 器 的 部 分 输出 结果 : 





沙 冰 冰冰 炒 Fun with PTOCeSSeS ***** 


= 六 
*» 
= 
= 
“ 
9 入 
2 
~ 
区 
=- 
ss 
-> 
Sr 
E 
a 
= 
= 学 
-> 


PID 
PID 


PID: 
PID: 
PID : 
PID: 
PID: 
PID: 
PID: 
PID: 
PID: 
PID: 
PID: 
PID: 
REDS 
PID: 
PID: 
PID: 


2 
:4 
108 


Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 
Name: 


Idle 
System 
iexplore 
smss 
CSTSS 
svchost 
wininit 
Csrss 
winlogon 
services 
lsass 
lsm 
devenv 
svchost 
svchost 
svchost 
svchost 
svchost 
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-> PID: 900 Name: svchost 
-> PID: 924 Name: svchost 
-> PID: 956 Name: VMwareService 
-> PID: 1116 Name: spoolsv 


-> PID: 1136 Name: ProcessManipulator.vshost 
米 闵 玉 闵 来 米 六 六 六 六 六 六 闵 闵 六 六 玉米 闵 六 玉米 闵 六 六 玉米 六 冰冰 米 米 六 六 六 六 








17.2.2 ”特定 的 进程 


除了 能 够 获得 给 定 机 器 上 所 有 运行 的 进程 列表 以 外 ， 静 态 方法 Process.GetProcessById() 还 可 以 
通过 关联 的 PID 获 得 单个 Process 对 象 。 如 果 请 求 的 PID 不 存在 ， 就 会 引发 ArgumentException 异 常 。 因 
此 ， 如 果 想 获得 进程 PID 为 987 的 Process 对 象 ， 可 编写 如 下 代码 : 


// 如 果 PID 为 987 的 进程 不 存在 ， 将 会 引发 运行 时 错误 
static void GetSpecificProcess() 


Process theProc = null; 
try 


theproc = Process.GetProcessById(987); 
catch(ArgumentException ex) 
Console.WriteLine(ex.Message); 
} 
至 此 ,你 已 经 学 习 了 如 何 获取 所 有 进程 的 列表 ， 或 通过 PID 查 找 某 台 机 器 上 的 特定 进程 。 尽 管 了 
解 PID 和 进程 名 称 也 是 很 有 用 的 ， 但 Process 类 还 能 查找 给 定 进程 中 正在 使 用 的 线程 和 库 的 集合 。 让 我 
们 来 看 看 如 何 实现 。 


17.2.3 ”进程 的 线程 集合 
这 组 线程 通过 ProcessThreadCollection 强 类 型 集合 来 表示 ， 包 含 了 许多 单个 的 ProcessThread 对 象 。 为 
说 明 这 一 点 ,假定 下 面 的 静态 辅助 函数 已 经 加 到 程序 中 去 了 : 


static void EnumThreadsForPid(int pID) 


Process thepProc = null; 
try 


theProc = Process.GetProcessById(pID); 
catch(ArgumentException ex) 
Console.WriteLine(ex.Message); 


return; 


// 列 出 指定 进程 中 每 个 线程 的 统计 数字 

Console.WritelLine("Here are the threads used by: {0}", 
theproc.ProcessName); 

ProcessThreadCollection theThreads = theproc.Threads; 
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foreach(ProcessThread pt in theThreads) 


string info = 
string.Format("-> Thread ID: {0}\tStart Time: {1}\tPriority: {2}", 
pt.Id , pt.StartTime.ToShortTimeString(), pt.PriorityLevel); 
Console.WriteLine(info); 


Gonsole.Writetne(" 和 不 二 丰 本 丰 丰 征 玉 玉 示 水 下 未 守 六 来 六 相亲 守 素 圭 玫 率 六 来 来 汪 交 冰 丰 于 二 Nn) 
} 
可 见 ，System.Diagnostics.Process 类 型 的 Threads 属 性 可 以 访问 ProcessThreadCollection 类 。 这 里 输出 
了 客户 指定 进程 的 每 个 线程 分 配 的 线程 ID、 开 始 时 间 、 优 先 级 等 。 现 在 ， 如 果 修 改 程序 中 的 Main() 方 
法 提示 用 户 输入 一 个 PID 并 进行 研究 ， 如 下 所 示 : 


static void Main(string[] args) 


// 提示 用 户 输入 PID， 并 输出 一 组 活动 的 线程 ? 

Console.WritelLine("***** Enter PID of process to investigate *****"); 
Console.Write("PID: "); 

string pID = Console.ReadLine(); 

int theProcID = int.Parse(pID); 


EnumThreadsForPid(theProcID); 
Console.ReadLine(); 


} 
运行 程序 ， 输 入 机 器 中 任意 进程 的 PID， 就 可 以 查看 其 线程 了 。 下 面 的 输出 结果 显示 了 我 机 器 上 
PID 为 108 的 线程 ， 它 承载 了 微软 Internet 浏 览 器 : 





***** Enter PID of process to investigate ***** 


PID: 108 

Here are the threads used by: iexplore 

-> Thread ID: 680 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 2040 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 880 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 3380 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 3376 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 3448 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 3476 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 2264 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 2380 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 2384 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 2308 Start Time: 9:05 AM Priority: Normal 
-> Thread ID: 3096 Start Time: 9:07 AM Priority: Highest 
-> Thread ID: 3600 Start Time: 9:45 AM Priority: Normal 
-> Thread ID: 1412 Start Time: 10:02 AM Priority: Normal 








除了 Id、StartTime 和 PriorityLevel 外 ,ProcessThread 类 型 还 有 一 些 有 趣 的 成 员 。 表 17-4 列 出 了 一 
些 值 得 关注 的 成 员 。 





Q 请 勿 输入 PID 为 0 的 System Idle Process 的 “进程 "， 否 则 会 出 错 。 因 为 它 并 不 是 一 个 真正 意义 上 的 进程 ， 而 是 系统 
核心 虚拟 出 来 的 表示 CPU 空闲 的 状态 。 一 一 译 者 注 
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表 17-4 ProcessThread 类 型 的 部 分 成 员 


成 员 作 用 
Currentpriority 获取 线程 的 当前 优先 级 
Id 获取 线程 的 唯一 标识 符 
IdealProcessor 设置 线程 运行 的 首选 处 理 器 
PriorityLevel 获取 或 设置 线程 的 优先 级 别 
ProcessorAffinity 设置 关联 线程 可 以 运行 的 处 理 器 
StartAddress 获取 操作 系统 启动 线程 要 调用 的 函数 的 内 存 地 址 
StartTime 获取 操作 系统 启动 线程 的 时 间 
ThreadState 获取 线程 的 当前 状态 
TotalProcessorTime 获取 线程 使 用 处 理 器 的 时 间 总 量 
WaitReason 获取 线程 等 待 的 原因 


在 继续 阅读 之 前 ， 请 记 住 在 .NET 平 台 下 ，ProcessThread 类 型 并 不 用 于 创建 、 挂 起 或 停止 线程 ， 
ProcessThread 是 一 种 用 来 获取 运行 进程 中 活动 Windows 线 程 诊断 信息 的 手段 。 在 第 19 章 中 ， 我 们 将 研 
究 如 何 通过 System.Threading 命 名 空间 来 构建 多 线程 应 用 程序 。 


17.2.4 进程 中 的 模块 集合 


接 下 来 ， 看 看 如 何 对 承载 在 进程 中 的 加 载 模块 的 数量 进行 迭代 。 回 想 一 下 ， 模 块 这 个 词 用 于 描绘 
承载 于 指定 进程 中 的 *.dll ( 或 *.exe 本 身 )。 当 通过 Process.Modules 属 性 访问 ProcessModuleCollection 时 ， 
可 以 列举 出 承载 在 进程 中 的 所 有 模块 : 基于 .NET、 基 于 COM、 基 于 传统 C 的 库 。 请 思考 如 下 的 辅助 函 

数 ， 它 将 通过 PID 列 举 出 在 指定 进程 中 的 模块 : 
static void EnumModsForPid(int pID) 


Process thePproc = null; 
try 


theproc = Process.GetProcessById(pID); 
catch(ArgumentException ex) 


Console.WritelLine(ex.Message); 
return; 


} 


Console.WritelLine("Here are the loaded modules for: {0}", 
theproc.ProcessName); 

ProcessModuleCollection theMods = theProc.Modules; 

foreach(ProcessModule pm in theMods) 


string info = string.Format("-> Mod Name: {0}", pm.ModuleName); 
Console.WritelLine(info); 


Console.NTiteLine( “水 求 求 求 水 来 来 来 来 来 来 来 来 来 来 来 来 来 来 炒 求 来 来 素来 炒 来 来 求 来 来 来 来 来 来 来 和 门 上 
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为 了 看 到 输出 结果 ， 请 检查 承载 当前 控制 台 程序 ( ProcessManipulator ) 的 进程 中 加 载 的 模块 。 
为 此 ， 我 们 运行 程序 ， 通 过 任务 管理 器 找到 赋 给 ProcessManipulatorexe 的 PID 值 ， 将 值 传 人 Enum- 
ModsForpid() 方 法 ( 请 确保 Main() 方 法 得 到 了 同步 更 新 )。 最 后 ， 会 惊讶 地 看 到 这 个 简单 控制 台 程 序 所 
使 用 的 *.dll 列 表 ( GDI32.dll、USER32.dll、ole32.dll 等 )。 输 出 结果 如 下 所 示 : 





EPS Pe et TE 


Here are the loaded oi den ee 
-> Mod Name: ProcessManipulator.exe 
-> Mod Name: ntdll.dll 

-> Mod Name: MSCOREE.DLL 

-> Mod Name: KERNEL32.dl1 

-> Mod Name: KERNELBASE.d1l 

-> Mod Name: ADVAPI32.dll 

-> Mod Name: msvcrt.dll 

-> Mod Name: sechost.dll 

-> Mod Name: RPCRT4.d1l 

-> Mod Name: SspiCli.dll 

-> Mod Name: CRYPTBASE.d1l1 

-> Mod Name: mscoreei.dl1 

-> Mod Name: SHLWAPI.d1ll 

-> Mod Name: GDI32.d1l 

-> Mod Name: USER32.d]11 

-> Mod Name: LPK.dll 

-> Mod Name: USP10.d]1 

-> Mod Name: IMM32.DLL 

-> Mod Name: MSCTF.d1l 

-> Mod Name: clr.dll 

-> Mod Name: MSVCR100 CLRO400.d1ll 
-> Mod Name: mscorlib.ni.dll 

-> Mod Name: nlssorting.d]1 

-> Mod Name: ole32.dll 

-> Mod Name: clrjit.dll 

-> Mod Name: System.ni.d]1 

-> Mod Name: System.Core.ni.dll 
-> Mod Name: psapi.dll 

-> Mod Name: shfolder.dll 


-> Mod Name: SHELL32.d11 
六 炒米 米 米 米 米 六 玉米 米 闵 玉 闵 闵 冰 玉米 米 米 冰 玉米 炒米 闵 六 米 米 六 玉米 米 冰 炒米 


ea see 





17.2.5 ”以 编程 方式 启动 或 结束 进程 


对 于 System.Diagnostics.Process 类 ， 最 后 再 来 看 看 它 的 Start() 和 Kil1() 方 法 。 仅 从 名 字 上 便 能 
看 出 ， 它 们 提供 了 启动 和 结束 进程 的 编程 方法 。 例 如 ， 考 虑 下 面 的 静态 辅助 方法 StartAnd- 
KillProcess(): 

static void StartAndKillProcess() 


Process ieProc = null; 


// 启动 TE， 进 入 Facebook 
try 
{ 


ieProc = Process.Start("IExplore.exe", "www.facebook.com"); 
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catch (InvalidOperationException ex) 
Console.WritelLine(ex.Message); 

Console.Write("--> Hit enter to kill {0}...", ieproc.ProcessName); 

Console.ReadLine(); 


// 结束 iexplorer.exe 进 程 
try 


ieproc.Kill(); 
catch (InvalidOperationException ex) 


Console.Writeline(ex.Message); 
} 
} 





说 了 明 为 了 启动 新 的 进程 ， 必 须 以 管理 员 权 限 运 行 Visual Studio， 否 则 将 得 到 运行 时 错误 。 





静态 方法 Process.Start() 有 几 次 重 载 。 至 少 需要 指定 希望 加 载 的 进程 的 友好 名 称 ( 比如 : Microsoft 
Internet Explorer、iexplore.exe )。 本 例 中 ， 我 们 使 用 了 Start() 方 法 的 变 体 ， 该 方法 允许 我 们 向 程序 的 
人 入口 点 〈 即 Main() 方 法 ) 传人 任意 额外 的 参数 。 

调用 start() 方 法 后 ， 将 返回 刚刚 激活 的 进程 的 引用 。 要 终止 程序 ， 可 以 调用 实例 级 别 的 Kil1() 
方法 。 在 这 里 ， 我 们 用 try/catch 块 包 庄 Start() 和 Kil1() 的 调用 ， 并 处 理 InvalidOperationException 
错误 。 这 对 Kil1l() 方 法 的 调用 来 说 尤为 重要 ， 因 为 如 果 进 程 在 调用 Kil1() 之 前 就 已 经 被 终止 ， 则 会 触 
发 该 错误 。 


17.2.6 ”使 用 ProcessStartInfo 类 控制 进程 的 启动 


Start() 方 法 还 允许 传人 一 个 System.Diagnostics.ProcessStartInfo 类 型 , 说 明 一 些 关 于 进程 如 何 被 
激活 的 额外 信息 。 下 面 是 ProcessStartInfo 的 正式 定义 ( 完整 的 细节 请 看 ,NET Framework 4.5 SDK 文 档 )。 


public sealed class ProcessStartInfo : object 

{ 
public ProcessStartInfo(); 
public ProcessStartInfo(string fileName); 
public ProcessStartInfo(string fileName, string arguments); 
public string Arguments { get; set; } 
public bool CreateNoWindow { get; set; } 
public StringDictionary EnvironmentVariables { get; } 
public bool ErrorDialog { get; set; } 
public Intptr ErrorDialogParentHandle { get; set; } 
public string FileName { get; set; } 
public bool LoadUserprofile { get; set; } 
public SecureString Password { get; set; } 
public bool RedirectStandardError { get; set; } ， 
public bool RedirectstandardInput { get; set; } 
public bool RedirectStandardOutput { get; set; } 
public Encoding StandardErrorEncoding { get; set; } 
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public Encoding StandardOutputEncoding { get; set; } 
public bool UseShellExecute { get; set; } 
public string Verb { get; set; } 
public string[] Verbs { get; } 
public ProcessWindowStyle WindowStyle { get; set; } 
public string WorkingDirectory { get; set; } 

} 


为 了 演示 如 何 控制 进程 的 启动 , 我 们 修改 了 StartAndXillProcess(), 让 它 加 载 微 软 Internet 浏 览 器 ， 
导航 到 www.facebook.com， 并 且 显 示 窗 口 的 最 大 化 状态 : 
tatic void StartAndKillProcess() 


Process ieProc = null; 


// 用 最 大 化 窗口 启动 ILE， 并 导航 到 facebook 
try 


ProcessStartInfo startInfo = new 
ProcessStartInfo("IExplore.exe", "www.facebook.com"); 
startInfo.WindowStyle = ProcessWindowStyle.Maximized; 


ieProc = Process.Start(startInfo); 
catch (InvalidOperationException ex) 


Console.Writeline(ex.Message); 


i 
现在 你 已 经 理解 了 Windows 进 程 的 作用 以 及 如 何在 C# 代 码 中 与 之 交互 , 你 已 经 为 研究 .NET 应 用 程 
序 域 的 概念 作 好 了 准备 。 


源 代码 ”ProcessManipulator 项 目的 源 代码 位 于 Chapter 17 子 目录 下 。 


17.3 .NET 应 用 程序 域 


在 .NET 平 台 下 ， 可 执行 程序 并 没有 直接 承载 在 Windows 进 程 中 ， 而 传统 的 非 托 管 程序 是 直接 承载 
的 。 实 际 上 ，.NET 可 执行 程序 承载 在 进程 的 一 个 逻辑 分 区 中 ， 术 语 称 为 应 用 程序 域 (AppDomain )。 
可 见 , 一 个 进程 可 以 包含 多 个 应 用 程序 域 , 每 一 个 应 用 程序 域 中 承载 一 个 .NET 可 执行 程序 。 这 种 对 传 
统 的 Windows 进 程 的 进一步 分 区 具有 几 个 好 处 ， 下 面 列 出 一 些 。 

口 应 用 程序 域 是 NET 平台 操作 系统 独立 性 的 关键 特性 。 这 种 逻辑 分 区 将 不 同 操作 系统 表现 加 载 

可 执行 程序 的 差异 抽象 化 了 。 

口 和 一 个 完整 的 进程 相 比 , 应 用 程序 域 的 CPU 和 内 存 占用 都 要 小 得 多 。 因 此 CLR 加 载 和 钊 载 应 用 

程序 域 比 起 完整 的 进程 来 说 也 快 得 多 ， 并 且 可 以 快速 提升 服务 器 应 用 程序 的 可 扩展 性 。 

口 应 用 程序 域 为 承载 的 应 用 程序 提供 了 深度 的 隔离 。 如 果 进 程 中 一 个 应 用 程序 域 失 败 了 ， 剩 余 

的 应 用 程序 域 也 能 保持 正常 。 
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前 面 已 经 提 到 , 单个 进程 可 以 承载 多 个 应 用 程序 域 , 其 中 每 一 个 程序 域 都 和 该 进程 ( 或 其 他 进程 ) 
中 其 他 的 程序 域 完全 彻底 隔离 开 。 由 此 ， 如 果 不 使 用 分 布 式 编程 协议 ( 如 WCF )， 运 行 在 某 个 应 用 程 
序 域 中 的 应 用 程序 将 无 法 访问 其 他 应 用 程序 域 中 的 任何 数据 ( 无 论 是 全 局 变量 还 是 静态 字段 )。 

虽然 单个 进程 可 以 承载 多 个 应 用 程序 域 , 但 是 情况 也 有 例外 。 至 少 操作 系统 进程 只 能 承载 默认 的 
应 用 程序 域 。 在 进程 启动 的 时 候 ，CLR 将 自动 创建 这 个 特定 的 应 用 程序 域 。 此 后 ，CLR 能 够 根据 需求 


创建 其 他 的 应 用 程序 域 。 


System.AppDomain 类 


.NET 平 台 人 允许 我 们 使 用 mscorlib.dll 中 System 命名 空间 下 的 AppDomain 类 , 以 编程 的 方式 监控 应 用 程 
序 域 、 在 运行 时 新 建 应 用 程序 域 、 向 应 用 程序 域 加 载 程序 集 等 多 种 任务 。 表 17-5 列 出 了 AppDomain 类 中 
的 一 些 方 法 (详细 内 容 可 参考 .NET Framework 4.5 SDK 文 档 )。 


成 员 


CreateDomain() 
CreateInstance() 
ExecuteAssembly() 
GetAssemblies() 
GetCurrentThreadId() 
Load() 

Unload() 


表 17-5 ”AppDomain 的 主要 成 员 
作 用 
该 静态 方法 在 当前 进程 中 创建 一 个 新 的 应 用 程序 域 
在 加 载 程序 集 到 调用 的 应 用 程序 域 时 ， 在 外 部 程序 集 文 件 中 创建 指定 类 型 的 新 实例 
根据 文件 名 在 应 用 程序 域 中 执行 程序 集 
获取 已 经 加 载 到 此 应 用 程序 域 中 的 .NET 程 序 集 ( 基于 COM 和 C 的 二 进 制 文件 除外 ) 
该 静态 方法 返回 当前 应 用 程序 域 上 活动 的 线程 ID 
动态 加 载 程序 集 到 当前 的 应 用 程序 域 
该 静态 方法 在 进程 中 纯 载 指定 的 应 用 程序 域 





说 明 ” .NET 平台 不 允许 从 内 存 中 纯 载 指定 的 程序 集 。 以 编程 方式 卸载 库 的 唯一 方式 是 使 用 Unload() 
方法 销毁 承载 的 应 用 程序 域 。 


此 外 ，AppDomain 类 还 定义 了 一 些 属性 ， 用 来 监控 给 定 应 用 程序 域 的 活动 。 表 17-6 列 出 了 一 些 核心 


属性 。 
表 17-6 ”AppDomain 的 部 分 属性 
属 性 作 用 
BaseDirectory 获取 目录 路 径 ， 程 序 集 解决 程序 用 它 来 探测 程序 集 
CurrentDomain 该 静态 属性 获取 当前 执行 线程 所 在 的 应 用 程序 域 
FriendlyName 获取 当前 应 用 程序 域 的 友好 名 称 
SetupInformation 获取 给 定 应 用 程序 域 的 配置 信息 ， 表 示 为 一 个 AppDomainSetup 对 象 
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最 后 ，AppDomain 类 支持 一 组 事件 ， 对 应 于 应 用 程序 域 生命 周期 中 的 不 同 部 分 。 表 17-7 显 示 了 你 和 
可 能 会 用 到 的 事件 。 
表 17-7 AppDomain 类 型 的 部 分 事件 


事 件 作 “用 
AssemblyLoad 在 加 载 程序 集 到 内 存 时 发 生 
AssemblyResolve 在 对 程序 集 的 解析 失败 时 发 生 
DomainUnload 在 即将 从 主 进程 中 印 载 AppDomain 时 发 生 
FirstChanceException 在 应 用 程序 域 抛 出 异常 时 ， 该 事件 将 在 CLR 找 到 合适 的 catch 语 句 之 前 触发 
ProcessExit 当 默 认 应 用 程序 域 的 父 进程 退出 时 ， 在 默认 应 用 程序 域 上 发 生 
UnhandledException 在 异常 处 理 程序 未 捕捉 到 异常 时 发 生 


17.4 与 默认 应 用 程序 域 进行 交互 


当 一 个 .NET 可 执行 文件 启动 时 ，CLR 会 自动 将 其 放置 到 宿主 进程 的 默认 应 用 程序 域 中 。 该 过 程 是 
自动 且 透 明 的 ， 你 不 需要 编写 任何 代码 。 但 你 可 以 使 用 AppDomain.CurrentDomain 属 性 来 访问 这 个 默认 
的 应 用 程序 域 。 有 了 这 个 访问 点 , 就 可 以 捕获 任何 感 兴趣 的 事件 , 或 使 用 AppDomain 中 的 方法 和 属性 来 
执行 运行 时 诊断 。 

为 了 学 习 如 何 与 默认 应 用 程序 域 交互 我们 新 建 一 个 控制 台 应 用 程序 ， 取 名 为 DefaultAppDomain- 
App。 使 用 以 下 逻辑 更 新 program 类 , 它 将 使 用 AppDomain 类 中 的 一 些 成 员 显示 默认 应 用 程序 域 中 的 某 些 


细节 : 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** Fun with the default AppDomain *****\n"); 
DisplayDADStats(); 
Console.ReadLine(); 


} 
private static void DisplayDADStats() 


// 访问 当前 线程 的 应 用 程序 域 
AppDomain defaultAD = AppDomain.CurrentDomain; 


// 打印 该 域 中 的 不 同 状态 
Console.WritelLine("Name of this domain: {0}", defaultAD.FriendlyName); 
Console.WritelLine("ID of domain in this process: {0}", defaultAD.1d); 
Console.Writeline("Is this the default domain?: {0}", 
defaultAD.IsDefaultAppDomain()); 
Console.Writeline("Base directory of this domain: {0}", defaultAD.BaseDirectory); 
} 
} 


该 示例 的 输出 结果 如 下 : 
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NOS 


沙沙 冰冰 六 Fun with the default AppDomain +***** 


Name of this domain: DefaultAppDomainApp.exe 

ID of domain in this process: 1 

Is this the default domain?: True 

Base A of this domain: E: nation Ai di td 


注意 ， 上 默认 应 用 程序 域 的 名 称 与 包含 在 其 内 的 可 执行 文件 的 名 称 相 同 ( 本 例 为 DefaultApp- 
DomainApp.exe )。 同 时 还 要 注意 ， 用 来 探测 所 需要 的 外 部 私有 程序 集 的 基 目 录 值 ， 映射 为 可 执行 文件 
被 部 署 的 位 置 。 : 


17.4.1 枚 举 加 载 的 程序 集 


你 还 可 以 使 用 GetAssemblies() 实 例 方法 , 获取 给 定 应 序 域 中 所 加 载 的 .NET 程 序 集 。 该 方法 返 
回 Assembly 对 象 的 数组 ， 这 在 第 15 章 已 经 介绍 过 了 ， rt Reflection 命 名 空间 的 成 员 (所 
以 要 记得 在 C# 代 码 文件 中 引入 该 命名 空间 )。 | 

我 们 在 Program 类 中 定义 了 一 个 新 方法 ListAllAssembliesInAppDomain()。 该 辅助 方法 获取 所 有 加 
载 的 程序 集 ， 并 打印 它们 的 友好 名 称 和 版 本 号 : 


static void ListAllAssembliesInAppDomain() 





// 访问 当前 线程 的 应 用 程序 域 
AppDomain defaultAD = AppDomain.CurrentDomain; 


// 获取 默认 应 用 程序 域 中 所 有 加 载 的 程序 集 

Assembly[] loadedAssemblies = defaultAD.GetAssemblies(); 

Console.Writeline("***** Here are the assemblies loaded in {0} *****\n", 
defaultAD.FriendlyName); 

foreach(Assembly a in loadedAssemblies) 


Console.WriteLine("-> Name: {0}", a.GetName().Name); 
Console.WriteLine("-> Version: {0}\n", a.GetName().Version); 


} 
更 新 Main() 方 法 以 调用 该 成 员 , 可 以 看 到 承载 可 执行 文件 的 应 用 程序 域 使 用 了 如 下 所 示 的 .NET 程 
序 集 : 





***** Here are the assemblies loaded in DefaultAppDomainApp .exe ***** 


-> Name: mscorlib 
-> Version: 4.0.0.0 


-> Name: DefaultAppDomainApp 
-> Version: 1.0.0.0 





所 加 载 的 程序 集 的 列表 可 因 编 写 新 的 C# 代 码 而 随时 改变 。 例 如 ， 假 设 我 们 更 新 ListAllAssem- 
bliesInAppDomain() 方 法 ， 使 其 使 用 LINQ 查 询 对 加 载 的 程序 集 按 名 称 排序 : 


Re 
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static void ListAllAssembliesInAppDomain() 
{ 
// 访问 当前 线程 的 应 用 程序 域 
AppDomain defaultAD = AppDomain.CurrentDomain; 


// 获取 默认 应 用 程序 域 中 所 有 加 载 的 程序 集 
var loadedAssemblies = from a in defaultAD.GetAssemblies() 
orderby a.GetName().Name select a; 


Console.WritelLine("***** Here are the assemblies loaded in {0} *****\n", 
defaultAD.FriendlyName); 
foreach (var a in loadedAssemblies) 


Console.WriteLine("-> Name: {0}", a.GetName().Name); 
Console.WritelLine("-> Version: {0}\n", a.GetName().Version); 


} 
} 


再 次 运行 该 程序 ， 可 以 发 现 System.Core.dll 和 System.dll 也 加 载 到 了 内 存 中 ， 因 为 它们 是 LINQ to 
Object API 所 必需 的 : 





1 
***** Here are the assemblies loaded in Defau1ltAppDomainApp .exXe **** 闪 


-> Name: DefaultAppDomainApp 
-> Version: 1.0.0.0 


-> Name: mscorlib 
-> Version: 4.0.0.0 


-> Name: System 
-> Version: 4.0.0.0 


-> Name: System.Core 
-> Version: 4.0.0.0 


OR HEE ee A ear tN 








mt 


17.4.2 ”接收 程序 集 加 载 通知 


如 果 想 接收 CLR 在 向 给 定 的 应 用 程序 域 中 加 载 新 程序 集 时 所 发 出 的 通知 ， 可 以 处 理 AssemblyLoad 
事件 。 该 事件 的 类 型 为 AssemblyLoadEventHandler 委 托 ， 它 所 指向 方法 的 第 一 个 参数 为 System.0bject 
类 型 ， 第 二 个 参数 为 AssemblyLoadEventArgs 类 型 。 | 

让 我 们 再 为 当前 的 Program 类 添加 最 后 一 个 方法 InitDAD()。 顾 名 思 义 ， 该 方法 将 初始 化 默认 的 应 
用 程序 域 ， 用 一 个 Lambda 表 达 式 处 理 AssemblyLoad 事 件 : 


private static void InitDAD() 


// 这 段 运 辑 将 在 应 用 程序 域 创建 上 后， 打印 加载 到 应 用 程序 域 的 程序 集 名 称 
AppDomain defaultAD = AppDomain.CurrentDomain; 
defaultAD.AssemblyLoad += (0, s) => 


Console.WritelLine("{0} has been loaded!", s.LoadedAssembly.GetName().Name); 
}; 
} 
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运行 修改 后 的 应 用 程序 ， 加 载 新 的 程序 集 时 将 通知 我 们 。 这 里 我 们 使 用 传人 的 AssemblyLoaded- 
EventArgs 参 数 的 Loaiadhssenbly 属 竹简 单 地 打印 了 程序 集 的 友好 名 称 。 


源 代码 ”DefaultAppDomainApp 项 目的 源 代码 位 于 Chapter 17 子 目录 下 。 


17.5 创建 新 的 应 用 程序 域 


单个 进程 可 以 通过 AppDomain.CreateDomain() 静 态 方 法 承载 多 个 应 用 程序 域 。 尽 管 对 大 多 
数 .NET 应 用 程序 来 说 ,在 运行 时 新 建 应 用 程序 域 是 十 分 罕见 的 , 但 理解 其 原理 还 是 非常 重要 的 。 例 
如 ， 在 本 章 稍 后 你 将 看 到 ， 构 建 动 态 程序 集 ( 见 第 18 章 ) 时 ， 需 要 将 它们 安装 到 自 定义 的 应 用 程序 
域 中 。 同 样 ， 很 多 .NET 安 全 API 都 要 求 了 解 如 何 构 建新 的 应 用 程序 域 ， 以 便 基 于 提供 的 安全 证 书 来 
隔离 程序 集 。 
为 了 研究 如 何在 运行 时 新 建 应 用 程序 域 ( 以 及 如 何在 这 些 自 定义 宿主 中 加 载 程序 集 )， 我 们 新 建 
一 个 控制 台 应 用 程序 ， ri AppDomain.CreateDomain() 方 法 包含 多 个 重 载 。 你 
至 少 需要 指定 新 应 用 程序 域 的 友好 名 称 。 使 用 如 下 代码 更 新 Program 类 : 这 里 我 们 利用 前 面 示例 中 的 
ListAllAssembliesInAppDomain() 方 法 ,但 这 次 我 们 将 AppDomain 对 象 作为 传人 参数 进行 分 析 : 


class Program 
static void Main(string[] args) 
Console.WritelLine("***** Fun with Custom AppDomains *****\n"); 


// 显示 默认 应 用 程序 域 中 加 载 的 所 有 程序 集 
AppDomain defaultAD = AppDomain.CurrentDomain; 
ListAllAssembliesInAppDomain(defaultAD); 


// 创建 一 个 新 的 应 用 程序 域 
MakeNewAppDomain(); 
Console.ReadLine(); 


} 


private static void MakeNewAppDomain() 


{ 
// 在 当前 进程 中 新 建 一 个 AppDomain， 并 列 出 它 所 加 载 的 程序 集 
AppDomain newAD = AppDomain.CreateDomain("SecondAppDomain"); 
ListAllAssembliesInAppDomain(newAD); 

} 


static void ListAllAssembliesInAppDomain(AppDomain ad) 


// 现在 获取 默认 应 用 程序 域 中 加 载 的 所 有 程序 集 
var loadedAssemblies = from a in ad.GetAssemblies() 
orderby a.GetName().Name select a; 


Console.WritelLine("***** Here are the assemblies loaded in {0} *****\n", 
ad.FriendlyName); 
foreach (var a in loadedAssemblies) 
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Console.WriteLine("-> Name: {0}", a.GetName().Name); 
Console.WritelLine("-> Version: {0}\n", a.GetName().Version); 


} 
} 
运行 当前 示例 ,你 会 发 现 默 认 应 用 程序 域 ( CustomAppDomains.exe ) 加 载 了 mscorlib.dll、System.dll、 
System.Core.dll 和 当前 项 目的 代码 库 CustomAppDomains.exe。 而 新 的 应 用 程序 域 则 只 包含 mscorlib.dll， 
CLR 总 是 为 每 个 应 用 程序 域 都 加 载 这 个 .NET 程 序 集 : 





六 **** Fun With Custom AppDomains 六 水 沙沙 
沙沙 六 水 六 Here are the assemblies loaded in CustomAppDomains .exe ***** 


-> Name: CustomAppDomains 
-> Version: 1.0.0.0 


-> Name: mscorlib 
-> Version: 4.0.0.0 


-> Name: System 
-> Version: 4.0.0.0 


-> Name: System.Core 
-> Version: 4.0.0.0 


****** Here are the assemblies loaded in SecondAppDomain 冰冰 沙沙 


-> Name: mscorlib 
-> Version: 4.0.0.0 





说 明 调式 ( 按 F5 键 ) 该 程序 ,你 会 发 现 每 个 应 用 程序 域 都 加 载 了 很 多 用 于 Visual Studio 调 试 进程 的 
额外 的 程序 集 。 运 行 该 项 目 ( 按 Ctrl + F5 组 合 键 )， 将 只 显示 每 个 应 用 程序 域 的 程序 集 。 


如 果 你 有 传统 的 Windows 编 程 经 验 ， 可 能 会 觉得 这 有 悖 常理 〈 如 你 所 想 的 那样 ， 两 个 应 用 程序 域 
访问 了 相同 的 程序 集 )。 但是， 程序 集 是 加 载 到 应 用 程序 域 中 的 ， 而 不 是 直接 加 载 到 进程 本 身 的 。 


17.5.1 在 自 定 义 应 用 程序 域 中 加 载 程序 集 


CLR 可 随时 向 默认 的 应 用 程序 域 加 载 程序 集 。 如 果 手 工 创建 了 应 用 程序 域 ， 可 以 使 用 AppDomain. 
We det 调用 AppDomain.ExecuteAssembly() 方 法 也 可 以 加 载 一 个 *.exe 程 序 
集 ， 并 执行 其 Main() 方 法 。 

假设 你 要 向 新 建 的 次 应 用 程序 域 中 加 载 CarLibrary.dll， 并 已 经 将 其 复制 到 了 当前 应 用 程序 的 
\bin\Debug 文 件 夹 下 。 更 新 MakeNewAppDomain() 方 法 (确保 引入 System.I0 命 名 空间 以 便 可 以 访问 
FileNotFoundException 类 ): 


private static void MakeNewAppDomain() 


} 
这 
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// 在 当前 进程 中 新 建 AppDomain 
AppDomain newAD = AppDomain.CreateDomain("SecondAppDomain"); 
try 


// 将 CarLibrary.dll 加 载 到 新 域 中 
newAD.Load("CarLibrary"); 


上 
catch (FileNotFoundException ex) 
Console.WritelLine(ex.Message); 


// 列 出 所 有 的 程序 集 
ListAllAssembliesInAppDomain(newAD); 


时 程序 的 输出 结果 如 下 注意 CarLibrary.dll ): 


*** Fun with Custom AppDomains +***** 
*** Here are the assemblies loaded in CustomAppDomains .exe ***** 


Name: CustomAppDomains 
Version: 1.0.0.0 


Name: mscorlib 
Version: 4.0.0.0 


Name: System 
Version: 4.0.0.0 


Name: System.Core 
Version: 4.0.0.0 


*** Here are the assemblies loaded in SecondAppDomain +***** 


Name: CarLibrary 
Version: 2.0.0.0 


Name: mscorlib 
Version: 4.0.0.0 





说 明 


记 住 ， 如 果 调 试 该 应 用 程序 ， 将 看 到 每 个 应 用 程序 域 中 都 加 载 了 很 多 额外 的 库 。 


17.5.2 ”以 编程 方式 卸载 应 用 程序 域 
需要 重点 指出 的 是 ，CLR 并 不 允许 印 载 单独 的 .NET 程 序 集 。 然 而 ， 使 用 AppDomain.Unload() 方 法 ， 


我 们 可 
印 载 。 


以 选择 从 承载 的 进程 中 御 载 指定 的 应 用 程序 域 。 当 务 载 应 用 程序 域 时 ， 其 中 的 程序 集会 依次 被 


回想 一 下 ，AppDomain 类 型 定义 了 DomainUnload 事 件 。 当 自 定义 应 用 程序 域 从 包含 它 的 进程 中 印 载 
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的 时 候 , * 该 事件 被 触发 。 另 一 个 事件 是 processExit， 当 默认 的 应 用 程序 域 从 进程 中 印 载 的 时 候 ( 很 明 
显 ， 这 是 进程 本 身 结束 时 必须 做 的 事情 )， 它 将 被 触发 。 

如 果 想 要 以 编程 方式 从 主 进程 中 印 载 newAD， 并 且 在 相关 应 用 程序 域 印 载 时 得 到 通知 ， 可 以 编写 
如 下 的 事件 逻辑 来 更 新 MakeNewAppDomain() : 


private static void MakeNewAppDomain() 


{ 
// 在 当前 进程 中 创建 一 个 新 应 用 程序 域 
AppDomain newAD = AppDomain.CreateDomain("SecondAppDomain"); 
newAD.DomainUnload += (0, Ss) => 


Console.WritelLine("The second AppDomain has been unloaded!"); 


了 
try 


// 现在 加 载 CarLibrary.dl1 到 这 个 新 域 中 
newAD.Load("CarLibrary"); 


catch (FileNotFoundException ex) 


Console.WritelLine(ex.Message); 


// 一 一 列 出 所 有 程序 集 
ListAllAssembliesInAppDomain(newAD); 


// 现在 却 载 这 个 应 用 程序 域 
AppDomain.Unload(newAD); 


如 果 想 要 在 默认 的 应 用 程序 域 被 印 载 时 得 到 通知 ， 请 修改 Main() 方 法 处 理 默认 应 用 程序 域 的 
ProcessExit 事 件 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with Custom AppDomains *****\n"); 


// 在 默认 的 应 用 程序 域 中 显示 所 有 加 载 的 程序 集 
AppDomain defaultAD = AppDomain.CurrentDomain; 
defaultAD.ProcessExit += (0o, $s) => 


Console.WritelLine("Default AD unloaded!"); 


3 


ListAllAssembliesInAppDomain(defaultAD); 


MakeNewAppDomain(); 
Console.ReadLine(); 


} 
我 们 完成 了 对 .NET 应 用 程序 域 的 介绍 。 在 本 章 最 后 ， 让 我 们 看 看 一 个 高 级 话题 ， 如 何 将 对 象 按 上 
下 文 边界 进行 分 组 。 


源 代 码 ”CustomAppDomains 项 目的 源 代码 位 于 Chapter 17 子 目录 下 。 
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17.6 ”对 象 上 下 文 边 界 


同 刚才 看 到 的 一 样 ， 应 用 程序 域 是 承载 .NET 程 序 集 的 进程 中 的 逻辑 分 区 。 与 此 相似 , 应 用 程序 域 
也 可 以 进一步 被 划分 成 多 个 上 下 文 边界 。 简 言 之 ，.NET 上 下 文 为 单独 的 应 用 程序 域 提供 了 一 种 方式 ， 
该 方式 能 为 一 个 给 定 对 象 建立 “特定 的 家 ”( specific home )。 


说 明 尽管 进程 和 应 用 程序 域 十 分 重要 ,但 大 多 数 .NET 应 用 程序 都 不 会 要 求 你 使 用 对 象 上 下 文 。 我 
已 经 使 用 这 些 材 料 绘 制 了 一 幅 完 整 的 图 画 。 


使 用 上 下 文 ，CLR 可 以 确保 在 运行 时 有 特殊 需求 的 对 象 ， 可 以 通过 拦截 进出 上 下 文 的 方法 调用 ， 
得 到 适当 的 和 一 致 的 处 理 。 这 个 拦截 层 允 许 CLR 调 整 当前 的 方法 调用 ， 以 便 满足 给 定 对 象 对 上 下 文 的 
设 定 要 求 。 举 例 来 说 ， 如 果 定 义 一 个 需要 自动 线程 安全 ( 使 用 [Synchronization] 特 性 ) 的 C# 类 类 型 ， 
CLR 将 会 在 分 配 期 间 创建 “上 下 文 同步 ”。 

和 一 个 进程 定义 了 默认 的 应 用 程序 域 一 样 ， 每 个 应 用 程序 域 都 有 一 个 默认 的 上 下 文 。 这 个 默认 的 
上 下 文 [由 于 它 总 是 应 用 程序 域 创建 的 第 一 个 上 下 文 ， 所 以 有 时 称 为 上 下 文 0 ( context 0 ) ] 用 于 组 合 那 
些 对 上 下 文 没有 具体 的 或 唯一 性 需求 的 ,NET 对象。 如 你 所 料 ， 大 多 数 .NET 对 象 都 会 被 加 载 到 上 下 文 0 
中 。 如 果 CLR 判 断 一 个 新 创建 的 对 象 有 特殊 需求 ， 一 个 新 的 上 下 文 边界 将 会 在 承载 它 的 应 用 程序 域 中 
被 创建 。 图 17-3 展 示 了 进程 /应 用 程序 域 /上 下 文 边界 之 间 的 关系 。 





默认 的 应 用 程序 域 应 用 程序 域 1 应 用 程序 域 2 


默认 的 上 下 文 默认 的 上 下 文 默认 的 上 下 文 


2 Et 


业 下 文 2 生 下 文 2 





图 17-3 ”进程 、 应 用 程序 域 和 上 下 文 边 界 


17.6.1 ”上下文 灵活 和 上 下 文 绑 定 类 型 


不 需要 指定 特定 上 下 文 的 .NET 类 型 称 为 上 下 文 灵 活 ( context-agile ) 对 象 。 这 些 对 象 可 以 从 承载 
它 的 应 用 程序 域 的 任何 位 置 访问 ,与 对 象 的 运行 时 需求 没有 关系 。 想 要 构建 这 样 一 个 上 下 文 灵活 的 对 
象 根本 不 用 费 神 ， 因 为 简单 得 你 什么 都 不 用 做 ( 具体 来 说 ,不 需要 修饰 类 型 的 上 下 文 特性 ， 也 不 需要 
派生 自 System.ContextBound0bject 基 类 ): 
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// 一 个 上 下 文 灵活 的 对 象 被 加 载 到 上 下 文 0 中 
class SportsCar{} 


另 一 方面 ,那些 需要 上 下 文 分 配 的 对 象 称 为 上 下 文 绑 定 ( context-bound ) 对 象 ,它们 必须 派生 自 System. 
ContextBound0bject 基 类 。 这 个 基 类 再 次 说 明 这 样 一 个 事实 : 任何 一 个 对 象 都 只 能 在 其 被 创建 的 那个 
上 下 文中 正常 运行 。 考 虑 到 .NET 上 下 文 的 作用 , 如 果 一 个 上 下 文 绑 定 对 象 不 知 何故 在 一 个 并 不 兼容 的 
上 下 文中 终止 ， 则 在 这 种 最 不 合 时 宜 的 情况 下 理应 出 现 错误 。 

除了 派生 自 System.ContextBound0bject 外 ,一 个 上 下 文敏 感 的 类 型 也 可 以 用 特定 种 类 的 .NET 特 性 
修饰 ( 不 要 惊讶 )， 术 语 称 为 上 下 文 特性 。 所 有 的 上 下 文 特 性 派生 自 ContextAttribute 基 类 。 下 面 来 看 
一 个 例子 。 


17.6.2 ”定义 上 下 文 绑 定 对 象 


假定 想 要 定义 一 个 自动 线程 安全 的 类 ( SportsCarTS )， 但 又 不 在 成 员 实 现 中 采用 硬 编码 做 线程 同 
步 的 逻辑 ， 可 以 继承 ContextBound0bject， 并 应 用 [Synchronization] 特 性 ， 如 下 所 示 : 

using System.Runtime.Remoting.Contexts; 

// 上 下 文 绑 定 类 型 仅仅 加 载 到 一 个 同步 的 〈 因 此 是 线程 安全 的 ) 上 下 文中 


[Synchronization] 
class SportsCarTS : ContextBoundObject 
{} 


添加 了 [Synchronization] 特 性 的 类 型 将 被 加 载 到 线程 安全 上 下 文中 。 因为 SportsCarTs 类 类 型 有 特 
丈 的 需求 ， 如 果 一 个 已 分 配 的 对 象 从 一 个 同步 的 上 下 文 移动 到 一 个 非 同步 的 上 下 文 时 ， 发 生 的 问题 可 
想 而 知 。 对 象 突然 不 再 是 线程 安全 的 并 且 极 有 可 能 变 成 大 块 的 坏 数据 , 而 大 量 线程 还 在 试图 与 这 个 ( 现 
在 已 是 线程 不 稳定 的 ) 引用 对 象 交互 。 为 了 确保 CLR 不 会 将 SportsCarTS 对 象 移出 同步 上 下 文 边 界 ， 只 
需 让 SportsCarTS 继 承 自 ContextBound0bject。 


17.6.3 ”研究 对 象 的 上 下 文 


尽管 很 少 有 应 用 程序 需要 以 编程 的 方式 和 上 下 文 进行 交互 ， 但 我 们 还 是 给 出 下 面 的 示例 。 该 例子 
创建 了 一 个 名 为 ObjectContextApp 的 控制 台 程 序 ， 这 个 程序 定义 了 一 个 上 下 文 灵 活 的 类 (SportsCar ) 
和 一 个 单一 的 上 下 文 绑 定 的 类 型 ( SportsCarTS ): 


using Systemj; 
using System.Runtime.Remoting.Contexts;j // 为 上 下 文 类 型 
Using System.Threading; // 为 线程 类 型 


// SportsCar 没 有 特别 的 上 下 文 要 求 ， 所 以 将 加 载 到 应 用 程序 域 的 默认 上 下 文中 
class SportsCar 


public SportsCar() 
{ 


// 得 到 上 下 文 信息 ， 并 输出 上 下 文 ID 

Context ctx = Thread.CurrentContext; 

Console.WriteLine("{0} object in context {1}", 
this.ToString(), ctx.ContextID); 

foreach(IContextProperty itfCtxProp in ctx.ContextProperties) 
Console.WriteLine("-> Ctx Prop: {0}", itfCtxProp.Name); 
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} 
} 


// SportsCarTS 需 要 加 载 到 一 个 同步 上 下 文中 
[Synchronization] 
class SportsCarTS : ContextBoundObject 


public SportsCarTS() 


// 得 到 上 下 文 信息 ， 并 输出 上 下 文 ID 
Context ctx = Thread.CurrentContext; 
Console.WriteLine("{0} object in context {1}", 
this.ToString(), ctx.ContextID); 
foreach(IContextProperty itfCtxProp in ctx.ContextProperties) 
Console.WriteLine("-> Ctx Prop: {0}", itfCtxProp.Name); 
} 
} 
注意 , 通过 调用 静态 的 Thread.CurrentContext 属 性 ，SportsCar 的 每 个 构造 函数 都 从 当前 运行 的 线 
程 中 获得 了 Context 对 象 。 使 用 这 个 Context 对 象 ， 我 们 能 够 输出 上 下 文 边界 的 统计 信息 ， 比 如 它 分 配 
的 ID 以 及 一 组 通过 Context.ContextProperties 得 到 的 描述 。 该 属性 返回 一 个 实现 了 IContextProperty 
接口 的 对 象 数组 ， 该 对 象 数组 通过 Name 属 性 公开 每 一 个 描述 符 。 现 在 更 新 Main() 方 法 ， 分 派 每 个 类 类 
型 的 实例 : 


static void Main(string[] args) 


{ 


Console.WritelLine("***** Fun with Object Context *****\n"); 


// 对 象 将 显示 创建 时 的 上 下 文 信息 
SportsCar sport = new SportsCar(); 
Console.WriteLine(); 


SportsCar Sport2 = new SportsCar(); 
Console.WritelLine(); 


SportsCarTS synchroSport = new SportsCarTS(); 
Console.ReadLine(); 


} 
当 对 象 被 实例 化 的 时 候 ， 类 的 构造 函数 将 会 输出 各 种 上 下 文 信息 ( 输出 的 “lease life time service 
property” 是 .NET remoting 层 的 底层 部 分 ， 可 以 忽略 )。 





冰冰 冰冰 于 Fun with Object Context ***** 


ObjectContextApp.SportsCar object in context 0 
-> Ctx Prop: LeaseLifeTimeServiceProperty 


ObjectContextApp.SportsCar object in context 0 
-> Ctx Prop: LeaselifeTimeServiceProperty 


ObjectContextApp.SportsCarTS object in context 1 
-> Ctx Prop: LeaselLifeTimeServicePproperty 
-> Ctx Prop: Synchronization 





由 于 SportsCar 类 没有 使 用 上 下 文 特性 修饰 ， 所 以 CLR 将 把 sport 和 sport2 分 配 到 上 下 文 0 ( 也 就 是 
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默认 的 上 下 文中 )。 然 而 ，SportsCarTS 对 象 被 加 载 到 唯一 的 上 下 文 边界 〈 被 分 配 的 上 下 文 ID 是 1 )， 因 
为 实际 上 这 个 上 下 文 绑 定 类 型 应 用 了 [Synchronization] 特 性 加 以 修饰 。 


源 代码 ”Object ContextApp 项 目的 源 代码 位 于 Chapter 17 子 目录 下 。 


17.7 进程、 应 用 程序 域 和 上 下 文 小 结 


到 目前 为 止 对 于 .NET 程 序 集 如 何 由 CLR 承 载 , 读者 已 经 有 了 很 好 的 认识 ,总 结 起 来 有 以 下 几 个 
要 点 。 
口 一 个 .NET 进 程 可 以 承载 多 个 应 用 程序 域 .每 一 个 应 用 程序 域 可 以 承载 多 个 相关 的 .NET 程 序 集 ， 
并 且 可 由 CLR (或 使 用 System.AppDomain 类 型 通过 编程 ) 独立 地 加 载 或 卸载 应 用 程序 域 。 
口 一 个 给 定 的 应 用 程序 域 中 包含 一 个 或 多 个 上 下 文 。 使 用 上 下 文 ，CLR 能 够 将 “有 特殊 需求 的 ” 
对 象 放置 到 一 个 逻辑 容器 中 ， 确 保 该 对 象 的 运行 时 需求 能 够 被 满足 。 
如 果 前 面 这 些 内 容 对 读者 的 水 平 来 讲 有 点 过 于 低 了 ， 不 用 担心 。 大 多 数 情 况 下 ，CLR 可 以 自动 处 
理 进程 、 应 用 程序 域 和 上 下 文 的 细节 。 然 而 , 学 习 这 些 的 好 处 是 这 些 内 容 为 理解 NET 平台 下 的 多 线程 
编程 打下 了 一 个 坚实 的 基础 。 


17.8 小 结 


本 章 的 目的 在 于 研究 NET 平台 如 何 承载 NET 可 执行 映像 。 可 见 , 长 久 以 来 存在 的 Windows 进 程 概 
念 , 在 CLR 的 需求 下 被 改头换面 了 。 一 个 单 进 程 ( 能 够 通过 System.Diagnostics.pProcess 类 型 编程 控制 ) 
由 多 个 应 用 程序 域 组 成 。 应 用 程序 域 代 表 了 进程 中 被 隔离 的 独立 的 边界 。 

如 你 所 看 到 的 ,一 个 进程 可 以 承载 多 个 应 用 程序 域 , 每 一 个 应 用 程序 域 都 能 承载 或 执行 多 个 相关 
程序 集 。 此 外 ， 一 个 应 用 程序 域 可 以 包含 多 个 上 下 文 边界 。 使 用 这 种 进一步 的 类 型 隔离 ，CLR 可 以 确 
保有 特定 要 求 的 对 象 被 正确 处 理 。 





CIL 和 动态 程 








构建 大 型 .NET 应 用 程序 时 ， 由 于 C# ( 或 其 他 托管 语言 ， 如 Visual Basic ) 固有 的 生产 效率 和 
士 易 用 性， 你 很 可 能 选择 它们 进行 开发 。 但 我 们 在 第 1 章 中 介绍 了 , 托管 编译 器 的 作用 是 将 *.cs 
代码 文件 翻译 为 CIL 代 码 、 类 型 元 数据 和 程序 集 清单 。 事 实 上 ，CIL 是 一 个 成 熟 的 .NET 编程 语言 ， 包 
含 自己 的 语法 、 语 义 和 编 译 器 (ilasm.exe )。 
本 章 将 介绍 这 个 .NET 平 台 的 母语 。 你 将 理解 CIL 指 令 、CIL 特 性 和 CIL 操 作 码 之 间 的 区 别 ， 还 将 学 
习 各 种 CIL 编 程 工 具 以 及 .NET 程 序 集 正 反 向 工程 的 作用 ， 然 后 介绍 了 使 用 CIL 语 法 定义 命名 空间 、 类 
型 和 成 员 的 基础 知识 ， 最 后 研究 了 System.Reflection.Emit 命 名 空间 的 作用 以 及 如 何在 运行 时 动态 构 
造 程序 集 ( 使 用 CIL 指 令 )。 
当然 ， 很 少 有 程序 员 会 在 日 常 工作 中 使 用 原始 的 CIL 代 码 。 因 此 ， 我 将 在 本 章 开 头 介绍 为 什么 了 
解 这 个 底层 .NET 语 言 的 语法 和 语义 是 很 重要 的 。 


18.1 学 习 CIL 语法 的 原因 


CIL 本 质 上 其 实 就 是 .NET 平 台 的 母语 。 当 开发 人 员 选 择 一 种 托管 的 编程 语言 ( C#、VB、F#、 
COBOL.NET 等 ) 构建 .NET 程序 集 时 ， 同 这 个 语言 相关 联 的 编译 器 就 会 把 源 代码 翻译 成 CIL。 正 如 其 
他 任何 一 种 编程 语言 一 样 ，CIL 提 供 了 非常 多 的 结构 和 实现 标记 。 如 果 考 虑 到 CIL 其 实 也 是 一 种 .NET 
编程 语言 ， 那 么 通过 直接 使 用 .NET Framework 4.5 SDK 提 供 的 CIL 和 CIL 编 译 器 ( ilasm.exe ) 来 开发 和 
构建 .NET 程 序 集 也 就 不 会 让 人 吃惊 了 。 

事实 上 很 少 有 人 会 选择 完全 使 用 CIL 来 构建 一 个 NET 应 用 程序 ， 不 过 CIL 本 身 还 是 非常 有 趣 的 ， 
同时 也 可 以 把 它 看 成 体现 程序 员 智 慧 的 技术 。 简 单 地 说 ， 对 CIL 的 语法 理解 的 越 多 ， 那 么 就 越 有 可 能 
进入 .NET 的 高 级 领域 。 具 体 一 点 儿 说 ， 理 解 并 掌握 CIL 的 人 应 该 能 够 达到 以 下 几 点 。 

口 清楚 地 理解 不 同 的 .NET 编 程 语言 是 如 何 映射 它们 各 自 的 关键 字 到 CIL 标 记 上 的 。 

口 反 汇 编 一 个 已 经 存在 的 .NET 程 序 集 ， 直 接 编辑 CIL 代 码 ， 最 后 重新 编译 更 改 后 的 代码 到 .NET 

二 进 制 文件 。 例 如 ， 有 些 情况 下 为 了 与 一 些 高 级 COM 特 性 交互 ， 需 要 修改 COM。 

口 使 用 System.Reflection.Emit 命 名 空间 构建 动态 程序 集 。 这 个 API 人 允许 我 们 在 内 存 中 生成 .NET 

程序 集 ， 并 且 可 以 选择 将 其 持久 化 到 磁盘 中 。 

口 理解 那些 存在 于 CIL 层 中 ， 但 是 不 被 高 级 托管 语言 所 支持 的 CTS 的 特性 。 要 知道 ，CIL 是 唯一 

一 种 允许 你 访问 和 使 用 所 有 CTS 特 性 的 .NET 语 言 。 例 如 ， 使 用 纯粹 的 CIL， 就 可 以 定义 全 局 的 
成 员 和 字段 ， 而 这 在 C# 中 是 不 允许 的 。 
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最 后 ， 再 次 强调 一 下 ， 即 使 你 不 想 在 CIL 细 节 上 纠缠 ， 也 完全 有 能 力 掌 握 C# 和 .NET 的 基础 类 库 。 
从 很 多 方面 来 看 ，CIL 对 于 .NET 开 发 人 员 就 好 像 汇编 语言 对 于 一 个 C++ 程 序 员 一 样 。 那 些 精通 底层 细 
节 的 开发 人 员 就 可 以 具备 应 用 高 级 技术 手段 来 解决 手 上 问题 的 能 力 ， 同 时 对 于 编程 ( 运行 ) 环境 底层 
也 会 有 一 个 深入 的 理解 。 如 果 你 愿意 接受 挑战 ， 那 么 就 让 我 们 一 同 来 揭 开 CIL 的 神秘 面纱 吧 。 
说 明 本 章 并 不 是 要 全 面 讲述 CIL 语 法 和 语义 的 各 个 方面 。 如 果 有 这 方面 的 需要 ， 推 荐 你 从 ECMA 官 
方 网 站 ( www.ecma-international.org ) 下 载 官 方 ECMA 标 准 (ecma-335.pdf )。 





18.2 ClIL 指令 、 特 性 和 操作 码 


当 研 究 CIL 这 样 的 底层 开发 语言 时 , 一 定 会 发 现 一 些 非常 熟悉 的 概念 被 套用 上 了 新 的 名 字 。 例如 ， 
如 果 在 这 里 列 出 如 下 这 些 关键 字 : 

{new, public, this, base, get, set, explicit, unsafe, enum, operator, partial} 

你 当然 知道 它们 是 C# 的 关键 字 。 然 而 ， 如 果 再 仔细 看 看 这 个 集合 中 的 成 员 , 也 许 会 发 现 尽 管 它们 
是 C# 中 的 关键 字 , 但 是 它们 有 着 本 质 上 的 语义 区 别 。 比 如 ，enum 这 个 关键 字 定 义 了 一 个 从 System.Enum 
派生 的 类 型 ，this 和 base 关 键 字 人 允许 分 别 引 用 当前 的 对 象 或 者 当前 对 象 的 父 类 。unsafe 关 键 字 被 用 来 
确认 一 个 不 可 以 直接 被 CLR 监 控 的 代码 段 ，operator 则 允许 构建 一 个 可 以 通过 特定 的 C# 操 作 符 ( 例如 
加 号 pi 

同 C# 这 样 的 高 级 语言 完全 不 同 的 是 ，CIL 不 仅仅 定义 了 一 组 通用 的 关键 字 。 而 且 根 据 语 义 上 的 内 
涵 不 同 ， ipt 步 被 划分 到 3 个 类 别 中 。 

口 CIL 指 令 ( directive )。 

口 CIL 特 性 (attribute )。 

口 CIL 操 作 码 ( opcode )。 

每 一 个 类 别 的 CIL 标 记 都 通过 一 个 特别 的 语法 来 表示 ， 这 些 标记 组 织 到 一 起 就 可 以 构建 出 一 个 有 
效 的 .NET 程 序 集 。 


18.2.1 CIL 指 令 的 作用 


在 CIL 的 标记 集中 有 这 样 一 组 用 于 描述 .NET 程 序 集 总 体 结构 的 标记 ,它们 被 称 作 CIL 指 令 。CIL 指 
令 用 于 通知 CIL 编 译 器 如 何 定 义 在 程序 集中 用 到 的 命名 空间 、 类 型 和 成 员 。 

CL 指 令 在 语法 上 使 用 一 个 点 (.) 前 级 来 表示 ( 例如 .namespace 、.class 、.publickeytok- 
en、.method、.assembly 等 )。 因 此 ， 如 果 你 的 *.il 文 件 ( CIL 代 码 文 件 的 扩展 名 ) 有 1 个 .namespace 指 令 
和 3 个 .class 指 令 ， 那 么 CIL 编 译 圳 将 在 生成 的 程序 集 里 产生 一 个 包含 有 3 个 .NET 类 类 型 的 命名 空间 。 


18.2.2 “CIL 特 性 的 作用 


在 很 多 情况 下 , 仅仅 CIL 指 令 不 足以 表示 给 出 的 .NET 类 型 或 者 类 型 成 员 。 基 于 这 个 原因 , 很 多 CIL 
指令 可 以 同 CIL 特 性 结合 起 来 使 用 ，CIL 特 性 可 以 限定 应 该 如 何 处 理 一 个 CIL 指 令 。 例 如 ， 一 个 .class 
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指令 可 以 用 public 特 性 (建立 这 个 类 型 的 可 见 性 )、extends 特 性 〈 明确 指定 这 个 类 型 的 基 类 ) 和 
implements 特 性 ( 列 出 这 个 类 型 支持 的 一 系列 接口 ) 修饰 。 


说 明 不 要 混淆 “.NET 特 性 ”( 见 第 15 章 ) 和 “CIL 特 性 ”， 它 们 是 不 同 的 概念 。 


18.2.3 ”CIL 操 作 码 的 作用 


一 个 .NET 程 序 集 、 命 名 空间 和 类 型 通过 CIL 的 指令 和 相关 的 特性 来 定义 后 ， 最 后 的 任务 就 是 提供 
类 型 的 实现 逻辑 。 这 就 是 CIL 操 作 码 的 职责 范围 。 沿 用 底层 开发 语言 的 习惯 ，CIL 操 作 码 往往 是 无 法 念 
出 来 的 。 例 如， 如 果 你 需要 定义 一 个 字符 串 变量 , 你 使 用 的 不 是 一 个 容易 理解 的 操作 名 字 Loadstring， 
而 是 ldstr。 

老实 说 , 有 些 CIL 操 作 码 是 可 以 直接 和 C# 中 的 操作 符 对 应 起 来 ( 例如 box、unbox 、 throw 和 sizeof )。 
读者 将 看 到 ，CIL 操 作 码 总 是 在 成 员 实 现 的 作用 域内 使 用 ， 同 CIL 指 令 不 同 ， 它 们 并 不 需要 点 前 级 。 


18.2.4 ”区别 CIL 操 作 码 和 CIL 助 记 符 


正如 刚刚 说 明 的 , 像 ldstr 这 样 的 操作 码 被 用 来 实现 一 个 给 定 类 型 的 成 员 。 不 过 在 现实 中 , 像 ldstr 
这 样 的 标记 其 实 是 用 来 表示 真正 二 进 制 操作 码 的 CIL 助 记 符 。 为 了 说 明 区 别 ， 我 们 来 看 一 段 C# 的 代码 : 


static int Add(int x, int y) 


return x + yj 


用 来 表示 两 个 数 相 加 的 CIL 操 作 码 是 0x58， 用 来 表示 两 个 数 相 减 的 操作 码 是 0x59， 在 托管 堆 上 分 
配 一 个 新 对 象 的 操作 码 是 ox73。 事 实 上 ， 由 JIT 编 译 器 来 处 理 的 CIL 代 码 无 外 乎 是 一 堆 二 进 制 数据 。 

幸好 , 每 一 个 二 进 制 的 CIL 操 作 码 都 对 应 有 一 个 助 记 符 。 例 如, 可 以 使 用 add 而 不 是 二 进 制 的 0x58， 
sub 而 不 是 ox59，newobj 而 不 是 ox73。 明 白 了 两 者 的 区 别 ， 就 可 以 清楚 像 ildasm.exe 这 样 的 CIL 反 编译 器 
就 是 将 二 进 制 的 操作 码 翻译 成 它们 所 对 应 的 CIL 助 记 符 。 例如, 下 面 就 是 ildasm.exe 为 之 前 的 Add() 提 供 
的 CIL: 


.method private hidebysig static int32 Add(int32 xy 
int32 y) cil managed 


// 代码 大 小 9 ( 0x9) 
.maxstack 2 

.locals init ([0] int32 CS$1$0000) 
IL 0000: nop 

IL 0001: ldarg.0 

IL 0002: ldarg.1 
IL_0003: add 

IL 0004: stloc.0 

IL 0005: br.s IL 0007 
IL 0007: 1dloc.0 

IL 0008: ret 
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除非 需要 构造 非常 底层 的 .NET 软 件 ( 比如 自 定 义 的 托管 编译 器 ), 否则 不 需要 关心 这 些 CIL 的 数字 
操作 码 。 实 际 上 ， 当 .NET 开 发 人 员 在 说 “CIL 操 作 码 ”时 ， 通 常 是 指 那些 助 记 标 记 而 不 是 底层 的 那些 
二 进 制 数值 。 


18.3 入 栈 和 出 栈 : CIL 基于 栈 的 本 质 


像 C# 这 样 的 高 级 .NET 语 言 ， 总 是 试图 尽量 隐藏 底层 的 实现 。.NET 开 发 一 个 不 太 为 人 注意 的 方面 
就 是 CIL 实 际 上 是 一 个 完全 以 栈 为 基础 的 开发 语言 。 回 忆 我 们 前 面 学 习 的 关于 集合 命名 空间 ( 请 参看 
第 9 章 ) 中 Stackx<T> 类 的 功能 ， 它 用 于 压 一 个 值 人 栈 ， 同 时 也 能 够 将 栈 顶 的 值 弹 出 来 以 供 使 用 。 当 然 ， 
CIL 开 发 人 员 不 是 使 用 Stack<T> 类 的 对 象 来 实现 人 栈 和 出 栈 的 ， 不 过 从 思路 上 是 相通 的 。 

正式 地 说 ， 在 CIL 中 用 来 负责 这 个 栈 实现 的 部 分 叫做 虚拟 执行 栈 ( virtual execution stack) 。 从 下 
面 的 介绍 中 ， 你 将 看 到 CIL 提 供 了 一 系列 操作 码 来 完成 压 人 值 到 这 个 栈 中 ， 这 个 过 程 的 术语 叫 加 载 。 
同时 ，CIL 也 定义 了 一 系列 操作 码 来 将 栈 项 的 值 移 到 内 存 中 (例如 本 地 变量 )， 这 个 过 程 的 术语 叫 存 
储 (store) 。 

CIL 不 允许 直接 访问 一 个 数据 ， 包 括 本 地 变量 、 方 法 中 传人 的 变量 或 者 类 型 的 字段 数据 。 为 了 实 
现 访问 ， 必 须 显 式 地 加 载 数 据 到 栈 中 ， 并 在 使 用 时 弹出 (请 留心 这 一 点 ， 因 为 这 能 够 解释 为 什么 CIL 
代码 看 起 来 有 些 元 余 )。 


说 明 回忆 一 下 ，CIL 不 会 直接 执行 ， 而 是 按 需 编译 。 在 CIL 代 码 编译 的 时 候 ， 很 多 实现 的 完 余 可 以 
优化 去 除 。 此 外 ,如 果 为 当前 项 目 开 局 代码 优化 ( 使 用 Visual Studio Project Properties 窗 口 的 Build 
标签 )， 编 译 器 就 会 移 除 各 种 CIL 宛 余 。 


下 面 通过 一 段 简单 的 没有 参数 和 返回 值 的 函数 PrintMessage() , 理解 CIL 是 如 何 应 用 这 个 基于 栈 的 
处 理 模型 的 。 在 实现 这 个 方法 时 ， 我 们 只 将 一 个 本 地 字符 串 变 量 输出 到 标准 的 输出 流 ; 
public void PrintMessage() 


String myMessage = "Hello."; 
Console.WritelLine(myMessage); 


如 果 你 观察 过 C# 编 译 器 是 如 何 将 这 个 方法 翻译 成 CIL 的 ， 将 会 首先 看 到 printMessage() 方 法 使 
用 .locals 指 令 为 本 地 变量 定义 了 一 个 存储 空间 。 接 着 ， 这 个 本 地 字符 串通 过 ldstr ( 加 载 字符 串 ) 和 
stloc.0 (可 以 这 样 理解 : 存储 当前 的 值 到 索引 为 零 的 本 地 变量 ) 被 加 载 和 存储 到 这 个 本 地 变量 中 。 

这 个 在 索引 0 处 的 值 接着 通过 ldloc.0 (加 载 索 引 为 0 的 局 部 参数 ) 被 加 载 到 内 存 来 供 
System.Console.WriteLine() 方 法 使 用 (通过 call 操 作 码 指定 )。 最 后 , 这 个 方法 以 ret 操 作 码 结束 返回 。 
下 面 是 PrintMessage() 方 法 的 CIL 代 码 ( 注意 ， 为 了 简洁 ， 我 删除 了 nop 操 作 码 ): 


.method public hidebysig instance void PrintMessage() cil managed 


.maxstack 1 


// 定义 一 个 本 地 字符 事变 量 (在 索引 0 处 ) 
.locals init ([0] string myMessage) 


18.4 正 反 向 工程 533 


// 加 载 一 个 值 为 "Hel1o 的 字符 事 
ldstr ”Hello.” 


// 存储 字符 事 的 值 到 栈 上 的 本 地 变量 
stloc.0 


// 调用 索引 0 处 的 值 
1dloc.0 


// 使 用 当前 的 值 调用 方法 
call void [mscorlib]jsystem.Console: :WriteLine(string) 
et 


说 了 明 你 可 以 看 到 ，CIL 支 持 使 用 双 斜 杠 的 注释 语法 ( 也 支持 /*...*/ 这 个 语法 )。 同 CH# 一 样 ， 注 释 将 被 
CIL 编 译 器 完全 忽略 。 


介绍 了 CIL 指 令 、 特 性 和 操作 符 基础 知识 之 后 ,现在 来 研究 CIL 编 程 的 实际 使 用 , 我 们 从 正 反 向 工 
程 开始 讨论 。 


18.4 正 反 回 工程 


读者 已 经 知道 可 以 使 用 ildasm.exe 来 查看 由 C# 编 译 器 生成 的 CIL 代 码 (参见 第 1 章 )。 不 过 也 许 不 知 
道 ildasm.exe 还 允许 将 加 载 到 ildasm.exe 的 程序 集中 的 CIL 都 导出 到 一 个 外 部 文件 中 。 一 旦 有 了 CIL 代 码 ， 
就 可 以 使 用 CIL 编 译 器 ilasm.exe 任 意 编辑 和 重新 编译 代码 。 


说 明 记得 吗 ，reflectorexe 可 以 用 于 查看 某 个 程序 集 的 CIL 代 码 ， 也 可 以 把 CIL 代 码 翻 译 为 接近 的 C# 
代码 。 


这 个 技术 叫做 正 反 向 工程 (round-trip engineering ) 。 在 以 下 这 些 情 况 下 ， 它 将 很 有 用 处 。 

口 需要 修改 一 个 没有 源 代码 的 程序 集 。 

口 正在 使 用 的 .NET 语 言 编译 器 不 够 完美 ， 产 生 了 一 些 效率 不 足 的 CIL 代 码 ， 而 用 户 希 望 修改 。 

口 用 户 在 构造 可 与 COM 互 操作 的 库 并 且 希 望 补充 那些 在 转换 过 程 中 丢失 的 IDL 特 性 ， 例 如 COM 

的 [helpstring] 特 性 。 

为 了 解释 正 反 向 工程 的 过 程 , 我 们 使 用 文本 编辑 器 来 创建 一 个 新 的 C# 代 码 文件 ( HelloProgram.cs )， 
并 且 定 义 下 面 的 类 类 型 ( 如 果 你 愿意 ， 也 可 以 使 用 Visual Studio 创 建新 的 控制 台 项 目 。 但 是 记 住 要 删 
除 AssemblyInfo.cs 这 个 文件 来 减少 生成 的 CIL 代 码 数量 ): 

// 简单 的 C# 榨 制 台 程序 


using Systemj 


// 注意 ， 不 能 在 命名 空间 中 包括 类 ， 以 简化 生成 的 CIL 代 码 
class Program 


static void Main(string[] args) 
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Console.WritelLine("Hello CIL code!"); 
Console.ReadLine(); 


} 
将 这 个 文件 保存 到 一 个 方便 的 位 置 ( 如 C:\RoundTrip )， 然 后 使 用 csc.exe 编 译 : 


csc Helloprogram.cs 


现在 ， 全 FleaDump 冰 是 省 天 打开 全 有 jia exe 的 HelloProgram.exe, 将 原始 CIL 代 码 保存 到 一 个 
新 的 *.il 文 件 ( HelloProgram.il )， 这 个 文件 位 于 包含 已 编译 程序 集 的 文件 夹 中 ( 结果 对 话 框 中 的 所 有 默 
认 值 都 保持 不 变 )。 


说 明 “将 程序 集中 的 内 容 转 储 到 文件 时 ，ildasm.exe 会 生成 一 个 .res 文件 。 此 时 ， 本 章 所 有 的 源 代码 
文件 都 可 以 忽略 或 删除 ， 因 为 不 需要 再 用 到 它们 了 。 


现在 ， 可 以 使 用 任意 的 文本 编辑 器 查看 HelloProgram.il。 结 果 如 下 (有 少量 的 格式 更 改 和 
注释 ): 
// 引用 的 程序 集 


.assembly extern mscorlib 


.publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
.Ver 4:0:0:0 


// 我 们 的 程序 集 


.assembly Helloprogram 
/**** ”为 了 清楚 ， 删 除了 TargetFrameworkAttribute 数 据 ****/ 


.hash algorithm Ox00008004 
“Ver 0:0:0:0 


.module HelloProgram.exe 

.imagebase Ox00400000 

.file alignment 0x00000200 

.Stackreserve 0x00100000 

.Subsystem Ox0003 

.corflags 0x00000003 

// Program 类 的 定义 

.Class private auto ansi beforefieldinit Program 
extends [mscorlib]System.Object 


.method private hidebysig static void Main(string[] args) cil managed 


// 标识 出 这 个 方法 是 可 执行 文件 的 入 口 点 

.entrypoint 

.maxstack 8 

IL 0000: nop 

IL 0001: ldstr "Hello CIL code!" 

IL 0006: call void [mscorlib]System.Console::Writeline(string) 
IL_000b: nop 

IL O00c: call string [mscorlib]System.Console::ReadLine() 

IL 0011: pop 
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It 0012; Tet 


// 默认 构造 函数 
.method public hidebysig specialname rtspecialname 
instance void .ctor() cil managed 


.maxstack 8 
IL 0000: ldarg.0 
IL 0001: call instance void [mscorlib]System.Object::.ctor() 
IL 0006: ret 
} 
} 


首先 需要 注意 的 是 , 打开 的 *.il 文 件 声明 了 编译 当前 程序 集 所 需要 引用 的 外 部 程序 集 。 这 里 , 读者 
可 以 看 到 有 一 个 .assembly extern 标 记 用 来 标识 总 会 出 现 的 mscorlib.dll。 当 然 ， 读 者 的 类 库 也 许 会 用 
到 其 他 程序 集 的 类 型 ， 那 么 就 会 在 这 里 看 到 对 应 的 .assembly extern 指 令 。 

接着 看 到 的 是 被 赋予 了 一 个 默认 0.0.0.0 版 本 的 HelloProgram.exe 程 序 集 的 正式 定义 ( 如 果 没 有 通 
过 [AssemblyVersion] 特 性 来 指定 一 个 值 的 话 )。 接 下 来 是 进一步 通过 .module、.imagebase 这 些 CIL 指 令 
进一步 说 明 该 程序 集 。 

在 记录 了 引用 的 外 部 程序 集 和 定义 了 当前 的 程序 集 后 , 定义 Program 类 型 。 请 注意 这 个 .class 指 令 
有 很 多 特性 ( 多数 是 一 些 可 选 的 特性 )， 例 如 extends， 它 标识 该 类 型 的 基 类 : 


.Class private auto ansi beforefieldinit Program 
extends [mscorlib]System.Object 
er 


其 余 代码 实现 了 这 个 类 的 默认 构造 函数 和 Main() 方 法 , 都 用 .method 指 令 定 义 。 一 旦 成 员 通过 正确 
的 指令 和 特性 定义 后 ， 就 由 操作 码 来 实现 。 

有 一 点 非常 重要 ， 在 CIL 中 与 .NET 类 型 ( 例如 System.Console ) 交互 时 ， 总 是 需要 使 用 这 个 类 型 
的 完全 限定 名 。 而 且 , 在 这 个 完全 限定 名 前 还 需要 加 上 以 方 括号 括 起 的 定义 这 个 类 型 的 程序 集 的 友好 
名 字 。 考 虑 下 面 Main() 方 法 的 CIL 实 现 : 


.method private hidebysig static void Main(string[] args) cil managed 


.entrypoint 

.maxstack 8 

IL 0000: nop 

IL 0001: ldstr "Hello CIL code!”" 

IL 0006: call void [mscorlib]System.Console::WritelLine(string) 


IL_000b: nop 
IL O00c: call string [mscorlib]System.Console::ReadLine() 
IL 0011: pop 
IL 0012: ret 


} 

下 面 CIL 代 码 中 的 默认 构造 函数 使 用 了 另外 一 个 “围绕 加 载 ”( load-centric ) 的 操作 指令 ( ldarg.0 )。 
这 里 ， 加 载 到 栈 中 的 值 不 是 由 我 们 给 出 的 自 定义 变量 ， 而 是 当前 的 对 象 引用 ( 下面 会 进一步 说 明 )。 
同时 也 要 注意 ， 这 个 默认 的 构造 函数 显 式 地 调用 了 基 类 的 构造 函数 ， 这 里 就 是 System.0bject: 


.method public hidebysig specialname rtspecialname 
instance void .ctor() cil managed 


.maxstack 8 
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IL_0000: ldarg.0 
IL_0001: call instance void [mscorlib]System.Object::.ctor() 
IL_0006: ret 


} 


18.4.1 CIL 代 码 标签 的 作用 


读者 一 定 已 经 注意 到 了 ， 在 每 一 行 代码 前 都 有 一 个 形 如 IL_XXXX: 的 前 级 ( 例如 IL_0000: 、IL_0001 
等 )。 这 些 标记 被 称 作 代码 标签 ( code label ) ， 是 可 以 随便 修改 的 ( 只 要 在 同一 个 成 员 作 用 域 中 没有 
重复 )。 当 使 用 ildasm.exe 导 出 一 个 程序 集 时 ,将 会 自动 在 前 面 加 上 IL_xXXX 这 样 的 代码 标签 。 当 然 ， 也 
可 以 用 更 有 描述 性 的 方法 来 标识 : 
.method private hidebysig static void Main(string[] args) cil managed 
.entrypoint 
.maxstack 8 
Nothing 1: nop 
Load String: ldstr “Hello CIL code!”" 
PrintToConsole: call void [mscorlib]jSystem.Console: :WriteLine(string) 
Nothing 2: nop 
WaitFor KeyPress: call string [mscorlib]System.Console::ReadLine() 


RemoveValueFromStack: pop 
Leave_ Function: ret 


事实 上 ， 大 多 数 代 码 标签 完全 是 可 选 的 。 只 有 当 我 们 编写 有 多 个 分 支 和 循环 结构 的 CIL 代 码 ， 通 
过 这 些 代码 标签 指定 逻辑 流转 到 哪里 的 时 候 ， 这 些 代 码 标签 才 是 必需 的 。 对 于 当前 的 示例 ， 完 全 可 以 
全 部 移 除 这 些 自动 生成 的 标签 ， 不 会 有 什么 副作用 : 
.method private hidebysig static void Main(string[] args) cil managed 
.entrypoint 
.maxstack 8 
nop 
ldstr "Hello CIL code!" 
call void [mscorlib]System.Console::Writeline(string) 
call string [mscorlib]System.Console: :ReadLine() 
pop 


} 


18.4.2 与 ClL 交 互 : 修改 *.il 文 件 


现在 ， 在 对 基本 的 CIL 文 件 的 组 成 有 所 了 解 的 基础 上 ， 完 成 正 反 向 工程 之 旅 。 我 们 的 目标 是 对 这 
个 CIL 文 件 做 如 下 修改 : 

口 增加 对 System.Windows.Forms.dll 程 序 集 的 引用 ; 

口 在 Main() 中 增加 加 载 一 个 局 部 字符 串 ; 

口 调用 System.Windows.Forms.MessageBox.Show() 方 法 ， 使 用 上 面 的 局 部 字符 串 作 为 参数 。 

首先 通过 增加 一 个 新 的 .assembly 指 令 (用 extern 特 性 修饰 ) 来 表示 你 需要 使 用 System.Windows. 
Forms.d1 程 序 集 。 我 们 只 需要 修改 *.i 文 件 ， 在 表示 外 部 引用 mscorlib 的 代码 后 增加 如 下 逻辑 : 
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.assembly extern System.Windows.Forms 


.publickeytoken = (B7 7A 5C 56 19 34 EO 89) 
Ver 4:0:0:0 


} 

要 清楚 的 是 ， 赋 给 .ver 指 令 的 数值 可 能 会 根据 你 所 安装 的 .NET 平 台 版 本 的 不 同 而 不 同 。 在 上 面 ， 
我 们 使 用 的 是 System.Windows.Forms.dll 的 4.0.0.0 版 本 ， 它 的 公 钥 标记 是 B77A5C561934E089。 如 果 打 开 
GAC (人 参照 第 14 章 ) 查 到 你 计算 机 上 的 System.Windows.Forms.dll 程 序 集 版 本 ,就 可 以 复制 正确 的 版 本 
和 公 钥 标记 的 值 。 

下 面 ， 需 要 修改 Main() 函 数 。 从 *.il 文 件 中 找到 这 个 函数 ， 删 除 实现 部 分 ( 需要 保留 .maxstack 
和 .entrypoint 指 令 ， 关 于 这 两 个 指令 的 作用 后 面 有 详细 的 说 明 ): 

.method private hidebysig static void Main(string[] args) cil managed 

.entrypoint 
.maxstack 8 


// TO0D0: 编写 新 的 CIL 代 码 
} 


重复 一 下 ,我们 的 目的 是 将 一 个 新 的 字符 串 和 人 栈 ， 然 后 调用 MessageBox.Show() 方 法 (而 不 是 原来 
的 Console.WriteLine() 方 面 )。 前 面 提 到 过 ， 在 使 用 外 部 定义 的 类 型 时 ， 必 须 使 用 这 个 类 型 的 完整 名 
称 ( 同 程序 集 的 友好 名 称 结合 使 用 )。 也 请 注意 ,在 CIL 中 , 每 个 方法 调用 记录 完整 的 返回 类 型 将 Main() 
方法 修改 如 下 : 


.method private hidebysig static void Main(string[] args) cil managed 


.entrypoint 
.maxstack 8 


ldstr "CIL is way cool" 

call valuetype [System.Windows.Forms] 
System.Windows.Forms.DialogResult 
[System.Windows.Forms] 
System.Windows.Forms.MessageBox: :Show(string) 


pop 
ret 


} 
实际 上 ， 上 面 的 CIL 代 码 上 对 应 于 如 下 的 C# 类 定义 : 


class Program 
static void Main(string[] args) 
System.Windows.Forms.MessageBox.Show("CIL is way cool"); 


} 


18.4.3 ”使 用 ilasm.exe 编 译 ClL 代 码 

假设 已 经 修改 并 保存 了 这 个 *.il 文 件 ， 就 可 以 使 用 ilasm.exe ( CIL 编 译 器 ) 来 编译 一 个 新 的 NET 程 
序 集 。 这 个 CILL 编 译 器 有 大 量 命令 行 参 数 ( 通过 -? 选 项 可 以 查看 它们 )。 表 18-1 列 出 了 一 些 重要 的 
参数 。 
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表 18-1 ilasm.exe 的 命令 行 参数 





参 数 作 用 

/debug 包括 调试 信息 〈 例如 本 地 变量 、 参 数 的 名 字 和 行 号 ) 

/dll 输出 *.dll 文 件 

/exe 输出 *.exe 文 件 。 这 个 是 默认 设置 ， 可 以 忽略 

/key 编译 程序 集 时 使 用 给 定 的 *.snk 文 件 强 名 字 

/output 指定 输出 的 文件 名 和 扩展 名 。 如 果 没 有 使 用 此 参数 , 那么 产生 的 文件 名 ( 减 去 文件 扩展 名 ) 同 


第 一 个 源 文件 名 相同 


在 Developer Command 提 示 符 中 输入 以 下 命令 , 就 可 以 将 修改 后 的 HelloProgram.il 文 件 编译 成 NET 
的 *.exe 文 件 了 : 


ilasm /exe Helloprogram.il /output=NewAssembly.exe 


如 果 一 切 都 正确 ， 那 么 将 看 到 一 个 如 下 所 示 的 报告 : 





Microsoft (R) .NET Framework IL Assembler. Version 4.0.21006.1 
Copyright (c) Microsoft Corporation. All rights reserved. 
Assembling 'HelloProgram.il' to EXE --> 'NewAssembly.exe' 
Source file is UTF-8 


Assembled method Program: :Main 
Assembled method Program::.ctor 
Creating PE file 


Emitting classes: 
Class 1: Program 


Emitting fields and methods: 
Global 

Class 1 Methods: 2; 

Emitting events and properties: 
Global 

Class 1 

Writing PE file 

Operation completed successfully 





现在 ， 可 以 运行 这 个 新 生成 的 程序 了 。 这 次 将 看 到 消息 显示 在 消息 框 中 而 不 是 控制 台 窗口 中 。 尽 
管 这 个 简单 示例 的 输出 结果 没什么 大 不 了 的 ， 但 它 演示 了 CIL 正 反 向 编程 的 一 种 实际 用 法 。 


18.4.4 ”peverify.exe 的 作用 


当 使 用 CIL 代 码 编译 和 修改 程序 集 时 ， 最 好 能 够 使 用 peverify.exe 命 令 行 工 具 来 验证 编译 的 二 进 制 
映像 文件 格式 上 是 正确 的 .NET 映 像 文 件 。 

peverify NewAssembly.exe 

这 个 工具 检查 指定 的 程序 集 文 件 中 的 所 有 操作 码 是 否 是 有 效 的 CI 代码。 例如 ， 就 CIL 代 码 而 言 ， 
赋值 的 栈 在 退出 一 个 函数 之 前 必须 是 空 的 。 如 果 忘 记 弹 出 任何 保存 的 值 ，ilasm.exe 编 译 器 仍然 会 生成 
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一 个 有 效 的 程序 集 ( 因为 编译 器 仅仅 关心 语法 )。 男 一 个 方面 ，peverify.exe 关 心 的 是 语义 。 如 果 和 起 记 
在 退出 函数 前 清空 栈 ，peverify.exe 将 会 在 你 试图 运行 代码 库 之 前 通知 你 。 


源 代 码 ”RoundTrip 文 件 的 源 代 码 位 于 Chapter 18 子 目录 下 。 


18.5 ”ClIL 指令 和 特性 


现在 已 经 知道 如 何 使 用 ildasm.exe, 并 且 使 用 ilasm.exe 来 进行 正 反 向 工程 ,我 们 就 可 以 研究 一 下 CIL 
自身 的 语法 以 及 语义 。 在 下 面 的 内 容 里 ， 我 们 来 共同 完成 一 个 包含 有 多 个 类 型 的 自 定义 命名 空间 。 不 
过 , 为 了 简化 ， 这些 类 型 将 不 包含 成 员 的 实现 部 分 。 只 要 掌握 了 如 何 创建 空 类 型 ， 就 可 以 进一步 考虑 
如 何 使 用 CIL 操 作 码 来 实现 真正 意义 上 的 成 员 了 。 


18.5.1 在 CIL 中 指定 外 部 引用 程序 集 


使 用 任意 一 种 编辑 器 创建 一 个 名 为 CILTypes.il 的 文件 。 首 先 ， 列 出 所 有 被 当前 程序 集 使 用 到 的 外 部 
程序 集 。 本 例 中 将 只 用 到 mscorlib.dll 中 定义 的 类 型 。 为 此 ， 需 要 使 用 external 特 性 限定 .assembly 指 令 。 
如 果 引 用 的 是 一 个 强 名 字 程 序 集 ， 例 如 mscorlib.dll， 还 需要 指定 .publickeytoken 和 .ver 指 今 : 


.assembly extern mscorlib 


-publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
.Ver 4:0:0:0 


说 明 ”严格 来 说 ,不 需要 显 式 引用 mscorlib.dll 作 为 外 部 引用 ， 因 为 ilasm.exe 会 自动 加 上 。 但 是 ， 对 于 
CIL 项 目 需要 的 每 一 个 外 部 .NET 库 ， 需 要 编写 类 似 的 .assembly extern 指 令 。 


18.5.2 ”在 CIL 中 定义 当前 程序 集 


下 一 步 要 做 的 是 使 用 .assembly 指 令 定义 当前 这 个 程序 集 。 在 最 简单 的 程度 上 , 一 个 程序 集 的 定义 
只 需要 给 出 二 进 制 文件 名 即 可 : 


// 我 们 的 程序 集 
.assembly CILTypes { } 


在 真正 意义 上 定义 一 个 .NET 程 序 集 时 , 还 需要 在 声明 部 分 中 增加 一 些 指 令 。 就 这 个 例子 而 言 ， 可 
以 通过 .ver 指 令 来 加 上 一 个 版 本 号 1.0.0.0( 注意 每 个 数字 之 间 是 使 用 冒号 来 分 开 的 ， 而 不 是 C# 中 常见 
的 点 ): 


// 我 们 的 程序 集 
.assembly CILTypes 
{ 


Ver 1:0:0:0 
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由 于 CILTypes 是 一 个 单 文件 程序 集 , 可 以 使 用 一 个 .module 指 令 来 完成 这 个 程序 集 的 定义 , 它 的 作 
用 是 给 出 这 个 .NET 二 进 制 文件 的 官方 名 称 一 一 CILTypes .d11: 
.assembly CILTypes 





:Ver 1:0:0:0 


} 
// 单 文件 程序 集 的 模块 
-module CILTypes.dll 


除了 .assembly 和 .module 之 外 ， 还 有 对 组 建 中 的 .NET 二 进 制 的 整个 结构 进行 进一步 配置 的 CIL 指 
令 。 表 18-2 列 出 了 几 个 常用 的 程序 集 级 别 的 指令 


表 18-2 ”其 他 以 程序 集 为 中 心 的 指令 


指 令 作 用 
“mresources 如果 你 的 程序 集 使 用 了 内 部 资源 ( 例如 位 图 或 者 字符 串 表 ), 这 个 指令 用 来 给 出 包含 了 内 内 资源 的 文 
件 名 称 


subsystem ”这 个 指令 用 来 给 出 指定 的 程序 集运 行 时 的 U1。 例如，2 表 示 这 个 程序 集 应 该 以 GUI 程 序 的 方式 运行 ， 
而 3 表示 这 是 一 个 控制 台 执 行程 序 


18.5.3 在 CIL 中 定义 命名 空间 


现在 ， 已 经 定义 了 程序 集 的 外 观 以 及 需要 使 用 的 外 部 程序 集 引 用 ， 接 下 来 可 以 使 用 .namespace 来 
创建 一 个 .NET 命 名 空间 MyNameSpace: 
// 我们 的 程序 集 有 一 个 命名 空间 


.namespace MyNamespace {} 

同 C# 一 样 ，CIL 命 名 空间 定义 可 以 租 套 在 其 他 命名 空间 内 部 。 这 里 我 们 不 需要 定义 根 命名 空间 ， 
但 为 了 说 明 清楚 ， 假 定 你 想 创建 一 个 叫做 MyCompany 的 根 命名 空间 : 

.namespace MyCompany 


.namespace MyNamespace {} 


同 C# 一 样 ，CIL 人 允许 定义 一 个 如 下 所 示 的 藤 套 命名 空间 : 
// 定义 一 个 号 套 的 命名 空间 


.namespace MyCompany.MyNamespace{} 


18.5.4 在 CIL 中 定义 类 类 型 


空 的 命名 空间 没有 什么 意义 ， 现 在 来 看 看 如 何 使 用 CIL 来 定义 类 类 型 。 读 者 应 该 不 会 感到 意 
外 ，.class 指 令 就 是 用 来 定义 一 个 新 类 的 。 不 过 ， 这 个 简单 的 指令 可 以 和 非常 多 的 特性 结合 使 用 来 实 
现 对 类 型 的 完整 定义 。 我 们 通过 增加 一 个 新 的 公共 类 MyBaseClass 来 演示 这 个 指令 。 正 如 在 C# 中 一 样 ， 
如 果 不 显 式 地 给 出 基 类 ， 类 型 将 自动 从 System.0bject 派 生 。 


.namespace MyNamespace 


// 假设 以 System.0bject 为 基 类 
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.Class public MyBaseClass {} 


当 定义 的 类 类 型 不 是 从 System.0bject 继 承 , 而 是 从 其 他 类 继承 时 ,就 需要 使 用 extends 特 性 。 就 算 
需要 引用 的 类 型 是 定义 在 同一 个 程序 集 里 的 ，CIL 也 要 求 使 用 完整 的 名 字 ( 不过， 如 果 基 类 型 是 在 同 
一 个 程序 集 里 ， 可 以 省 略 这 个 程序 集 的 友好 名 字 前 级 )。 因 此 ， 下 面试 图 扩展 MyBaseClass 类 的 代码 会 
导致 编译 器 错误 : 


// 这 段 代码 是 无 法 编译 的 
.namespace MyNamespace 


.Class public MyBaseClass {} 


.Class public MyDerivedClass 
extends MyBaseClass {} 


要 想 正 确 地 定义 MyDerivedClass 的 父 类 ， 必 须 给 出 MyBaseClass 的 完整 名 字 : 
// 好 多 了 


.namespace MyNamespace 
.Class public MyBaseClass {} 


.Class public MyDerivedClass 
extends MyNamespace.MyBaseClass {} 


除了 public 和 extends 特 性 外 ， 一 个 CIL 类 的 定义 还 可 以 使 用 其 他 特性 来 定义 类 型 的 可 视 性 、 字 段 
的 格式 等 。 表 18-3 给 出 了 一 些 (但 不 是 全 部 ) 可 以 同 .class 指 令 结合 使 用 的 特性 。 
表 18-3 同 .class 指 令 相 结合 的 特性 








特 性 作 用 
public、 private、 nested assembly、 CJL 定义 了 很 多 特性 ， 可 以 用 它们 来 定义 一 个 给 定 类 型 的 可 见 性 。 正 如 
nested famandassem、nested family、 你 所 见 到 的 ,原始 CIL 提 供 了 比 C# 要 多 得 多 的 选项 。 如 果 你 感 兴趣 ， 可 
nested famorassem、nested public 和 以 参考 ECMA 335 
nested private 
abstract sealed 这 两 个 特性 用 在 .class 指 令 中 , 分 别 用 来 定义 一 个 类 为 抽象 类 和 封闭 类 
auto、sequential 和 explicit 这 几 个 特性 用 来 指示 CLR 如 何 为 成 员 分 配 内 存 。 对 于 类 类 型 来 说 , 默认 


标志 auto 是 比较 合适 的 。 如 果 你 需要 使 用 平台 调用 访问 非 托 管 的 C 代 
码 ， 修 改 默认 值 会 很 有 用 

extends 和 implements 这 两 个 特性 分 别 定义 一 个 类 型 的 基 类 ( 通过 extends ) 和 实现 一 个 类 型 
的 接口 (通过 implements ) 


18.5.5 ”在 CLL 中 定义 和 实现 接口 


有 些 古 怪 的 是 ， 在 CILL 中 是 使 用 .class 指 令 定义 接口 类 型 的 。 不 过 ， 当 .class 同 interface 特 性 结 
合 使 用 时 ， 类 型 被 实现 为 CTS 接 口 类 型 。 一 旦 定义 了 接口 ， 就 可 以 使 用 implements 特 性 把 它 绑 定 到 一 
个 类 类 型 或 者 结构 类 型 上 : 
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.Namespace MyNamespace 


// 定义 一 个 接口 
.Class public interface IMyInterface {} 


// 一 个 简单 的 基 类 
.Class public MyBaseClass {} 


// My DerivedClass 实 现 IMyInterface， 并且 扩 展 MyBaseClass 类 
.Class public MyDerivedClass 
extends MyNamespace.MyBaseClass 
implements MyNamespace.IMyInterface {} 
; 


说 明 extends 子 句 必须 在 implements 子 名 之前。 同样 ，implements 子 句 可 以 合并 多 个 用 过 号 分 隔 的 接 
口 列表 。 


回顾 一 下 第 9 章 ， 为 了 实现 接口 的 继承 体系 ， 接 口 也 可 以 作为 其 他 接口 类 型 的 基 接 口 。 不 过 ,也 
许 和 你 想 的 相反 ，extends 特 性 不 可 以 用 来 从 接口 B 派 生出 接口 A。extends 特 性 只 能 够 和 一 个 类 型 的 基 
类 结合 使 用 。 如 果 需 要 拓展 一 个 接口 ， 可 以 利用 implements 特 性 : 


// 在 CIL 中 继承 一 个 接口 
.Class public interface IMyInterface {} 


.Class public interface IMyOtherInterface 
implements MyNamespace.IMyInterface {} 


18.5.6 ”在 CLL 中 定义 结构 


如 果 一 个 类 型 是 从 System.ValueType 扩 展 来 的 ， 那么 .class 指 令 可 以 用 来 定义 一 个 CTS 结 构 。 同 
时 ，.class 指 令 还 可 以 和 sealed 特 性 结合 使 用 ( 注意 结构 不 可 以 作为 其 他 类 型 的 基 类 )。 如 果 试 图 这 么 
做 ， 那么 ilasm.exe 会 报告 一 个 编译 器 错误 。 


// 结构 定义 总 是 密封 的 
.Class public sealed MyStruct 
extends [mscorlib]System.ValueType{} 


注意 CIL 提 供 了 一 个 简便 的 方法 来 定义 结构 类 型 。 如 果 使 用 了 value 特 性 ， 定 义 的 新 类 型 会 自动 从 
[mscorlib]Ssystem.ValueType 继 承 。 因 此 ， 可 以 像 下 面 这 样 定义 MyStruct: 


// 定义 一 个 结构 的 简便 方法 
.Class public sealed value MyStruct{} 


18.5.7 在 ClL 中 定义 枚 举 


.NET 枚 举 类 型 是 从 System.Enum 继 承 的 ， 而 后 者 是 System.ValueType 类 型 ( 因此 也 必须 是 密封 的 )。 
当 和 希望 用 CIL 定 义 一 个 枚 举 类 型 时 ， 可 以 直接 从 [mscorlib]Ssystem.Enum 上 扩展 : 
// 一 个 枚 举 


.Class public sealed MyEnum 
extends [mscorlib]System.Enum{} 
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同 结构 的 定义 类 似 ， 枚 举 类 型 可 以 使 用 enum 特 性 简便 定义 : 


// 快捷 方式 定义 枚 举 
.Class public sealed enum MyEnum{} 


我 们 稍 后 介绍 如 何 指定 枚 举 的 名 称 / 值 对 。 


说 明 .NET 的 基本 类 型 (委托 类 型 ) 也 有 专门 的 CIL 表 示 方法 。 详 细 信 息 请 参照 第 10 章 。 


18.5.8 在 CIL 中 定义 泛 型 


泛 型 类 型 在 CIL 语 法 中 也 有 特定 的 表示 。 在 第 9 章 中 说 过 , 泛 型 类 型 或 者 泛 型 成 员 可 以 有 一 个 或 多 
个 类 型 参数 。 例 如 ，List<T> 类 型 有 一 个 参数 ， 而 Dictinaty<TKey,TValue> 有 两 个 。 至 于 CIL， 类 型 参数 
的 个 数 通过 反 勾 号 (` ) 加 上 表示 类 型 参数 个 数 的 数值 来 指定 。 和 C# 相 似 ， 类 型 参数 的 实际 值 使 用 尖 
括号 封装 。 


说 明 在 大 多 数 键盘 上 ，` 字 符 可 以 在 Tab 键 上 面 找到 ( 1 键 的 左边 )。 


例如 ,假设 希望 创建 一 个 ListkT> 变 量 ， 其 中 T 是 System.Int32 类 型 的 。 可 以 在 CIL 中 按 如 下 所 示 写 
代码 : 


// 在 C# 中 : Listxint> myInts = new List<int>(); 
newobj instance void class [mscorlib] 
System.Collections.Generic.List 1¢<int32>::.ctor() 


注意 泛 型 类 被 定义 为 List`1<cint32> ， 因 为 List<T > 只 有 一 个 类 型 参数 。 如 果 我 们 需要 定义 
Dictionary<string,int> 类 型 的 话 ， 就 可 以 按 如 下 所 示 来 做 : 


// 在 C# 中 : Dictionary<string, int> d = new Dictionary<string, int>(); 
newobj instance void class [mscorlib] 
System.Collections.Generic.Dictionary 2<string,int32>::.ctor() 


再 举 一 个 示例 ， 如 果 我 们 的 泛 型 类 型 将 另外 一 个 泛 型 类 型 作为 参数 ， 就 可 以 如 下 写 CIL 代 码 : 


// 在 C# 中 : List<List<int>> myInts = new List<List<int>>(); 

newobj instance void class [mscorlib] 

System.Collections.Generic.List`1<class 
[mscorlib]System.Collections.Generic.List 1<int32>>::.ctor() 


18.5.9 ”编译 ClILTypes.il 文 件 


尽管 还 没有 给 定义 的 类 型 中 加 入 任何 成 员 和 实现 代码 ， 不 过 还 是 可 以 编译 这 个 *.il 文 件 到 一 
个 .NET DLL 程序 集 ( 必须 是 DLL， 因 为 还 没有 定义 Main() 方 法 )。 打 开 命令 提示 窗口 ， 输 入 如 下 所 示 
的 命令 到 ilasm.exe: 

ilasm /dll CilTypes.il 

一 旦 完成 了 上 面 这 步 , 就 可 以 使 用 ildasm.exe 打 开 编 译 的 程序 集 来 查看 各 个 类 型 的 创建 。 在 确认 了 
程序 集 文件 的 内 容 之 后 ， 运 行 peverify.exe 来 检查 它 : 


544 第 18 章 CIL 和 动态 程序 集 的 作用 


peverify CilTypes.dll 
注意 ， 如 果 所 有 类 型 都 是 空 的 ， 可 以 看 到 会 有 一 些 错 误 提示 。 下 面 是 部 分 输出 结果 : 





Microsoft (R) .NET Framework PE Verifier. Version 4.0.21006.1 
Copyright (c) Microsoft Corporation. All rights reserved. 


[MD]: Error: Value class has neither fields nor size parameter. [token:0x02000005] 
[MD]: Error: Enum has no instance field. [token:0x02000006] 





要 想 理解 如 何 来 编写 有 内 容 的 类 型 ， 首 先 要 仔细 看 看 CIL 的 基本 数据 类 型 。 


18.6 .NET 基础 类 库 、C# 和 CIL 数据 类 型 的 映射 


表 18-4 说 明了 .NET 基 类 类 型 是 如 何 映射 到 对 应 的 C# 关 键 字 上 的 ,以 及 C# 的 关键 字 是 如 何 映射 到 原 
始 CIL 的 。 同 时 ， 表 18-4 也 记录 了 这 些 CIL 类 型 的 速记 常量 符号 。 稍 后 将 会 看 到 ， 这 些 常量 常常 被 CIL 
操作 码 引 用 。 


表 18-4 映射 .NET 基 类 类 型 到 C# 关 键 字 ， 了 映射 C# 关 键 字 到 CIL 


.NET 基 类 类 型 C# 关 键 字 CIL 表 示 CIL 速 记 常 量 
System.SByte sbyte int8 I1 
System.Byte byte unsigned int8 U1 
System.Int16 short int16 I2 
System.UInt16 ushort unsigned int16 U2 
System.Int32 int int32 14 
System.UInt32 uint unsigned int32 U4 
System.Int64 long int64 I8 
System.UInt64 ulong unsigned int64 U8 
System.Char char char CHAR 
System.Single float float32 R4 
System.Doubjle double float64 R8 
System.Boolean bool bool BOOLEAN 
System.String string string A 
System.Object object object 无 
System.Void void void VOID 


说 明 System.IntPtr 和 System.UIntPtr 类 型 映射 为 本 地 的 int 和 unsigned int (许多 COM 互 操作 和 
P/Invoke 场 景 都 广泛 使 用 了 这 些 类 型 )。 


18.7 在 CIL 中 定义 类 型 成 员 
读者 已 经 知道 ，.NET 类 型 可 以 支持 多 种 成 员 。 枚 举 类 型 由 一 系列 名 称 / 值 的 对 构成 。 结 构 和 类 则 
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有 构造 函数 、 字 段 、 方 法 、 属 性 、 静 态 成 员 等 。 在 本 书 的 前 17 章 中 ， 你 已 经 看 到 了 部 分 成 员 的 CIL 定 
义 ， 不 过 这 里 再 重新 回顾 一 下 各 种 成 员 是 如 何 映射 到 CIL 的 。 
18.7.1 在 CIL 中 定义 数据 字段 


枚 举 、 结 构 和 类 都 支持 数据 字段 。 在 每 个 子 句 中 都 将 用 到 .field 指 令 。 举 个 例子 ， 给 MyEnum 这 个 
枚 举 类 型 框架 加 入 3 个 名 称 / 值 的 组 合 ( 注意 值 是 使 用 一 对 括号 来 指定 的 ): 


.Class public sealed enum MyEnum 





{ 
.field public static literal valuetype 
MyNamespace.MyEnum A = int32(0) 
.field public static literal valuetype 
MyNamespace.MyEnum B = int32(1) 
.field public static literal valuetype 
MyNamespace.MyEnum C = int32(2) 


在 .NET System.Enum 派 生 的 类 型 作用 域内 的 字段 可 以 支持 static 和 1literal 特 性 ， 读 者 可 能 已 经 猜 
到 了 ， 设 置 了 这 些 特性 后 ， 字 段 数据 的 值 可 以 通过 类 型 来 直接 访问 ( 例如 ，MyEnum.A )。 


说 明 ” 赋 到 枚 举 类 型 的 值 可 以 以 十 六 进 制 的 方式 〈 以 0x 为 前 缓 ) 给 出 。 


当然 ， 当 你 希望 在 类 或 者 结构 中 定义 一 个 数据 成 员 时 , 不 仅仅 可 以 定义 公共 静态 整 型 数据 。 比 如 ， 
你 可 以 更 新 MyBaseClass 来 支持 两 个 私有 的 对 象 级 别 的 字段 数据 : 
.Class public MyBaseClass 


.field private string stringField = "hello!" 
.field private int32 intField = int32(42) 


在 C# 中 ， 类 成 员 数据 可 以 被 自动 赋予 默认 的 值 。 如 果 你 希望 能 够 自 定 义 对 象 的 初始 值 ,那么 就 必 
须 创建 自 定义 的 构造 函数 。 


18.7.2 在 CIL 中 定义 类 型 的 构造 函数 


CTS 支 持 对 象 实例 化 层次 和 类 层次 ( 静态 ) 构 造 函 数 。 就 CI 生 而 言 ,实例 化 层次 的 构造 函数 使 用 .ctor 
来 表示 , 而 静态 的 构造 函数 通过 .cctor ( 类 构造 阴 数 ) 来 表示 。 这 两 个 CIL 标 记 必 须要 和 rtspecialname 
(返回 类 型 的 指定 名 字 ) 和 specialname 特 性 结合 才 可 以 使 用 。 简 单 地 说 ， 这 些 特性 用 于 标识 出 根据 所 
给 的 .NET 语 言 进行 特别 处 理 的 CIL 标 记 。 举 个 例子 ， 在 C# 中 ， 构 造 函 数 不 可 以 有 返回 类 型 ; 不 过 , 在 
CIL 中 ， 构 造 函 数 的 返回 值 实际 上 是 void: 


.Class public MyBaseClass 


.field private string stringField 
.field private int32 intField 


.method public hidebysig specialname rtspecialname 
instance void .ctor(string s, int32 i) cil managed 
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// T0D0: 加 入 实现 代码 


} 

注意 ，.ctor 指 令 是 和 instance 特 性 结合 使 用 的 ( 因为 它 不 是 一 个 静态 的 构造 函数 )。 上 面 的 cil 
managed 特 性 标识 出 这 个 方法 包含 的 是 CI 代码 而 不 是 非 托 管 代码 , 在 平台 发 出 请 求 期 间 才 可 使 用 非 托 
管 代码 。 


18.7.3 在 CIL 中 定义 属性 


属性 和 方法 也 有 CIL 的 标识 。 继 续 我 们 的 例子 ， 给 MyBaseClass 添 加 一 个 公共 属性 TheSstring， 需 要 
如 下 所 示 的 代码 ( 注意 ， 这 里 再 次 用 到 了 specialname 特 性 ): 
.Class public MyBaseClass 


.method public hidebysig specialname 
instance string get TheString() cil managed 


// T0D0: 加 入 实现 代码 


.method public hidebysig specialname 
instance void set TheString(string 'value') cil managed 


// T0D0: 加 入 实现 代码 


.property instance string TheString() 
{ 


.get instance string 
MyNamespace.MyBaseClass::get TheString() 

.Set instance void 
MyNamespace.MyBaseClass::set TheString(string) 


} 
就 CIL 而 言 ， 属 性 实际 上 是 映射 到 以 get_ 和 set 为 前 级 的 方法 对 。.property 指 令 使 用 相关 的 .get 
和 .set 指 令 将 属性 语法 映射 到 正确 的 、“ 被 特殊 命名 的 ”方法 上 。 


说 明 注意 属性 的 set 方 法 的 传 入 套数 放 在 单 引 号 中 ， 表 示 在 方法 作用 域 中 赋值 操作 符 的 右边 使 用 的 
标识 的 名 字 。 


18.7.4 ”定义 成 员 参 数 


简 而 言 之 ， 在 CIL 中 定义 参数 的 方法 和 在 C# 中 大 同 小 异 。 例 如 ， 每 一 个 定义 的 参数 都 要 给 出 数据 
类 型 和 参数 名 称 。 此 外 ， 同 C# 一 样 ，CIL 也 要 定义 输入 、 输 出 和 按 引用 传递 的 参数 。 同 样 ，CIL 还 允 
许 定义 参数 数组 ( 即 C# 中 的 params 关 键 字 ) 以 及 可 选 参数 。 

为 了 说 明 使 用 原始 CIL 定 义 参 数 的 过 程 ， 先 假设 你 需要 构造 一 个 方法 ， 它 可 传递 值 int32、 引 用 的 
int32 、[mscorlib]jSystem.Collection.ArrayList 以 及 int32 类 型 的 单 输出 参数 。 在 C# 中 ， 这 样 的 一 个 
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方法 表示 如 下 : 


public static void MyMethod(int inputInt, 
ref int refInt, ArrayList ar, out int outputInt) 





{ 
outputInt = 0; // 仅仅 为 了 让 C# 编 译 器 通过 编译 


如 果 要 把 这 个 方法 映射 到 CIL 语 法 上 ，C# 的 引用 参数 是 在 数据 类 型 的 后 面 加 上 8&8 符号 ( int328& )。 

输出 参数 也 是 使 用 一 样 的 方式 ， 只 是 又 加 上 了 CIL 的 [out] 标 记 。 要 注意 的 是 ， 如 果 一 个 参数 是 引 
用 类 型 ( 这 个 例子 中 是 [mscorlib]System.Collections.ArrayList 类 型 )， 需 要 加 上 一 个 class 标 记 的 前 
绥 (不 过 不 要 和 .class 指 令 混 消 )。 


.method public hidebysig static void MyMethod(int32 inputInt， 
int32& refInt, 
class [mscorlib]System.Collections.ArrayList ar, 
[out] int32& outputInt) cil managed 


ps 


18.8 ”剖析 CIL 操作 码 


在 这 一 章 里 ， 最 后 要 学 习 的 就 是 各 种 CIL 操 作 码 的 作用 。 回 忆 一 下 ， 操 作 码 就 是 一 种 简单 的 CIL 
标记 ， 用 于 构造 指定 成 员 的 实现 逻辑 部 分 。 完 整 的 CIL 操 作 码 集合 可 以 被 划分 到 下 面 3 个 大 的 类 别 中 。 

口 控制 操作 流程 的 操作 码 。 

口 求 值 表达 式 的 操作 码 。 

口 (通过 参数 、 局 域 变量 等 ) 访问 内 存 值 的 操作 码 。 

为 了 深入 了 解 通过 CIL 的 成 员 实现 ， 表 18-5 根 据 功 能 的 相关 性 列 出 了 一 些 逻 辑 实现 中 常用 的 操作 码 。 


表 18-5 “一些 实现 相关 的 CIL 操 作 码 





操 作 码 作 用 
add、sub、mul、div 和 rem 用 于 加 减 乘除 两 个 数值 ( rem 返 回 除 法 操作 的 余数 ) 
and、or、not 和 xor 用 于 在 两 个 值 上 进行 二 进 制 操 作 
ceq、 cgt 和 clt 用 不 同 的 方法 比较 两 个 在 栈 上 的 值 。 例 如 : ceq 用 于 比较 是 否 相 等 ，cgt 用 于 比较 是 
否 大 于 ，clt 用 于 比较 是 否 小 于 
box 和 unbox 在 引用 类 型 和 值 类 型 之 间 转 换 
ret 退出 方法 和 返回 一 个 值 ( 如 果 需 要 ) 


beq、bgt 、ble、blt 和 switch 控制 方法 中 的 条 件 分 支 。 例 如 : beq 用 于 表示 如 果 相 等 就 中 止 到 代码 标签 ，bgt 用 于 
表示 如 果 大 于 就 中 止 到 代码 标签 , ble 用 于 表示 如 果 小 于 等 于 就 中 止 到 代码 标签 , blt 
用 于 表示 如 果 小 于 就 中 止 到 代码 标签 。 所 有 的 分 支 控制 操作 码 都 需要 你 给 出 一 个 
CIL 代 码 标签 作为 条 件 为 真 的 跳 转 目的 

call 调用 一 个 给 定 类 型 的 成 员 

newarr 和 newobj 在 内 存 中 创建 一 个 新 的 数组 或 者 新 的 对 象 类 型 
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下 一 个 CIL 操 作 码 ( 表 18-6 列 出 了 其 中 一 部 分 ) 的 类 别 用 于 加 载 ( 压 人 ) 参数 到 虚拟 执行 栈 中 。 
你 会 看 到 这 些 加 载 相关 的 操作 码 使 用 1d( 加 载 ) 的 前 级 。 


操 作 码 
ldarg ( 及 多 个 变化 形式 ) 


ldc ( 及 多 个 变化 形式 ) 
1dfld ( 及 多 个 变化 形式 ) 
ldloc ( 及 多 个 变化 形式 ) 
ldobj 

ldstr 


表 18-6 主要 的 ClL 栈 操作 码 
作 用 
加 载 方法 的 参数 到 栈 中 。 除 了 泛 型 1darg ( 需要 一 个 索引 作为 参数 )， 还 有 其 他 很 多 
的 变化 形式 。 例 如 ， 有 一 个 数字 后 缀 的 1darg 操 作 码 ( 如 ldarg_0 ) 来 指定 需要 加 载 
的 参数 。 同 时 ， 还 有 很 多 ldarg 的 变化 形式 允许 使 用 表 18-4 所 示 的 CIL 常 量 加 载 指定 
的 数据 类 型 ( ldarg_I4， 加 载 int32 ) 和 值 ( ldarg_I4_5 加 载 一 个 值 为 5 的 int32 ) 


加 载 一 个 常数 值 到 栈 中 

加 载 一 个 对 象 实例 的 成 员 到 栈 中 

加 载 一 个 本 地 变量 到 栈 中 

获得 一 个 堆 对 象 的 所 有 数据 ， 并 将 它们 放置 在 栈 中 
加 载 一 个 字符 串 数据 到 栈 中 


除了 上 面 这 些 加 载 相关 的 操作 码 ，CIL 还 提供 了 很 多 用 于 显 式 弹出 栈 顶 数据 的 操作 。 在 本 章 最 开 
始 的 例子 中 可 以 看 到 ,弹出 一 个 栈 中 的 值 一 般 需 要 存储 这 个 值 到 一 个 临时 的 本 地 存储 空间 中 以 便 接 下 
来 使 用 ( 比如 一 个 参数 被 方法 调用 )。 了解 了 这 一 点 ， 可 以 看 到 有 很 多 操作 符 使 用 st ( 存储 ) 前 级 用 
来 从 虚拟 执行 栈 中 弹出 当前 的 值 。 表 18-7 列 出 了 一 些 。 


操作 码 
pop 
starg 
stloc ( 及 多 个 变化 形式 ) 
stobj 
stsfld 


表 18-7 弹出 操作 码 
作 用 
删除 当前 栈 项 的 值 ， 但 是 并 不 影响 存储 值 
存储 栈 顶 的 值 到 给 出 方法 的 参数 ， 根 据 索 引 确 定 这 个 参数 
弹出 当前 栈 顶 的 值 并 且 存 储 在 一 个 本 地 变量 列表 中 ， 根 据 索引 确定 这 个 参数 
从 栈 中 复制 一 个 特定 的 类 型 到 指定 的 内 存 地 址 
用 从 栈 中 获得 的 值 蔡 换 静态 成 员 的 值 


要 注意 的 是 ， 这 些 CIL 操 作 码 将 不 显 式 地 弹出 栈 中 的 值 来 执行 当前 任务 。 例 如 ， 如 果 你 试图 使 用 
sub 操 作 码 对 两 个 数字 进行 减法 操作 ， 那 么 需要 清楚 的 是 sub 在 执行 操作 前 会 自动 弹出 两 个 有 效 的 值 。 
一 旦 运算 操作 完成 了 ,计算 的 结果 将 被 人 栈 。 


18.8.1 .maxstack 指 令 


当 编写 原始 CIL 代 码 时 ， 需 要 注意 一 个 特别 的 指令 .maxstack。 正 如 这 个 名 字 所 说 明 的 ，.maxstack 
确定 一 个 在 方法 执行 阶段 可 以 被 压 人 栈 中 的 最 大 变量 数目 。 好 在 .maxstack 的 默认 值 是 g， 对 于 绝 大 多 
数 方法 来 说 都 应 该 是 足够 了 。 不 过 ， 如 果 你 希望 明确 地 指出 ， 可 以 自行 计算 栈 中 的 局 域 变量 ， 并 显 式 


地 给 出 这 个 值 : 
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.method public hidebysig instance void 
Speak() cil managed 


// 在 这 个 方法 的 有 效 范围 内 ， 只 有 值 1 (字符 囊 字 面 量 ) 是 在 栈 中 
.maxstack 1 

ldstr "Hello there..." 

call void [mscorlib]System.Console: :WriteLine(string) 

ret 


} 


18.8.2 在 CIL 中 声明 本 地 变量 


先 看 一 下 如 何 声明 一 个 本 地 变量 。 假 设 你 想 构造 一 个 没有 参数 、 返 回 void 的 MyLocalvariables() 
方法 。 在 这 个 方法 中 ， 你 想 定义 3 个 本 地 变量 ， 数 据 类 型 分 别 是 System.String 、System.Int32 和 
System.0bject。 在 C# 中 ， 可 以 像 下 面 这 样 写 代码 (回忆 一 下 ， 本 地 变量 在 使 用 前 必须 要 初始 化 ): 


public static void MyLocalVariables() 


string myStr = "CIL code is fun!"; 
int myInt = 33; 
object my0bj = new object(); 


如 果 是 在 CIL 中 直接 定义 这 个 MyLocalvariables() ， 代 码 如 下 : 


.method public hidebysig static void 
MyLocalVariables() cil managed 


.maxstack 8 
// 定义 3 个 本 地 变量 
.locals init ([0] string myStr, [1] int32 myInt, [2] object my0bj) 
// 加 载 字 符 囊 到 虚拟 执行 栈 中 
ldstr "CIL code is fun!" 
// 弹出 当前 的 值 ， 并 存 入 本 地 变量 [0] 
stloc.0 


// 加 载 常量 到 类 型 这 (int32 的 简写 ) ， 设 置 值 为 33 
ldc.i4 33 

/弹出 当前 的 值 ， 并 存 入 本 地 变量 [1] 

stloc.1 


// 创建 一 个 新 对 象 并 放 在 栈 上 

newobj instance void [mscorlib]System.0bject::.ctor() 
/弹出 当前 的 值 ， 并 存 入 本 地 变量 [2] 

stloc.2 

ret 


} 

你 可 以 看 到 ， 在 原始 CIL 中 分 配 本 地 变量 ， 首 先是 使 用 .locals 指 令 和 init 特 性 。 在 对 应 的 作用 域 
内 ， 将 每 一 个 变量 同 给 出 的 索引 相互 关联 ( 例如 这 里 的 [0] 、[1] 和 [2] )。 可 见 ， 每 一 个 索引 都 由 数据 
类 型 和 可 选 的 变量 名 称 来 表示 。 一旦 一 个 本 地 变量 被 定义 后 ， 就 可 以 加 载 值 到 栈 中 (使 用 加 载 相关 的 
操作 码 ) 并 且 存 储 本 地 变量 中 的 值 ( 使 用 存储 相关 的 操作 码 )。 
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18.8.3 ”在 ClL 中 映射 参数 到 本 地 变量 


我 们 已 经 学 习 了 如 何 使 用 .local 初 始 指令 在 原始 CIL 中 声明 局 域 变量 ， 不 过 还 没有 看 到 如 何 映射 
传人 参数 到 局 部 方法 中 。 参 考 如 下 的 C# 葛 态 方 法 : 
public static int Add(int a, int b) 


return a+b; 


这 个 看 起 来 很 简单 的 函数 如 果 要 用 CIL 实 现 ， 还 是 有 很 多 讲究 的 。 首 先 ， 传 人 的 参数 a 和 b 必 须 使 
用 ldarg 压 入 虚拟 的 执行 栈 中 。 接 着 ， 使 用 add 操 作 码 从 栈 中 弹出 这 两 个 值 ， 然 后 计算 其 和 ， 并 将 计算 
出 来 的 结果 存 回 到 栈 中 。 最 后 , 这 个 和 被 弹出 栈 并 且 通 过 ret 操 作 码 返回 到 调用 者 。 如 果 使 用 ildasm.exe 
来 反 编 译 这 个 C# 函 数 ， 会 看 到 很 多 由 csc.exe 注 入 的 额外 标记 ， 不 过 最 关键 的 CIL 其 实 很 简单 ; 
.method public hidebysig static int32 Add(int32 a, 
int32 b) cil managed 


.maxstack 2 

ldarg.0 // 加 载 "a" 到 栈 中 
ldarg.1 // 加 载 "b" 到 栈 中 
add // 求 和 

ret 


18.8.4 this 隐 式 引 用 


注意 上 面 的 例子 中 , 考虑 到 虚拟 执行 栈 索 引 是 以 0 开始 的 ，CIL 代 码 使 用 传人 的 a 和 b 的 索引 0 和 1 来 
引用 。 

需要 始终 记 住 的 是 ， 在 使 用 原始 CIL 代 码 时 ， 任 何 非 静态 函数 在 接收 传人 参数 的 时 候 都 自动 隐 式 
地 接收 了 一 个 附加 参数 。 这 个 参数 就 是 当前 对 象 的 引用 ( 联想 C# 的 this 关 键 字 )。 考 虑 到 这 点 ， 如 果 
Add() 方 法 是 非 静 态 的 : 

// 非 静 态 

人 int Add(int a, int b) 


return a + bj; 


那么 传人 的 a 和 b 就 要 使 用 1darg.1 和 1darg.2 而 不 是 前 面 的 ldarg.0 和 1darg.1。 原 因 就 是 0 已 经 被 
this 引 用 占用 了 。 参 考 下 面 的 伪 代 码 : 


// 这 个 仅仅 是 伪 代 码 
.method public hidebysig static int32 AddTwoIntParams( 
MyClass_HiddenThisPointer this, int32 a, int32 b) cil managed 


ldarg.0  // 加 载 MyClass_HiddenThisPointer 到 栈 上 
ldarg.1 // 加 载 "a" 到 栈 上 
ldarg.2 // 加 载 "b" 到 栈 上 


} 
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18.8.5 在 CIL 中 使 用 循环 结构 


在 C# 中 ， 循 环 结构 是 使 用 for 、foreach 、while 和 do 这 些 关键 字 来 实现 的 。 每 一 个 在 CIL 中 都 有 对 
应 的 表示 。 例 如 下 面 的 for 循 环 : 

public static void CountToTen() 

for(int i = 0; i «< 10; i++) 

) ; 

现在 ,你 也 许 会 回想 起 前 面 提 到 过 的 br 操作 码 (br、blt 等 ) 可 以 根据 条 件 控 制 流程 。 在 这 里 ， 可 
以 为 for 循 环 设置 一 个 条 件 ， 当 本 地 变量 i 等 于 或 大 于 10 的 时 候 就 跳出 循环 。 每 产生 一 次 迭代 ，i 的 值 
都 要 增加 1， 并 且 重 新 检查 设置 的 条 件 是 否 满足 。 

前 面 提 到 过 ， 当 使 用 CIL 分 支 操 作 码 时 ， 需 要 定义 一 个 〈 或 两 个 ) 具体 的 代码 标签 作为 条 件 为 真 
时 的 跳出 位 置 。 参 考 一 下 如 下 通过 ildasm.exe 生 成 的 CIL 代 码 ( 包含 自动 生成 的 代码 标签 ): 


.method public hidebysig static void CountToTen() cil managed 


.maxstack 2 

.locals init ([0] int32 i) // 初始 化 本 地 变量 "让 
IL 0000: ldc.i4.0 // 加 载 这 个 值 到 栈 中 

IL 0001: stloc.0 // 存储 这 个 值 到 索引 '0' 
IL 0002: br.s IL 0008 // 跳 到 IL_0008 

IL 0004: 1dloc.0 // 加 载 索 引 0 的 值 

IL 0005: ldc.i4.1 // 加 载 值 '1' 

IL 0006: add // 增加 当前 在 索引 0 的 值 
IL_0007: stloc.0 


IL 0008: ldloc.0 // 加 载 在 索引 0 的 值 
IL_0009: ldc.i4.s 10 // 加 载 '10' 到 栈 上 
IL_000b: blt.s IL 0004 // 小 于 ?如 果 是 ， 跳 到 IL_0004 
IL_000d: ret 

} 


简单 地 说 ,这 段 CIL 代 码 开始 先 定 义 了 本 地 的 int32 ,加载 到 栈 上 ,之 后 ,就 在 代码 IL_0008 到 IL_ 0004 
之 间 循 环 。 每 次 都 弹出 i 的 值 ( 以 1 递增 ) 并 且 查 看 i 是 否 比 10 小 。 如 果 是 ， 则 退出 代码 。 


源 代 码 ”CilTypes 示 例 的 源 代 码 位 于 Chapter 18 子 目录 下 。 


18.9 使 用 CIL 构建 .NET 程序 集 


现在 你 已 经 大 概 了 解 了 原始 CIL 的 语法 和 语义 ， 那 么 该 使 用 ilasm.exe 和 任 一 文本 编辑 器 构建 一 
个 .NET 应 用 程序 ,来 复习 和 巩固 学 习 成 果 了 。 这 个 应 用 程序 有 一 个 私有 部 署 的 单 文件 *.dll， 它 包含 两 
个 类 类 型 定义 和 一 个 与 这 些 类 型 进行 交互 的 、 基 于 控制 台 的 *.exe。 


18.9.1 构建 CILCars.dl 
首先 需要 构建 一 个 *.dl 来 供 我 们 的 程序 使 用 。 使 用 一 个 文本 编辑 器 来 创建 一 个 新 的 *.il 文 件 ,命名 
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为 CILCars.il。 这 个 单 文件 程序 集 需 要 使 用 两 个 外 部 的 .NET 二 进 制 文件 。 下 面 是 这 段 CIL 的 代码 ; 


// 引用 mscorlib.d11 和 System.WNindows.Forms .dl1 
.assembly extern mscorlib 


-publickeytoken = (B7 7A 5C 56 19 34 E0 89 ) 
.Ver 4:0:0:0 


.assembly extern System.Windows.Forms 


.publickeytoken = (B7 7A 5C 56 19 34 EO 89 ) 
.Ver 4:0:0:0 


} 


// 定义 这 个 单 文件 程序 集 
.assembly CILCars 


.hash algorithm Ox00008004 
.Ver 1:0:0:0 


和 CILCars.dll 

这 个 程序 集 将 包含 两 个 类 类 型 。 第 一 个 类 型 是 CILCar ， 定 义 两 个 字段 数据 ( 简便 起 见 本 例 使 用 了 
public 字 段 ) 和 一 个 自 定义 构造 函数 。 第 二 个 类 型 是 carInfoHelper ， 定 义 一 个 静态 方法 Display- 
CarInfo()， 它 以 CILCar 作 为 参数 并 且 返 回 void。 两 个 类 型 都 在 CILCars 这 个 命名 空间 中 。CILCar 的 CIL 
实现 如 下 : 


// 实现 CILCars.CILCar 类 
.namespace CILCars 


.Class public auto ansi beforefieldinit CILCar 
extends [mscorlib]System.Object 


// CILCar 的 数据 字段 
.field public string petName 
.field public int32 currSpeed 


// 自 定义 构造 函数 允许 调用 者 给 数据 字段 赋值 

.method public hidebysig specialname rtspecialname 
instance void .ctor(int32 ¢, string p) cil managed 

{ 


.maxstack 8 


// 加 载 第 一 个 参数 到 栈 上 并 调用 基 类 的 构造 函数 
ldarg.0 // "this" 对 象 ， 不 是 int321 
call instance void [mscorlib]System.Object::.ctor() 


// 加 载 第 一 个 和 第 二 个 参数 到 栈 上 
ldarg.0 // "this” 对象 
ldarg.1 // int32 参 数 


// 存储 栈 顶 的 成 员 (int32) 到 currSpeed 字 段 
stfld int32 CILCars.CILCar::currSpeed 


// 加 载 字 符 囊 参数 并 且 符 储 到 petName 字 段 
ldarg.0 // "this” 对 象 

ldarg.2 // string 参数 

stfld string CILCars.CILCar::petName 
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ret 


需要 始终 记得 的 是 ， 非 静态 成 员 的 第 一 个 参数 是 当前 的 对 象 引 用 ，CIL 的 第 一 段 代码 就 是 加 载 这 
个 对 象 引 用 并 且 调 用 基 类 的 构造 函数 。 接 下 来 ,将 传人 的 构造 函数 参数 人 栈 并 且 使 用 stfld 操 作 码 ( store 
in field ) 存储 到 类 型 的 字段 数据 中 。 

接 下 来 ， 需 要 在 这 个 命名 空间 中 实现 第 二 个 类 型 : cILCarInfo。 它 的 主要 作用 可 以 在 静态 的 
Display() 方 法 中 看 到 。 简 单 地 说 ， 这 个 方法 的 作用 就 是 接收 传人 的 CILCar 参 数 ， 提 取 其 字段 数据 的 值 
并 在 Windows 窗 体 消息 框 上 显示 它 。 下 面 是 CILCarInfo ( 它 定义 在 CILCars 命 名 空间 中 ) 的 完整 实现 : 


.Class public auto ansi beforefieldinit CILCarInfo 
extends [mscorlib]System.Object 


.method public hidebysig static void 
Display(class CILCars.CILCar c) cil managed 


.maxstack 8 


// 需要 一 个 局 部 的 字符 事变 量 
.locals init ([0] string caption) 


// 加 载 字 符 事 和 传 入 的 CILCar 到 栈 上 
ldstr "{0}'s speed is:" 
ldarg.0 


// 将 CILCar 的 petName 放 到 栈 上 ， 然 后 调用 静态 的 String.Format() 方 法 
ldfld string CILCars.CILCar::petName 

call string [mscorlib]System.String::Format(string, object) 
stloc.0 


// 现在 加 载 cuUrrSpeed 字 段 的 值 ， 取 得 它 的 字符 囊 表 示 (调用 ToString()) 
ldarg.0 

ldflda int32 CILCars.CILCar::currSpeed 

call instance string [mscorlib]System.Int32::ToString() 

ldloc.0 


// 现在 调用 MessageBox.Show() 方 法 并 传 入 加 载 的 值 

call valuetype [System.Windows.Forms] 
System.Windows.Forms.DialogResult 
[System.Windows .Forms] 
System.Windows.Forms.MessageBox: :Show(string, string) 


pop 
ret 
} 
} 
尽管 上 面 的 CIL 代 码 比 看 到 的 CILCar 的 实现 要 多 些 ， 不 过 逻辑 上 比较 简单 。 首 先 ， 由 于 是 定义 
一 个 静态 方法 ， 不 需要 关心 隐 式 的 对 象 引用 ( 因此 ，1ldarg.0 操 作 码 实际 上 加 载 的 是 传人 的 CILCar 
参数 )。 
最 开始 是 加 载 一 个 字符 串 ("{0}’s speed is" ) 到 栈 上 ， 接 着 的 是 CILCar 参 数 。 一 旦 这 两 个 值 安 
排 妥 当 ， 加 载 petName 字 段 的 值 ， 并 调用 静态 的 System.String.Format() 方 法 来 用 CILCar 里 的 昵称 代替 
花 括 号 占 位 符 。 
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当 处 理 currspeed 字 段 时 ,采用 类 似 的 过 程 , 不 过 这 次 使 用 1df1da 操 作 码 来 加 载 这 个 参数 地 址 到 栈 
上 。 然 后 调用 System.Int32.ToString() 来 将 该 地 址 的 值 转换 为 字符 串 类 型 。 最 后 ， 一 旦 两 个 字符 串 都 
已 经 格式 化 好 了 ， 就 调用 MessageBox.Show() 方 法 。 

现在 ， 就 可 以 使 用 ilasm.exe 和 如 下 命令 来 编译 新 的 *.dll: 

ilasm /dl11 CILCars .il 

并 使 用 peverify.exe 来 验证 CIL: 

peverify CILCars.d]1 


18.9.2 ”构建 CILCarClient.exe 


现在 可 以 使 用 Main() 方 法 构建 一 个 简单 的 *.exe 程 序 集 。 

口 构建 一 个 CILCar 对 象 。 

口 把 这 个 对 象 作 为 参数 传送 给 静态 方法 CILCarInfo.Display()。 

创建 一 个 新 的 *.il 文 件 CarClient.il, 并 定义 外 部 引用 mscorlib.dll 和 CILCars.dll( 不 要 忘记 把 这 个 .NET 
程序 集 复制 一 份 到 客户 端的 程序 目录 中 )。 然 后 定义 一 个 操作 CILCars.dll 程 序 集 的 类 型 program。 下 面 
是 完整 的 代码 : 

// 外 部 程序 集 引 用 


.assembly extern mscorlib 


.publickeytoken = (B7 7A 5C 56 19 34 EO 89) 
.Ver 4:0:0:0 


.assembly extern CILCars 
.Ver 1:0:0:0 

// 我 们 的 执行 程序 集 

.assembly CarClient 


.hash algorithm Ox00008004 
.Ver 1:0:0:0 


.module CarClient.exe 


// Program 类 型 的 实现 
.Namespace CarClient 


.Class private auto ansi beforefieldinit Program 
extends [mscorlib]System.0bject 
{ 


.method private hidebysig static void 
Main(string[] args) cil managed 
{ 


// 为 *.exe 的 入 口 点 做 标记 
.entrypoint 
.maxstack 8 


// 声明 局 部 CILCar 变 量 并 为 栈 上 的 ctor 请 求 输入 值 
.locals init ([0] class 
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[CILCars]CILCars.CILCar myCilCar) 
ldc.i4 55 
ldstr "Junior" 


// 构建 新 的 CilCar; 存储 并 加 载 引 用 

newobj instance void 
[CILCars]CILCars.CILCar::.ctor(int32，string) 

stloc.0 

ldloc.0 


// 调用 Display() 并 传 入 栈 顶 值 
call void [CILCars] 
CILCars.CILCarInfo: :Display( 
class [CILCars]CILCars.CILCar) 
ret 
} 
} 
? 


需要 强调 的 一 个 操作 码 是 .entrypoint。 回 忆 一 下 我 们 前 面 的 讨论 ， 这 个 操作 码 是 用 做 标识 *.exe 
函数 的 一 个 方法 作为 模块 的 人口 。 实 际 上 , 由 于 .entrypoint 就 是 CLR 用 来 标识 初始 执行 方法 的 ， 所 以 
该 方法 也 可 以 是 Main() 之 外 的 其 他 任何 方法 。 其 余 的 在 Main() 方 法 中 的 CIL 代 码 主要 执行 一 些 和 人 栈 和 出 
栈 操作 。 

但 是 一 定 要 记 住 ，CILCar 的 创建 涉及 .newobj 操 作 码 的 使 用 。 另 外 ， 回 想 一 下 ， 要 使 用 原始 CIL 调 
用 类 型 成 员 时 , 需要 利用 双 冒 号 语法 , 还 一 定 要 使 用 类 型 的 完全 限定 名 。 接 下 来 就 可 以 使 用 ilasm.exe 
来 编译 新 文件 ， 使 用 peverify.exe 来 验证 程序 集 ， 最 后 执行 程序 。 在 命令 提示 符 中 输入 以 下 命令 : 


ilasm CarClient.il 
peverify CarClient .exe 
CarClient .exe 


源 代码 ”CilCars 示 例 的 源 代码 位 于 Chapter 18 子 目录 下 。 


18.10 ”动态 程序 集 


也 许 你 已 经 注意 到 了 ， 使 用 CIL 代 码 来 开发 一 个 复杂 的 .NET 应 用 程序 将 会 是 一 个 非常 繁重 的 体力 
劳动 。 一 方面 ，CIL 是 一 种 极端 自我 表达 的 开发 语言 ， 能 够 允许 你 和 任何 一 种 被 CTS 支 持 的 语言 交互 。 
另外 一 方面 ， 开 发 原始 CIL 代 码 也 是 乏味 的 ， 容 易 出 错 ， 令 人 痛 否 。 当 然 ， 这 个 知识 本 身 还 是 重要 的 ， 
你 也 许 会 想 知道 牢记 CIL 的 语法 规则 究竟 有 多 重要 。 答 案 是 ， 具 体 情 况 具 体 分 析 。 当 然 ， 大 多 数 .NET 
编程 不 需要 查看 、 编 辑 或 者 编写 原始 CIL 代 码 。 不 过 ,有 了 CIL 的 基本 知识 ,现在 就 可 以 研究 和 探索 动 
态 程序 集 ( 同 静 态 程序 集 相 对 应 ) 以 及 System.Reflection.Emit 命 名 空间 的 作用 。 

读者 的 第 一 个 问题 也 许 是 :“ 动 态 和 静态 程序 集 到 底 有 什么 区 别 ? “根据 定义 ,静态 程序 集 是 .NET 
直接 从 磁盘 存储 器 加 载 的 .NET 二 进 制 文件 , 也 就 是 说 在 CLR 请 求 加 载 它们 的 时 候 , 它们 是 在 硬盘 上 的 
一 些 物理 文件 (也 可 能 是 多 文件 程序 集中 的 一 组 文件 )。 正 如 读者 所 料 ， 每 次 编译 C# 源 代码 ， 都 会 生 
成 一 个 静态 程序 集 。 

动态 程序 集 在 运行 中 通过 使 用 System.Reflection.Emit 命 名 空间 提供 的 类 型 在 内 存 中 创建 。 
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System.Reflection.Emit 命 名 空间 使 得 在 运行 时 创建 程序 集 及 其 模块 、 类 型 定义 以 及 CIL 实 现 逻 辑 成 为 
可 能 。 一 旦 完成 了 这 些 , 就 可 以 将 内 存 中 的 二 进 制程 序 保存 到 磁盘 上 生成 一 个 新 的 静态 程序 集 。 当 然 ， 
使 用 System.Reflection.Emit 构 造 动态 程序 集 需 要 对 CIL 操 作 码 有 一 定 程度 的 理解 。 

尽管 创建 动态 程序 集 是 一 种 相当 高 级 的 编程 技术 ， 也 不 是 很 常见 ， 不 过 在 一 些 情况 下 ， 这 个 技术 
非常 有 用 。 

口 构建 需要 根据 用 户 输入 来 生成 程序 集 文件 的 .NET 开 发 工具 。 

口 构建 需要 在 运行 时 通过 元 数据 来 生成 远程 类 型 的 代理 的 程序 。 

口 希望 加 载 静 态 程序 集 并 能 够 动态 插入 新 的 类 型 到 二 进 制 图 像 中 。 

那么 ， 现 在 来 看 看 System.Reflection.Emit 这 个 命名 空间 中 的 类 型 。 

.NET 运 行 时 引擎 的 几 个 方面 包括 在 后 台 动 态 生成 程序 集 。 例 如 ,ASPNET 使 用 这 个 技术 来 把 标记 
和 服务 器 端 脚 本 映射 到 运行 时 对 象 模型 。LINQ 也 根据 各 种 查询 表达 式 来 生成 代码 。 现 在 来 看 一 下 
System.Reflection.Emit 中 的 一 些 类 型 。 


18.10.1 System.Reflection.Emit 命 名 空间 


创建 动态 程序 集 需 要 对 CIL 操 作 人 码 有 一 定 程度 的 了 解 ， 不 过 System.Reflection.Emit 命 名 空间 提 
供 的 类 型 则 尽 可 能 地 隐藏 了 CIL 的 复杂 度 。 例如， 可 以 使 用 TypeBuilder 类 而 不 是 直接 使 用 CIL 指 令 和 
特性 来 定义 一 个 类 。 如 果 和 希望 定义 一 个 实例 级 的 构造 函数 ， 不 需要 使 用 specialname、rtspecialname 
或 者 .ctor 标 记 ， 而 是 使 用 ConstructorBuilder。 表 18-8 记 录 了 System.Reflection.Emit 命 名 空间 的 一 
些 重要 成 员 。 


表 18-8 System.Reflection.Emit 命 名 空间 的 一 些 成 员 





成 员 作 用 

AssemblyBuilder 运行 时 创建 程序 集 文件 ( *.dll 或 者 *.exe ) 。*.exe 必 须 调用 Mode 
SetEntryPoint() 来 设置 模块 的 入 口 函 数 。 如 果 没 有 指定 入口 函数 ， 那 么 就 会 生成 
*.dll 文 件 

ModuleBuilder 定义 当前 程序 集中 的 模块 集 

* EnumBuilder 创建 .NET 枚 举 类 型 

TypeBuilder 运行 时 创建 模块 中 的 类 、 接 加 、 结 构 、 委 托 

MethodBuilder 运行 时 创建 类 型 成 员 ( 比如 方法 、 本 地 变量 、 属 性 、 构 造 函 数 以 及 特性 ) 

LocalBuilder 

PropertyBuilder 

FieldBuilder 

ConstructorBuilder 

CustomAttributeBuilder 

ParameterBuilder 

EventBuilder 

ILGenerator 产生 CIL 操 作 码 到 给 定 的 类 型 成 员 

OpCodes 提供 了 很 多 可 以 映射 到 CIL 操 作 码 上 的 成 员 。 这 个 类 型 需要 同 System.Reflection. 


Emit.ILGenerator 提 供 的 成 员 结 合 使 用 
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总 而 言 之 ，System.Reflection.Emit 命 名 空间 提供 的 类 型 允许 你 在 构建 动态 程序 集 时 用 编程 方式 表 
示 原 始 的 CIL 标 记 。 你 会 看 到 下 面 的 代码 中 用 到 了 很 多 这 些 成 员 。 不 过 ILGenerator 值 得 我 们 先 来 看 看 。 


18.10.2 System.Reflection.Emit.ILGenerator 的 作用 


顾名思义 ，ILGenerator 类 型 用 来 注入 CIL 操 作 码 到 一 个 给 定 的 类 型 成 员 。 因 为 这 个 类 型 没有 公共 
构造 函数 ， 所 以 一 般 而 言 ， 不 需要 直接 创建 TILGenerator 对 象 ， 而 是 通过 调用 一 些 围 绕 构造 的 类 型 ( 例 
如 MethodBuilder 和 ConstructorBuilder ) 的 指定 方法 来 获得 对 ILGenerator 类 型 的 有 效 引 用 。 例 如 : 


// 从 ConstructorBuilder 对 象 'myCtorBuilder' 获 得 引用 
ConstructorBuilder myCtorBuilder = 
new ConstructorBuilder(/* ...various args... */); 


ILGenerator myCILGen = myCtorBuilder.GetILGenerator(); 
一 旦 得 到 了 ILGenerator 的 引用 ， 就 可 以 使 用 它 提供 的 各 种 方法 生成 原始 CIL 操 作 码 。 表 18-9 列 出 
了 ILGenerator 的 部 分 ( 但 不 是 全 部 ) 方法 。 


表 18-9 ”ILGenerator 的 部 分 方法 


方 法 作 用 
BeginCatchBlock() 开始 一 个 catch 程 序 块 
BeginExceptionBlock() 开始 一 个 没有 过 滤 的 异常 捕获 块 
BeginFinallyBlock() 开始 一 个 finally 块 
BeginScope() 开始 一 个 词汇 范围 
DeclareLocal() 定义 一 个 本 地 变量 
DefineLabel() 定义 一 个 新 标签 
Emit() 被 重 载 多 次 以 生成 CIL 操 作 码 
EmitCall() 压 人 一 个 call 或 者 callvirt 操 作 码 到 CIL 流 
EmitWriteLine() 根据 不 同类 型 的 值 ， 产 生 一 个 对 Console.WriteLine() 的 调用 
EndExceptionBlock() 结束 一 个 异常 程序 块 
EndScope() 结束 一 个 词汇 范围 
ThrowException() 产生 抛 出 异常 的 指令 
UsingNamespace() 指定 用 来 对 本 地 变量 求 值 的 命名 空间 ， 并 监控 当前 活动 的 程序 块 


ILGenerator 的 关键 方法 是 同 System.Reflection.Emit.0pCodes 类 类 型 联合 使 用 的 Emit()。 正如 前 面 
提 到 的 ，System.Reflection.Emit.0pCodes 公 开 了 很 多 只 读 的 、 映 射 到 原始 CIL 操 作 码 的 字段 。 可 以 从 
在 线 帮助 查看 相关 的 例子 程序 ， 或 者 查看 完整 的 成 员 定义 。 


18.10.3 产生 动态 的 程序 集 


让 我 们 通过 创建 一 个 叫做 MyAssembly.dll 的 单 文件 动态 程序 集 来 说 明 如 何在 运行 时 动态 创建 .NET 
程序 集 。 这 个 模块 包含 一 个 名 为 HelloWor1d 的 类 。HelloWorld 类 支持 一 个 默认 的 构造 哺 数 和 一 个 用 来 
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给 string 类 型 的 私有 成 员 变 量 ( theMessage ) 赋值 的 自 定义 构造 函数 。 此 外 ，HelloWor1d 还 支持 一 个 公 
共 的 实例 方法 SayHello() ， 这 个 方法 可 以 输出 一 个 欢迎 信息 到 标准 IO 流 中 ; HelloWworld 还 支持 一 个 实 
例 方法 GetMsg()， 可 以 返回 内 部 的 私有 字符 串 。 实 际 上 ， 是 通过 编程 生成 如 下 的 类 类 型 ; 

// 这 个 类 将 被 System.Reflection.Emit 在 运行 时 创建 
全 class HelloWorld 


private string theMessage; 
Helloworld() {} 
HelloWorld(string s) {theMessage = s;} 


public string GetMsg() {return theMessage;} 
public void SayHello() 


System.Console.WritelLine("Hello from the HelloWorld class!"); 


} 

假设 你 已 经 创建 了 一 个 叫做 DynamicAsmBuilder 的 新 Visual Studio 控 制 台 应 用 项 目 。 引 入 
System.Reflection 、System.Reflection.Emit 和 System.Threading 命 名 空间 ， 一 个 静态 方法 
CreateMyAsm()。 这 个 方法 负责 : 

口 定义 动态 程序 集 的 特征 ( 名 字 、 版 本 等 ); 

口 实现 HelloClass 类 型 ; 

口 保存 内 存 中 的 程序 集 到 一 个 物理 文件 。 

CreateMyAsm() 方 法 只 有 一 个 System.AppDomain 类 型 的 参数 ， 通 过 它 可 以 访问 当前 应 用 程序 域 的 
AssemblyBuilder 类 型 ( 参考 第 16 章 关于 .NET 应 用 程序 域 的 讨论 ),。 下 面 是 完整 的 代码 ,随后 进行 分 析 : 


// 调用 者 传 入 一 个 AppDomain 类 型 
public static void CreateMyAsm(AppDomain curAppDomain) 


// 建立 通用 的 程序 集 特征 

AssemblyName assemblyName = new AssemblyName(); 
assemblyName.Name = "MyAssembly"; 
assemblyName.Version = new Version("1.0.0.0"); 


// 在 当前 AppDomain (应 用 程序 域 ) 中 创建 一 个 新 的 程序 集 
AssemblyBuilder assembly = 
curAppDomain. Def ine dynanichssenbly(assemblyNanes 
AssemblyBuilderAccess.Save); 


// 鉴于 我 们 构造 的 是 一 个 单 文件 程序 集 ， 模 块 的 名 字 就 是 程序 集 的 名 字 
ModuleBuilder module = 
assembly.DefineDynamicModule("MyAssembly", "MyAssembly.d11"); 


// 定义 一 个 公共 类 "HelloWorld" 
TypeBuilder helloWorldClass = module.DefineType("MyAssembly.HelloWorld", 
TypeAttributes.Public); 


// 定义 一 个 私有 字符 囊 成 员 变 量 "theMessage" 

FieldBuilder msgField = 
helloWorldClass.DefineField("theMessage", Type.GetType("System.String"), 
FieldAttributes.Private); 


// 创建 自 定义 的 构造 函数 
Type[] constructorArgs = new Type[1]; 
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constructorArgs[0] = typeof(string); 

ConstructorBuilder constructor = 
helloWorldClass.DefineConstructor(MethodAttributes.Public, 
CallingConventions.Standard, 
constructorArgs); 

ILGenerator constructorIL = constructor.GetIlLGenerator(); 

constructorIL .Emit(OpCodes.Ldarg 0); 

Type objectClass = typeof(object); 

ConstructorInfo superConstructor = 
objectClass.GetConstructor(new Type[0]); 

constructorIL .Emit(OpCodes.Call, superConstructor); 

constructorIl .Emit(OpCodes.Ldarg_0); 

constructorIL .Emit(OpCodes.Ldarg 1); 

constructorIL .Emit(OpCodes.Stfld, msgField); 

constructorIL .Emit(OpCodes.Ret); 


// 创建 默认 构造 函数 

hellowor1ldClass.DefineDefaultConstructor(MethodAttributes.Public); 

// 创建 GetMsg() 方 法 

MethodBuilder getMsgMethod = 
helloWorldClass.DefineMethod("GetMsg", MethodAttributes.Public, 
typeof(string), null); 

ILGenerator methodIL = getMsgMethod.GetILGenerator(); 

methodIL .Emit(OpCodes.Ldarg 0); 

methodIL .Emit(OpCodes.Ldfld, msgField); 

methodIL .Emit(OpCodes.Ret); 


// 创建 SayHel1o 方 法 

MethodBuilder sayHiMethod = 
helloWorldClass.DefineMethod("SayHello", 
MethodAttributes.Public, null, null); 

methodIL = sayHiMethod.GetILGenerator(); 

methodIL.EmitwriteLine("Hello from the HelloWorld class!"); 

methodIL .Emit(OpCodes.Ret); 


// 创建 类 HelloWorld (Baking 是 创建 一 个 类 型 的 正式 术语 ) 
helloWorldClass.CreateType(); 


// 将 这 个 程序 全 保存 到 文件 (可 选 ) 
assembly.Save("MyAssembly.d11"); 


18.10.4 产生 程序 集 和 模块 集 


上 面 的 方法 先 使 用 AssemblyName 和 Version 类 型 ( 在 System.Reflection 命 名 空间 里 定义 ) 构造 了 一 
个 程序 集 的 最 小 特性 集合 。 接 下 来 ， 可 以 通过 实例 级 的 AppDomain.DefineDynamicAssembly() 方 法 获得 
AssemblyBuilder 类 型 ( 回想 一 下 ， 调 用 方法 将 一 个 AppDomain 引 用 传人 CreateMyAsm ( ) 方法 中 ): 


// 定义 一 般 程序 集 特性 ， 并 获得 对 AssemblyBuilder 的 访问 
public static void CreateMyAsm(AppDomain curAppDomain) 


{ 
AssemblyName assemblyName = new AssemblyName(); 
assemblyName.Name = "MyAssembly"; 
assemblyName.Version = new Version("1.0.0.0"); 


// 使 用 当前 的 AppDomain 创 建 一 个 新 的 程序 集 
AssemblyBuilder assembly = 
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curAppDomain.DefineDynamicAssembly(assemblyName, 
AssemblyBuilderAccess.Save); 


可 见 ， 当 调用 AppDomain.DefineDynamicAssembly() 时 ， 必 须 指定 要 定义 的 程序 集 的 访问 模式 ， 这 
些 访 问 模式 中 最 常用 的 值 列 在 了 表 18-10 中 。 
表 18-10 ”常用 的 AssemblyBuilderAccess 枚 举 值 





值 作 用 
ReflectionOnly 表示 一 个 动态 程序 集 只 能 够 通过 反射 访问 
Run 表示 一 个 动态 程序 集 可 以 在 内 存 执行 ， 但 是 不 能 够 保存 到 硬盘 
RunAndSave 表示 一 个 动态 程序 集 可 以 在 内 存 中 执行 也 可 以 保存 到 硬盘 上 
Save 表示 一 个 动态 程序 集 可 以 保存 到 硬盘 但 是 不 可 以 在 内 存 中 执行 


下 一 个 任务 就 是 为 这 个 新 的 程序 集 定义 模块 集 。 考 虑 到 这 个 程序 集 只 有 一 个 文件 ， 只 需要 定义 一 
个 模块 即 可 。 如 果 使 用 DefineDynamicModule() 方 法 构造 多 文件 程序 集 ， 还 要 通过 可 选 的 第 二 个 参数 来 
表示 要 操作 的 模块 的 名 称 ( 如 myMod.dotnetmodule )。 当 创建 单 文件 程序 集 时 ,模块 的 名 字 和 程序 集 的 
名 字 相 同 。 在 任何 情况 下 ， 只 要 DefineDynamicModule() 方 法 返回 ， 就 可 以 得 到 一 个 ModuleBuilder 类 型 
的 引用 。 

// 单 文件 程序 集 


ModuleBuilder module = 
assembly.DefineDynamicModule("MyAssembly", "MyAssembly.d11"); 


18.10.5 ”ModuleBuilder 类 型 的 作用 


ModuleBuilder 是 开发 动态 程序 集 的 关键 类 型 。 正如 读者 所 期 望 的 , ModuleBuilder 支 持 一 系列 成 员 
方法 ， 可 用 来 定义 模块 包含 的 各 种 类 型 ( 类 、 接 口 和 结构 等 ) 和 概 入 资源 (字符 串 表 、 图 像 等 )。 表 
18-11 介 绍 了 部 分 用 作 创 建 的 方法 。( 这 些 方 法 会 返回 需要 构造 的 相关 类 型 。) 


表 18-11 ModuleBuilder 类 型 的 部 分 成 员 





方 法 作 用 
DefineEnum() 产生 .NET 枚 举 类 型 定义 
DefineResource() 产生 存储 在 这 个 模块 中 的 托管 的 胖 入 资源 
DefineType() 构造 一 个 TypeBuilder， 可 以 用 来 定义 值 类 型 、 接 口 和 类 类 型 ( 包括 委托 ) 


ModuleBuilder 类 的 关键 成 员 就 是 DefineType()。 除 了 通过 简单 字符 串 指定 类 型 名 称 ， 还 可 以 使 用 
System.Reflection.TypeAttributes 枚 举 来 进一步 描述 类 型 的 格式 。 表 18-12 列 出 了 TypeAttributes 枚 举 
的 部 分 ( 但 不 是 全 部 ) 关键 成 员 。 


表 18-12 TypeAttributes 枚 举 的 部 分 成 员 
成 作 “用 
Abstract 类 型 是 抽象 的 


Class 类 型 是 类 


0 
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( 续 ) 
成 员 作 用 

Interface 类 型 是 接口 

NestedAssembly 具有 程序 集 访 问 级 别 的 从 套 类 ， 只 能 被 所 在 的 程序 集 方 法 访问 

NestedFamAndAssem 具有 程序 集 访问 级 别 和 成 员 访问 级 别 的 嵌 套 类 , 因此 只 能 够 被 属于 成 员 和 程序 集 交 
集 的 方法 访问 

NestedFamily 具有 成 员 访 问 级 别 的 能 套 类 ， 只 能 够 被 本 类 型 及 子 类 型 的 方法 访问 

NestedFamORAssem 具有 程序 集 访 问 级 别 和 成 员 访问 级 别 的 嵌 套 类 , 能 够 被 属于 成 员 和 程序 集 并 集 的 方 
法 访问 

Nestedprivate 私有 访问 级 别 的 嵌 套 类 

Nestedpublic 公有 访问 级 别 的 嵌 套 类 

NotPublic 非 公有 的 类 

public 公有 的 类 

Sealed 具体 的 不 可 扩展 的 类 

Serializable 可 以 序列 化 的 类 





18.10.6 产生 HelloClass 类 型 和 字符 串 成 员 变 量 


现在 已 经 了 解 了 ModuleBuilder.CreateType() 方 法 的 作用 ， 下 面 看 一 下 如 何 使 用 它 来 产生 公共 的 
HelloClass 类 类 型 和 私有 的 字符 串 变量 : 


// 定义 一 个 公共 类 MyAssembly.HelloWorld 
TypeBuilder helloWorldClass = module.DefineType("MyAssembly.HelloWorld", 
TypeAttributes.Public); 


// 定义 私有 字符 串 成 员 变 量 theMessage 
FieldBuilder msgField = 
helloWorldClass .DefineField("theMessage", 
typeof(string), 
FieldAttributes.Private); 


注意 TypeBuilder.DefineField() 方 法 如 何 提 供 到 FieldBuilder 类 型 的 访问 。TypeBuilder 类 也 提供 
了 到 其 他 构造 类 型 的 访问 方法 。 例 如 ，pDefineConstructor() 返 回 一 个 ConstructorBuilder ， 
DefineProperty() 返 回 一 个 PropertyBuilder， 诸 如 此 类 。 


18.10.7 产生 构造 函数 


前 面 提 到 过 ,TypeBuilder.DefineConstructor() 方 法 可 以 用 来 为 当前 类 型 定义 构造 函数 。 不 过 ， 当 
需要 实现 HelloClass 的 构造 函数 时 , 还 需要 注入 原始 CIL 代 码 到 构造 函数 内 来 接收 传人 的 参数 并 赋值 到 
内 部 的 私有 字符 串 。 要 获得 ILGenerator 类 型 ， 需 要 调用 引用 的 “builder” 类 型 ( 本 例 中 是 
ConstructorBuilder 类 型 ) 的 GetILGenerator() 方 法 。 

ILGenerator 类 的 Emit() 方 法 是 负责 把 CIL 放 入 成 员 实 现 的 实体 。Emit() 自 身 频繁 使 用 0pcodes 类 类 
型 ， 这 个 类 使 用 只 读 字段 公开 CIL 的 操作 码 集 。 例 如 ，0pCodes.Ret 表 示 一 个 方法 调用 的 返回 ; 
0pCodes.Stfld 给 成 员 变 量 赋值 ，0pCodes .Call 可 以 调用 一 个 指定 的 方法 (在 本 例 中 是 基 类 构造 函数 )。 
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参考 下 面 构造 函数 的 逻辑 : 


// 创建 一 个 自 定义 的 构造 函数 ， 它 只 有 一 个 System.String 参 数 

Type[] constructorArgs = new Type[1]; 

constructorArgs[0] = typeof(string); 

ConstructorBuilder constructor = 
helloWorldClass.DefineConstructor(MethodAttributes.Public, 
CallingConventions.Standard, constructorArgs); 


// 产生 必要 的 CIL 代 码 到 这 个 构造 函数 

ILGenerator constTructorIL = constructor.GetILGenerator(); 
constructorIL.Emit(0pCodes.Ldarg_0); 

Type objectClass = typeof(object) ; 

ConstructorInfo superConstructor = objectClass.GetConstructor(new Type[0]); 
constructorIL.Emit(0OpCodes.Call，superConstructor); // 调用 基 类 的 构造 函数 


// 加 载 对 象 的 this 指 针 到 栈 上 
constructorIl .Emit(OpCodes.Ldarg 0); 


// 加 载 输入 参数 到 虚拟 栈 上 并 存储 在 msgField 中 

constructorIL .Emit(OpCodes.Ldarg 1); 

constructorIL .Emit(OpCodes.Stfld, msgField); // 赋值 msgField 
constructorIL .Emit(OpCodes.Ret); // 返回 


现在 读者 已 经 发 现 ， 只 要 给 类 型 定义 了 自 定义 的 构造 函数 ， 默 认 的 构造 函数 就 被 悄然 删除 了 。 要 
想 重新 定义 一 个 没有 参数 的 构造 函数 ， 只 要 调用 TypeBuilder 类 型 的 DefineDefaultConstructor() 方 法 : 

// 重新 村 入 默认 构造 池 数 

helloWorldClass .DefineDefaultConstructor(MethodAttributes.Public); 

这 个 调用 产生 标准 的 CIL 代 码 ， 用 来 定义 默认 的 构造 函数 : 

-method public hidebysig specialname rtspecialname 


instance void .ctor() cil managed 


.maxstack 1 

ldarg.0 

call instance void [mscorlib]System.Object::.ctor() 
ret 


} 


18.10.8 产生 SayHello() 方 法 


最 后 ， 让 我 们 看 看 如 何 产生 SayHello() 方 法 。 首 先 需 要 做 的 是 从 helloworldClass 变 量 获 得 
MethodBuilder 类 型 。 一 旦 得 到 这 个 类 型 ， 就 可 以 定义 方法 和 获得 ILGenerator 来 注入 CIL 指 令 : 


// 创建 SayHello() 方 法 

MethodBuilder sayHiMethod = 
helloWorldClass .DefineMethod("SayHello", 
MethodAttributes.Public, null, null); 

methodIL = sayHiMethod.GetILGenerator(); 


`// 输出 一 行 到 控制 台 
methodIL .EmitWritelLine("Hello there!"); 
methodIL .Emit(OpCodes .Ret); 


这 里 创建 了 一 个 没有 参数 、 什 么 也 不 返回 ( 用 DefineMethod() 调 用 中 包含 的 空 项 表示 ) 的 公共 方 
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法 (MethodAttributes.Public )。 另 外 请 关注 下 EmitWriteLine() 调 用 。 这 个 ILGenerator 类 的 辅助 成 员 
自动 输出 一 行 到 标准 输出 中 。 


18.10.9 使 用 动态 产生 的 程序 集 


现在 已 经 构造 好 了 创建 和 保存 程序 集 的 逻辑 ， 只 需要 一 个 类 来 触发 这 个 逻辑 。 假 设 你 的 项 目 定义 
了 第 二 个 类 AsmReader 。Main() 函数 的 逻辑 通过 Thread.GetDomain() 方 法 得 到 当前 的 AppDomain ， 
AppDomain 被 用 来 承载 动态 创建 的 程序 集 。 一 旦 有 了 引用 ， 就 可 以 调用 CreateMyAsm( ) 方 法 。 

为 了 让 我 们 的 程序 更 加 有 趣 ， 在 调用 的 CreateMyAsm( ) 方 法 返回 后 ,可 以 练习 一 下 延迟 绑 定 ( 见 第 
15 章 ) 来 加 载 新 创建 的 程序 集 到 内 存 中 并 且 和 HelloWorld 类 的 成 员 交 互 。 按 如 下 所 示 修 改 Main() 方 法 : 


static void Main(string[] args) 





Console.WritelLine("***** The Amazing Dynamic Assembly Builder App *****"); 


// 得 到 当前 线程 的 应 用 程序 域 


AppDomain curAppDomain = Thread.GetDomain(); 


// 使 用 辅助 函数 f(X) 创 建 动态 程序 集 
CreateMyAsm(curAppDomain); 
_ Console.WriteLine("-> Finished creating MyAssembly.d1l1."); 


// 加载 新 的 程序 集 
Console.WriteLine("-> Loading MyAssembly.dl1 from file."); 
Assembly a = Assembly.Load("MyAssembly"); 


// 得 到 HelloWorld 类 型 
Type hello = a.GetType("MyAssembly.HelloWorld"); 


// 创建 HelloWorld 对 象 并 调用 正确 的 构造 函数 

Console.Write("-> Enter message to pass Helloworld class: "); 
string msg = Console.ReadLine(); 

object[] ctorArgs = new object[1]; 

ctorArgs[0] = msg; 

object obj = Activator.CreateInstance(hello, ctorArgs); 


// 调用 SayHello() 并 且 显 示 返 回 的 字符 囊 

Console.WriteLine("-> Calling SayHello() via late binding."); 
MethodInfo mi = hello.GetMethod("SayHello"); 

mi.Invoke(obj, null); 


// 触发 GetMsg() 
mi = hello.GetMethod("GetMsg"); 
Console.WriteLine(mi.Invoke(obj, null)); 


事实 上 ， 至 此 你 已 经 创建 了 一 个 可 以 在 运行 时 创建 和 执行 程序 集 的 .NET 程 序 集 。 这 个 例子 结 
束 了 对 CIL 和 动态 程序 集 作 用 的 学 习 。 和 希望 这 章 能 够 加 深 读 者 对 .NET 类 型 系统 以 及 CIL 语 法 和 语义 
的 理解 。 


源 代 码 ”DynamicAsmBnuilder 项 目的 源 代码 位 于 Chapter 18 子 目录 下 。 
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18.11 “小结 


在 这 一 章 里 ， 我 们 学 习 了 CIL 的 语法 和 语义 。 与 C# 这 样 的 高 级 托管 语言 不 同 ，CIL 不 仅 定 义 了 一 
系列 关键 字 ， 而 且 提 供 了 指令 ( 用 来 定义 程序 集 的 结构 及 其 类 型 )、 特 性 (更 进一步 定义 了 一 个 给 定 
指令 ) 以 及 操作 码 ( 用 来 实现 类 型 成 员 )。 

另外 ， 还 介绍 了 CIL 的 编程 工具 (ilasm.exe 、sharpDevelop 和 peverify.exe )， 并 且 学 习 了 如 何 用 正 
反 向 工程 通过 新 的 CIL 代 码 修改 .NET 程序 集 的 内 容 。 在 此 之 后 , 我 们 花 时 间 学 习 了 如 何 建立 当前 的 (和 
被 引用 的 ) 程序 集 、 命 名 空间 、 类 型 和 成 员 ， 然 后 介绍 了 一 个 简单 的 示例 ， 使 用 CIL、 命 令 行 工具 和 
一 些 脑 细胞 构建 了 一 个 .NET 代 码 库 和 可 执行 文件 。 

最 后 介绍 了 创建 动态 程序 集 的 过 程 。 使 用 System.Reflection.Emit 命 名 空间 ， 可 以 在 运行 时 在 内 
存 中 定义 .NET 程 序 集 。 正 如 你 所 看 到 的 ， 使 用 这 个 特殊 的 API 要 求 你 详细 了 解 CIL 代 码 的 语义 。 对 于 
大 多 数 .NET 程 序 而 言 , 构建 动态 程序 集 并 不 是 常见 的 任务 , 但 对 那些 需要 构建 支持 工具 和 其 他 编程 实 
用 工具 的 人 来 说 ， 是 十 分 有 用 的 。 
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人 喜欢 运行 缓慢 迟钝 的 应 用 程序 ， 也 没 人 喜欢 打开 的 某 个 新 任务 影响 程序 其 他 部 分 的 响应 

7 速度 。 在 .NET 发 布 之 前 ， 构 建 具备 执行 多 任务 能 力 的 应 用 程序 需要 编写 极其 复杂 的 使 用 
Windows 线 程 API 的 C++ 代码 。 幸 好 .NET 平 台 提 供 了 许多 方法 ， 可 以 很 轻松 地 构建 在 特殊 的 执行 路 径 
执行 复杂 操作 的 软件 。 

首先 ,我 们 定义 “多 线程 应 用 程序 ”的 总 体 性 质 ， 然 后 回顾 .NET 的 委托 类 型 ， 并 理解 它 对 异步 方 
法 调用 的 内 在 支持 。 你 将 看 到 ， 这 项 技术 允许 用 户 自 动 地 在 次 线程 中 调用 某 个 方法 ， 而 不 需要 手工 创 
建 或 配置 线程 。 

接着 , 将 研究 原始 的 线程 命名 空间 ， 即 从 .NET 1.0 起 就 发 布 了 的 System.Threading。 这 里 的 许多 类 
型 ( 比如 Thread、Threadstart 等 ) 可 以 显 式 地 创建 更 多 执行 线程 并 同步 共享 资源 。 它 们 可 以 确保 多 线 
程 以 非 易 失 (nonvolatile ) 的 方式 共享 数据 。 

本 章 剩 下 的 部 分 将 介绍 近期 的 三 项 可 供 .NET 开 发 者 构建 多 线程 软件 的 技术 ， 它 们 是 任务 并 行 库 
(TPL )、 并 行 LINQ ( PLINQ ) 和 C# 中 新 的 内 置 异步 关键 字 ( async 和 await )。 你 将 看 到 ， 这 些 特性 可 
以 显著 地 简化 构建 快速 响应 的 多 线程 应 用 程序 的 过 程 。 


19.1 进程 、 应 用 程序 域 、 上 下 文 及 线程 之 间 的 关系 


在 第 17 章 中 , 线程 被 定义 为 可 执行 应 用 程序 中 的 基本 执行 单元 。 虽 然 许多 .NET 程 序 在 单线 程 模式 
下 运行 得 很 好 ， 但 程序 集 的 主线 程 ( 在 Main() 方 法 执行 时 由 CLR 产 生 的 ) 可 能 随时 创建 次 线程 ， 来 执 
行 一 些 额 外 的 工作 单元 。 通 过 创建 这 些 新 增 的 线程 ， 能 构建 出 响应 更 快 (但 在 单 核 机 器 上 不 一 定 执行 
更 快 ) 的 应 用 程序 。 

System.Threading 随 .NET 1.0 发 布 ， 它 提供 了 一 些 创 建 多 线程 应 用 程序 的 途径 。Thread 类 是 核心 ， 
它 代 表 了 某 个 给 定 的 线程 。 若 想 要 通过 编程 得 到 对 当前 (正在 执行 某 段 代码 的 ) 线程 的 引用 ， 只 需要 
调用 静态 属性 Thread.CurrentThread， 如 下 所 示 : 

static void ExtractExecutingThread() 

ey 

Thread currThread = Thread.CurrentThread; 


在 .NET 平 台 下 ， 应 用 程序 域 和 线程 之 间 并 不 是 一 一 对 应 的 。 事实 上 ,在 任何 时 间 ， 一 个 应 用 程 
序 域内 都 可 能 有 多 个 线程 。 而 且 ， 一 个 特定 的 线程 在 它 的 生命 膨 期 内 并 不 一 定 被 限定 在 一 一 个 应 用 程 
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序 域 中 。Windows OS 线程 调度 程序 和 .NET CLR 会 根据 需要 让 线程 能 够 自由 地 跨越 应 用 程序 域 的 
边界 。 
虽然 活动 的 线程 能 够 跨越 多 个 应 用 程序 域 边界 ,但 是 在 任何 一 个 时 间 点 上 , 一 个 线程 只 能 运行 在 
一 个 应 用 程序 域 中 ( 也 就 是 说 ， 一 个 线程 同时 在 多 个 应 用 程序 域 上 执行 任务 是 不 可 能 的 ) 。 当 希望 访 
问 〈 正 在 承载 当前 线程 的 ) 应 用 程序 域 时 ， 请 调用 静态 方法 Thread.GetDomain()， 如 下 所 示 : 
static void ExtractAppDomainHostingThread() 


// 获取 正在 承载 当前 线程 的 应 用 程序 域 
AppDomain ad = Thread.GetDomain(); 


在 任何 特定 的 时 刻 ， 一 个 线程 也 可 以 移动 到 一 个 特定 的 上 下 文中 ,并且 它 可 以 由 CLR 重 新 部 署 在 
一 个 新 的 上 下 文中 。 要 获得 正在 执行 中 的 线程 的 当前 上 下 文 ， 请 调用 静态 属性 Thread.CurrentContext 
( 它 返 回 System.Runtime.Remoting.Contexts.Context 对 象 )， 如 下 所 示 : 

static void ExtractCurrentThreadContext() 


// 获取 当前 操作 线程 所 处 的 上 下 文 
Context ctx = Thread.CurrentContext; 


此 外 ，CLR 是 控制 线程 移入 /移出 应 用 程序 域 和 上 下 文 的 实体 。 作 为 .NET 开 发 人 员 ， 你 通常 无 须 
知道 一 个 线程 在 哪里 结束 (或 者 准确 地 说 ， 它 是 在 什么 时 候 被 放置 在 新 的 边界 上 的 )， 但 是 ， 至 少 应 
当知 道 获得 底层 原 语 ( underlying primitive ) 的 不 同方 法 。 


19.1.1 并 发 问题 


多 线程 编程 的 “乐趣 ”( 苦 中 作乐 ) 之 一 是 : 几乎 无 法 控制 底层 操作 系统 和 CLR 对 线程 的 调度 。 
举例 来 说 ,如 果 精 心 编写 一 段 创建 一 个 新 线程 的 代码 ,你 不 能 保证 这 个 线程 被 立即 执行 。 更 准确 地 
说 , 这 段 代 码 仅 仅 通知 操作 系统 或 CLR 尽 快 地 执行 这 个 线程 (通常 是 线程 调度 程序 给 这 个 线程 分 配 
时 间 )。 

此 外 ， 既 然 通过 CLR 线 程 可 以 在 应 用 程序 域 和 上 下 文 边界 之 间 移 动 ， 就 必须 留心 应 用 程序 中 的 线 
程 不 稳定 ( thread-volatile ) 操作 ( 如 在 多 线程 访问 的 情况 下 ) 和 原子 型 ( atomic ) 操作 。 要 知道 ， 线 
程 不 稳定 操作 是 很 危险 的 。 

举例 来 说 , 假设 有 一 个 线程 正在 调用 某 个 特定 对 象 的 一 个 方法 , 为 了 让 男 一 个 线程 也 访问 同一 对 
象 的 同一 方法 ,线程 调度 程序 将 发 出 指令 挂 起 第 一 个 线程 。 

而 此 时 ， 如 果 前 一 个 线程 没有 全 部 完成 当前 的 操作 , 那么 后 来 的 线程 可 能 看 到 对 象 处 于 被 部 分 修 
改 状 态 。 这 样 它 所 读 到 的 数据 基本 上 是 虚假 的 ， 而 这 会 使 应 用 程序 发 生 非 常 奇怪 的 ( 并 且 是 非常 难以 
发 现 的 ) bug， 而 且 这 些 bug 都 难以 重 现 和 调试 。 

另 一 方面 ， 原 子 型 操作 在 多 线程 环境 下 总 是 ( 线程 ) 安全 的 。 可 令 人 泪 丧 的 是 ，.NET 基 础 类 库 中 
只 有 很 少 的 操作 能 保证 原子 型 。 甚 至 将 一 个 值 赋 给 一 个 成 员 变 量 的 操作 也 不 是 原子 型 的 。 因 此 ， 如 果 
在 .NET Framework 4.5 SDK 中 没有 明确 指明 一 个 操作 是 原子 型 的 ， 那么 请 先 假定 它 是 线程 不 稳定 的 并 
小 心 对 待 。 
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19.1.2 ”线程 同步 的 作用 


因此 很 明显 ， 多 线程 程序 本 身 是 相当 不 稳定 的 ， 因 为 在 同一 时 间 ， 多 个 线程 都 能 ( 或 多 或 少 地 ) 
运行 共享 的 功能 块 。 为 了 保护 应 用 程序 的 资源 不 被 破坏 , .NET 开 发 者 必须 使 用 线程 的 各 种 原 语 ( 比如 
lock、monitor 和 [Synchronization] 特 性 或 语言 关键 字 支 持 ) 来 控制 线程 对 它们 的 访问 。 

虽然 在 .NET 平台 下 , 构建 一 个 健壮 的 多 线程 程序 的 困难 并 没有 完全 克服 , 但 这 个 复杂 过 程 还 是 被 
大 大 简化 了 。 使 用 System.Thzeading 命 名 空间 中 定义 的 类 型 、.NET 4.0 或 更 高 版 本 的 TPL ( Task Parallel 
Library， 任 务 并 行 库 ) 以 及 .NET 4.5 中 C# 的 async 和 await 语 言 关 键 字 ， 可 以 比较 省 心地 操作 多 线程 。 

在 深入 介绍 System.Threading 命 名 空间 、TPL 和 C# async 和 await 关 键 字 之 前 ， 我 们 先 来 学 习 .NET 
委托 如 何以 异步 的 方式 调用 方法 。 尽 管 .NET 4.5 中 的 C# async 和 await 关 键 字 肯定 比 异 步 委托 更 加 简 
单 , 但 了 解 如 何以 这 种 方式 与 代码 交互 仍然 是 十 分 重要 的 ( 相信 我 ， 在 生产 代码 中 有 相当 一 部 分 使 用 
了 异步 委托 )。 


19.2 .NET 委托 的 简短 回顾 


回想 一 下 ，.NET 委 托 是 一 个 类 型 安全 的 、 面 向 对 象 的 函数 指针 。 当 定义 一 个 .NET 委 托 类 型 时 ， 
作为 响应 ，C# 编 译 器 将 创建 一 个 派生 自 System.MulticastDelegate 的 密封 类 ( 而 System.Multi- 
castDelegate 又 派生 自 System.Delegate )。 这 些 基 类 为 每 一 个 委托 提供 了 维护 方法 地 址 列表 的 能 力 , 这 
些 方法 可 以 在 以 后 被 调用 。 让 我 们 来 看 一 看 下 面 的 Binary0p 委 托 (在 第 10 章 中 被 首次 定义 )。 


// C# 委 托 类 型 
public delegate int BinaryOp(int x, int y); 


从 Binary0p 的 定义 来 看 , 它 能 够 指向 任何 一 个 拥有 两 个 整 型 参数 、 返 回 一 个 整数 的 方法 。Binary0p 
被 编译 后 ， 其 所 属 程序 集 将 包含 一 个 根据 委托 声明 动态 生成 的 类 的 定义 。 在 Binary0p 的 例子 中 ， 该 类 
看 起 来 差不多 是 下 面 的 样子 〈 以 伪 代 码 的 方式 ) : 


public sealed class BinaryOp : System.MulticastDelegate 
{ 


public BinaryOp(object target, uint functionAddress); 

public int Invoke(int x, int y); 

public IAsyncResult BeginInvoke(int x, int y, 
AsyncCallback cb, object state); 

public int EndInvoke(IAsyncResult result); 


回想 一 下 ， 生 成 的 Invoke() 方 法 用 来 调用 被 代理 对 象 以 同步 方式 维护 的 方法 。 因 此 ， 调 用 委托 的 
线程 ( 比如 应 用 程序 的 主线 程 ) 将 会 一 直 等 待 ， 直 到 委托 调用 完成 。 此 外 ， 在 C# 中 ，Invoke() 方 法 并 
不 会 直接 在 代码 中 被 调用 ， 而 是 在 使 用 “正常 的 ”方法 调用 语法 时 在 幕后 被 触发 的 。 

考虑 下 面 的 控制 台 程序 ( SyncDelegateReview ), 它 在 同步 ( 又 称 阻塞 ) 模 式 下 调用 了 静态 方法 Add() 
《请 一 定 在 C# 代 码 文件 中 导入 System.Threading 命 名 空间 ， 因 为 你 将 调用 Thread.Sleep() 方 法 ); 


namespace SyncDelegateReview 


public delegate int BinaryOp(int x, int y); 


19.2 .NET 委托 的 简短 回顾 569 


class Program 
static void Main(string[] args) 
Console.WriteLine("***** Synch Delegate Review *****"); 


// 输出 正在 执行 中 的 线程 ID 
Console.WritelLine("Main() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 


// 在 同步 模式 下 调用 Add() 
BinaryOp b = new BinaryOp(Add); 


// 也 能 写 b.Invoke(10,10); 
int answer = b(10, 10); 


// 直到 Add() 方 法 完成 后 ， 这 行 代码 才 会 执行 
Console.WritelLine("Doing more work in Main()!"); 
Console.WritelLine("10 + 10 is {0}.", answer); 
Console.ReadLine(); 


} 
static int Add(int x, int y) 


// 输出 正在 执行 中 的 线程 ID 
Console.WriteLine("Add() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 


// 暂停 一 下 ， 模 拟 一 个 耗 时 的 操作 
Thread. Sleep(5000); 
return x + yj; 


} 
} 


在 Add() 方 法 中 ,为 了 模拟 一 个 耗 时 很 多 的 操作 ,我们 调用 了 静态 方法 Thread.Sleep() 来 使 当前 线 
程 挂 起 ( 差不多 ) 五 秒 钟 。 因 为 你 是 在 同步 模式 下 调用 Add() 方 法 ，Main() 方 法 将 会 等 到 Add( ) 方 法 完 
成 才 输出 操作 的 结果 。 

接 下 来 , 注意 一 下 Main() 方 法 ， 它 (通过 Thread.CurrentThread ) 获得 对 当前 线程 的 访问 ， 然 后 通 
过 ManagedThreadId 属 性 输出 线程 的 ID 来 。 这 一 逻辑 也 会 出 现在 静态 方法 Add() 中 。 正 如 所 料 ， 由 于 程 
序 中 所 有 的 任务 都 被 主线 程 执 行 ， 控 制 台 中 显示 的 将 是 相同 的 ID 值 : 





洲 米 冰球 Synch Delegate Review ***** 
Main() invoked on thread 1. 

Add() invoked on thread 1. 

Doing more work in Main()! 

10 + 10 is 20. 


Press any key to continue 。 . 





当 运 行 这 个 程序 的 时 候 , 请 注意 在 Main() 中 的 Console.WriteLine() 逻 辑 执行 之 前 , 有 5 秒 的 延迟 发 
生 。 虽然 许多 方法 可 以 被 同步 调用 ， 且 没有 负面 影响 , 但 如 果 需 要 的 话 ，.NET 委 托 能 够 以 异步 方式 调 
用 方法 。 
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源 代码 ”SyncDelegateReview 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.3 委托 的 异步 性 


如 果 刚 接触 多 线程 ， 读 者 可 能 想 知道 究竟 什么 是 异步 方法 调用 。 不 用 想 就 知道 ， 有 些 程序 操作 会 
花费 较 长 时 间 。 前 面 的 Add() 虽 然 纯 粹 是 示例 ， 但 是 设想 一 下 这 样 的 情况 : 一 个 单线 程 程序 调用 一 个 
远程 对 象 的 方法 ， 调 用 一 个 执行 耗 时 数据 库 查询 的 方法 ， 下 载 一 个 大 文档 ， 或 向 一 个 外 部 文件 写 500 
行 的 文字 。 在 执行 这 些 操作 时 ， 应 用 程序 会 显得 挂 起 很 长 时 间 。 在 任务 完成 之 前 ， 这 个 程序 的 其 他 部 
分 ( 比如 菜单 激活 、 工 具 条 的 单 击 或 者 控制 台 的 输出 ) 都 会 挂 起 ( 这 会 让 用 户 不 耐烦 ) 。 

因此 问题 是 ， 如 何 使 委托 在 单独 的 线程 上 调用 方法 ,以 便 模拟 多 个 “同时 ”运行 的 任务 ? 好 消息 
是 每 一 个 .NET 委 托 类 型 自动 配备 了 这 项 能 力 , 更 好 的 消息 是 不 需要 深入 研究 System.Threading 命 名 空 
间 的 细节 就 能 实现 ( 虽然 这 些 实体 可 以 自然 地 联合 工作 )。 


19.3.1 BeginInvoke() 和 EndInvoke() 方 法 


C# 编 译 器 处 理 delegate 关 键 字 的 时 候 ， 其 动态 生成 的 类 定义 了 两 个 方法 一 BeginInvoke() 和 
EndInvoke()。 基 于 我 们 对 Binary0p 委 托 的 定义 ， 这 些 方法 的 原型 如 下 : 


public sealed class BinaryOp : System.MulticastDelegate 


// 用 于 异步 调用 方法 
public IAsyncResult BeginInvoke(int x, int y， 
AsyncCallback cb, object state); 


// 用 于 获取 被 调用 方法 的 返回 值 
public int EndInvoke(IAsyncResult result); 
传人 BeginInvoke() 的 参数 的 最 初 集合 必须 符合 C# 委 托 约定 ( 对 于 Binary0p， 就 是 两 个 整 型 ) 。 最 
后 两 个 参数 必须 是 system.AsyncCallback 和 System.0bject。 稍 后 我 们 将 研究 这 两 个 参数 的 作用 ,目前 ， 
暂时 把 null 值 赋 给 它们 。 根 据 Binary0p 的 返回 类 型 ，EndInvoke() 的 返回 值 是 整 型 ,而 这 个 方法 的 唯一 
参数 总 是 IAsyncResult 类 型 。 


19.3.2 System.IAsyncResult 接 口 


男 外 ，BeginInvoke() 返 回 的 对 象 实现 了 IAsyncResult 接 口 ， 而 EndInvoke() 需 要 一 个 IAsyncResult 
兼容 ( 即 实 现 了 IAsyncResult 接 口 的 类 型 ) 类 型 作为 它 唯一 的 参数 。 由 BeginInvoke() 返 回 的 
IAsyncResult 兼 容 对 象 主要 是 一 种 看 合 机 制 ， 它 允许 调用 的 线程 在 稍 后 通过 EndInvoke() 获 取 异 步 方 法 
调用 的 结果 。IAsyncResult 接 口 (在 System 命 名 空间 中 定义 ) 的 定义 如 下 : 


public interface IAsyncResult 


object AsyncState { get; } 
WaitHandle AsyncWaitHandle { get; } 
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bool CompletedSynchronously { get; } 
bool IsCompleted { get; } 


在 这 个 最 简单 的 例子 中 ， 不 需要 直接 调用 IAsyncResult 的 成 员 。 需 要 做 的 全 部 事情 就 是 缓存 自 
BeginInvoke() 返 回 的 IAsyncResult 兼 容 类 型 , 并 在 准备 获取 方法 调用 的 结果 时 , 把 它 传 给 EndInvoke()。 
可 以 看 到 ， 当 想 更 深入 到 获取 方法 返回 值 的 过 程 时 ， 可 以 调用 IAsyncResult 兼 容 的 成 员 。 


说 明 ”如果 异 步调 用 一 个 无 返回 值 的 方法 ， 仅 仅 调用 BeginInvoke() 就 可 以 了 。 在 这 种 情况 下 ， 我 们 
不 需要 缓存 IAsyncResult 兼 容 对 象 ， 也 不 需要 首先 调用 EndInvoke() ( 因为 没有 收 到 返回 值 ) 。 
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为 了 通知 Binary0p 委 托 异 步调 用 Add() ， 需 要 修改 上 面 项 目 中 的 逻辑 ( 你 可 以 在 已 有 的 项 目 中 添加 
代码 ， 但 在 下 载 的 代码 包 中 有 一 个 新 建 的 控制 台 应 用 程序 ， 名 为 AsyncDelegate )。 需 要 像 下 面 这 样 修 
改 前 面 的 Main() 方 法 : 

static void Main(string[] args) 


Console.WriteLine("***** Async Delegate Invocation *****"); 


// 输出 正在 执行 中 的 线程 的 ID 
Console.WiriteLine( "Main() invoked on thread {0}.", 
Thread.CurrentThread .ManagedThreadId) ; 


// 在 次 线程 中 调用 Add() 
BinaryOp b = new BinaryOp(Add) ; 
IAsyncResult iftAR = b.BeginInvoke(10, 10, null, null); 


// 在 主线 程 中 做 其 他 事情 


Console.WritelLine("Doing more work in Main()!"); 


// 当 执 行 完 后 获取 Add() 方 法 的 结果 

int answer = b.EndInvoke(iftAR); 
Console.WriteLine("10 + 10 is {0}.", answer); 
Console.ReadLine(); 


如 果 运 行 这 个 程序 , 我 们 将 发 现 两 个 不 同 的 ID 值 ， 这 说 明 事实 上 在 当前 应 用 程序 域 中 有 两 个 线程 
正在 运行 








六 水 六 半 闭 Async Delegate Invocation 冰冰 沙 半 水 
Main() invoked on thread 1. 

Doing more work in Main()! 

Add() invoked on thread 3. 

10 + 10 is 20. 





Nn TE ET Ne ep ep Pew es ee pie 





除了 显示 的 ID 值 不 同 ， 只 要 一 运行 程序 ， 消 息 “Doing more work in Main()!” 立 即 就 显示 出 来 
了 ， 而 次 线程 正在 忙于 处 理 业务 。 
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19.4.1 同步 调用 线程 


如 果 仔 细 思 考 一 下 Main() 的 实现 , 可 能 意识 到 BeginInvoke() 和 EndInvoke() 之 间 的 时 间 间 隔 明 显 小 
于 5 秒 钟 ， 因 此 ， 在 “Doing more work in Main()!” 被 输出 到 控制 台 后 ， 主 线程 将 会 被 阻 蹇 ， 并 一 
直 等 到 次 线程 完成 才能 获得 Add() 方 法 的 结果 。 这 样 效率 似乎 不 太 高 ， 我 们 需要 做 另 一 个 同步 调用 : 


static void Main(string[] args) 


”Binaryop b = new BinaryOp(Add) ; 


// 一 旦 下 一 条 语句 被 处 理 ， 调 用 线程 在 BeginInvoke() 完 成 之 前 就 被 阻 军 了 
IAsyncResult iftAR = b.BeginInvoke(10, 10, null, null); 


// 调用 的 时 间 远 远 小 于 5 秒 钟 


Console.WritelLine("Doing more work in Main()!"); 


// 现在 再 次 等 待 其 他 线程 完成 
int answer = b.EndInvoke(iftAR); 

很 明显 ， 在 不 同 环境 下 ， 如 果 调 用 线程 (这 里 指 主 线程 ) 有 被 阻塞 的 可 能 ， 那 么 异步 委托 就 毫 无 
优势 可 言 。 为 了 让 调用 线程 能 够 发 现 异 步调 用 是 否 完成 ，IAsyncResult 接 口 提 供 了 IsCompleted 属 性 。 
使 用 这 个 成 员 ， 调 用 线程 在 调用 EndInvoke() 之 前 ， 便 能 够 判断 异步 调用 是 否 真 正 完成 。 

如 果 方 法 没有 完成 ，IsCompleted 返 回 false， 这 时 调用 线程 可 以 自由 地 做 其 他 事情 。 如 果 
IsCompleted 返 回 true， 调 用 线程 便 可 能 以 最 小 的 阻塞 代价 获得 返回 结果 。 仔 细 思 考 一 下 下 面 Main() 方 
法 中 的 改动 : 


static void Main(string[] args) 


BinaryOp b = new BinaryOp(Add) ; 
IAsyncResult iftAR = b.BeginInvoke(10, 10, null, null); 


// 直到 Add() 方 法 完成 ， 消 息 才 会 显示 出 来 
while( !iftAR.IsCompleted) 


Console.WritelLine("Doing more work in Main()!"); 
Thread. Sleep(1000); 


1 现在 我 们 知道 Add() 完 成 了 
int answer = b.EndInvoke(iftAR); 

这 里 ， 在 次 线程 完成 之 前 ,循环 将 不 断 地 执行 Console.WriteLine() 语 句 。 一 旦 次 线程 完成 ,我们 
便 能 够 确信 Add() 方 法 真正 完成 了 ,从 而 获得 Add() 方 法 的 返回 值 。 然而 , 调用 Thread.Sleep(1000) 对 于 
这 个 应 用 程序 的 正常 工作 来 说 不 是 必需 的 ， 但 是 它 可 以 强制 主线 程 在 每 次 迭代 之 后 等 待 大 约 1 秒 ， 也 
可 以 防止 相同 的 消息 输出 几 百 次 。 以 下 是 输出 结果 ( 根据 机 器 的 速度 和 线程 启动 的 时 间 ， 输 出 结果 会 
稍 有 不 同 ): 
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***** Async Delegate Invocation ***** 
Main() invoked on thread 1. 

Doing more work in Main()! 

Add() invoked on thread 3. 

Doing more work in Main()! 

Doing more work in Main()! 

Doing more work in Main()! 

Doing more work in Main()! 

Doing more work in Main()! 

10 + 10 is 20. 


ET TT 


除 IsCompleted 属 性 之 外 ，IAsyncResult 接 口 提 供 了 AsyncwaitHandle 属 性 以 实现 更 加 灵活 的 等 待 逻 
辑 。 这 个 属性 返回 一 个 waitHandle 类 型 的 实例 ， 该 实例 公开 了 一 个 名 为 Waitone() 的 方法 。 使 用 
WaitHandle.Waitone() 的 好 处 是 可 以 指定 最 长 等 待 时 间 。 如 果 超 时 ，Maitone() 返 回 false。 考 虑 while 
循环 中 的 如 下 变化 ， 它 没有 调用 Thread. sleep(): 


while (!iftAR.AsyncWaitHandle.WaitOne(1000, true)) 





Console.WriteLine("Doing more work in Main()!"); 


虽然 ITAsyncResult 的 这 些 属 性 提供 了 同步 调用 线程 的 方式 , 但 是 这 不 是 最 高 效 的 方式 。 总 地 来 说 ， 
IsCompleted 属 性 就 像 一 个 令 人 讨厌 的 经 理 (或 者 同学 ) ， 他 总 是 不 断 地 问 : “你 完成 了 吗 ? ” 谢 天 谢 
地 ， 委 托 提 供 了 另外 的 〈 也 是 更 有 效 的 ) 技术 来 获取 异步 调用 的 结果 。 


源 代 码 ”AsyncDelegate 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.4.2 AsyncCallback 委 托 的 作用 


不 通过 轮 询 一 个 委托 来 确定 异步 调用 方法 执行 是 否 结束 ,而 是 在 任务 完成 时 由 次 线程 主动 通知 调 
用 线程 的 方式 ， 这 样 可 能 更 好 。 如 果 想 要 实现 这 种 方式 ， 需 要 在 调用 BeginInvoke() 时 提供 一 个 
System.AsyncCallback 委 托 的 实例 作为 参数 , 这 个 参数 的 默认 值 是 nul1。 只 要 提供 了 AsyncCallback 对 象 ， 
当 异 步调 用 完成 的 时 候 ， 委 托 便 会 自动 调用 ( AsyncCallback 对 象 ) 指定 的 方法 。 


说 明 ”回调 方法 将 在 次 线程 而 不 是 主线 程 中 调用 。 这 在 图 形 用 户 界 面 ( WPF 或 Windows Forms ) 中 使 
用 线程 时 ， 具 有 重要 的 意义 。 因 为 控件 都 是 与 线程 紧密 相关 的 ， 只 能 由 创建 它们 的 线程 进行 
操作 。 你 将 在 本 章 稍 后 介绍 任务 并 行 库 (TPL ) 和 .NET 4.5 中 新 的 C#async 和 await 关 键 字 时 看 
到 一 些 在 GUI 中 使 用 线程 的 示例 。 
和 所 有 委托 一 样 ，AsyncCallback 委 托 仅仅 能 够 调用 那些 符合 特定 模式 的 方法 ,这些 方法 只 有 一 个 
参数 IAsyncResult， 而 且 没 有 返回 值 。 


// AsynCallback 的 目标 必须 和 下 面 的 模式 相 匹 配 
void MyAsyncCallbackMethod(IAsyncResult itfAR) 
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假定 有 另外 一 个 控制 台 应 用 程序 ( AsyncCallbackDelegate ) 使 用 了 Binary0p 委 托 。 但 这 次 不 需要 
轮 询 委 托 以 判断 Add() 方 法 是 否 执 行 完 毕 ， 而 是 定义 一 个 名 为 AddComplete() 的 静态 方法 ， 用 它 来 接受 
异步 调用 完成 的 通知 。 同 样 ， 该 示例 使 用 类 级 别 的 静态 bool 字 段 ， 它 确保 Main() 中 的 主线 程 持 续 运 行 
一 个 任务 ， 直 到 次 线程 完成 。 


说 明 严格 地 说 ， 这 样 使 用 Boolean 变 量 不 是 线程 安全 的 ， 因 为 有 两 个 不 同 的 线程 访问 它 的 值 。 这 在 
当前 示例 中 没有 问题 ， 但 一 般 来 说 ， 你 必须 确保 由 多 个 线程 共享 的 数据 是 锁定 的 。 本 章 稍 后 
将 介绍 这 种 做 法 。 


namespace AsyncCallbackDelegate 
public delegate int BinaryOp(int x, int y); 
class Program 
private static bool isDone = false; 
static void Main(string[] args) 


Console.WritelLine("***** AsyncCallbackDelegate Example *****"); 
Console.WriteLine("Main() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 


BinaryOp b = new BinaryOp(Add); 
IAsyncResult iftAR = b.BeginInvoke(10, 10, 
new AsyncCallback(AddComplete), null); 


// 这 里 可 以 做 其 他 的 事情 
while (!isDone) 


Thread. Sleep(1000); 
Console.WritelLine("Working...."); 


Console.ReadLine(); 


} 
static int Add(int x, int y) 


Console.WriteLine("Add() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 

Thread. Sleep(5000); 

return x + y; 


} 
static void AddComplete(IAsyncResult itfAR) 


Console.WriteLine("AddComplete() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 
Console.WritelLine("Your addition is complete"); 
isDone = true; 
} 
} 
’ 


19.4 异步 调用 方法 575 


当 Add() 执 行 完成 的 时 候 ，AsyncCallback 委 托 将 调用 静态 的 AddComplete() 方 法 。 如 果 运行 上 面 这 
个 程序 ， 可 以 确定 次 线程 是 回调 AddComplete() 的 线程 : 


***** AsyncCallbackDelegate Example 六 冰冰 六 沙 
Main() invoked on thread 1. 

Add() invoked on thread 3， 

Working.... 

Working.... 

Working.... 

Working.... 

Working.... 

AddComplete() invoked on thread 3. 

Your addition is complete 





和 本 章 的 其 他 示例 一 样 ， 输 出 结果 会 稍 有 不 同 。 事 实 上 ， 你 很 可 能 看 到 在 其 他 内 容 输 出 完毕 后 还 
有 “Working...” 出 现 。 这 是 Main() 中 1 秒 延 迟 的 副产品 。 


19.4.3 AsyncResult 类 的 作用 


当前 ，AddComplete() 方 法 并 没有 输出 操作 ( 两 个 数 的 和 ) 的 实际 结果 。 这 样 做 的 原因 是 : 
AsyncCallback 委 托 的 目标 ( 即 本 例 的 AddComplete() ) 无 法 访问 在 Main() 中 创建 的 Binary0p 委 托 。 因此， 
不 能 在 AddComplete() 中 调用 EndInvoke()。 

虽然 可 以 把 Binary0p 定 义 成 静态 的 ， 以 便 两 个 方法 都 能 访问 相同 的 对 象 ， 但 更 好 的 解决 方案 是 采 
用 IAsyncResult 输 入 参数 。 

IAsyncResult 输入 参数 被 传人 了 AsyncCallback 委 托 目 标 中 ， 它 实际 上 是 定义 在 System. 
Runtime.Remoting.Messaging 命 名 空间 下 的 AsyncResult 类 ( 注意 : 没有 前 级 “I” ) 的 一 个 实例 。 该 类 
的 只 读 属 性 AsyncDelegate 返 回 了 别处 创建 的 原始 异步 委托 的 引用 。 

因此 ， 如 果 想 获取 对 分 配 在 Main() 中 的 Binary0p 委 托 对 象 的 引用 ， 只 需 把 由 AsyncDelegate 属 性 返 
回 的 System.0bject 类 型 转换 成 Binary0p 类 型 就 可 以 了 。 这 时 ， 终 于 可 以 触发 EndInvoke() 方 法 了 : 


// 不 要 忘记 导入 System.Runtime.Remoting.Messaging 
static void AddComplete(IAsyncResult itfAR) 
{ 
Console.WritelLine("AddComplete() invoked on thread {0}.", 
Thread.CurrentThread.ManagedThreadId); 
Console.WriteLine("Your addition is complete"); 


// 现在 得 到 结果 

AsyncResult ar = (AsyncResult)itfAR; 

BinaryOp b = (BinaryOp)ar.AsyncDelegate; 
Console.WriteLine("10 + 10 is {0}.", b.EndInvoke(itfAR)); 
isDone = true; 


} 


19.4.4 ”传递 和 接收 自 定义 状态 数据 
异步 委托 的 最 后 一 个 需要 关注 的 地 方 是 BeginInvoke() 方 法 的 最 后 一 个 参数 ( 默认 为 null1 )。 该 参 
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数 允许 从 主线 程 传递 额外 的 状态 信息 给 回调 方法 。 因 为 这 个 参数 类 型 是 system.0bject，, 所 以 可 以 传人 
任何 回调 方法 所 希望 的 类 型 的 数据 。 在 下 面 的 示例 中 ， 主 线程 将 向 AddComplete() 方 法 传人 一 个 自 定义 
的 文本 消息 : 


static void Main(string[] args) 


“IAsyncResult iftAR = b.BeginInvoke(10, 10, 
new AsyncCallback(AddComplete), 
"Main() thanks you for adding these numbers."); 


权 
为 了 在 AddComplete() 中 获得 数据 ， 使 用 传人 IAsyncResult 人 参数 的 AsyncState 属 性 。 注 意 ， 这 里 会 
要 求 显 式 强制 转换 ， 因 此 ， 主 线程 和 次 线程 必须 认同 由 AsyncSstate 返 回 的 实际 类 型 。 
static void AddComplete(IAsyncResult itfAR) 
{ 


// 获取 消息 对 象 ， 并 转换 成 string 
string msg = (string)itfAR.AsyncState; 
Console.WritelLine(msg); 

isDone = true; 


} 
下 面 显示 了 当前 程序 的 输出 结果 : 


***** AsyncCallbackDelegate Example ***** 
Main() invoked on thread 1. 

Add() invoked on thread 3. 

Working.... 

Working.... 

Working.... 

Working.... 

Working.... 

AddComplete() invoked on thread 3. 

Your addition is complete 

10 + 10 is 20. 

Main() thanks you for adding these numbers. 





我 们 已 经 理解 了 如 何 使 用 .NET 委 托 来 自动 创建 次 线程 以 处 理 异 步 方 法 调用 , 接 下 来 , 讨论 如 何 用 
System.Threading 命 名 空间 与 线程 进行 交互 。 记 住 ， 它 是 从 .NET 1.0 就 存在 的 最 早 的 线程 API。 


源 代码 ”AsyncCallbackDelegate 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.5 System.Threading 命名 空间 


在 .NET 平 台 下 ，System.Threading 命 名 空间 提供 了 许多 类 型 用 来 构建 多 线程 应 用 程序 。 除 了 和 特 
殊 的 CLR 线 程 进行 交互 的 类 型 外 ， 这 个 命名 空间 还 定义 了 许多 其 他 类 型 ， 这 些 类 型 允许 访问 CLR 维 护 


的 线程 池 、 一 个 简单 〈 无 界面 的 
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) Timer 类 ， 以 及 大 量 用 来 同步 访问 共享 资源 的 类 型 。 表 19-1 列 出 了 该 


命名 空间 中 的 重要 成 员 。( 务必 参考 NET Framework 4.5 SDK 文 档 以 得 到 细节 描述 。 ) 


表 19- 
类 型 


1 System.Threading 命 名 空间 中 的 部 分 类 型 
作 用 





Interlocked 


Monitor 


Mutex 
ParameterizedThreadStart 
Semaphore 


Thread 


ThreadPool 
Threadpriority 
ThreadStart 


ThreadState 
Timer 


TimerCallback 


为 被 多 个 线程 共享 访问 的 类 型 提供 原子 操作 

使 用 锁定 和 等 待 信号 来 同步 线程 对 象 。C# 的 lock 关 键 字 在 后 台 使 用 的 就 是 
Monitor 对 象 

互 斥 体 ， 可 用 于 应 用 程序 域 边界 之 间 的 同步 

委托 ， 它 允许 线程 调用 包含 任意 多 个 参数 的 方法 

用 于 限制 对 一 个 资源 或 一 类 资源 的 并 发 访问 的 线程 数量 

代表 CLR 中 执行 的 线程 。 使 用 这 个 类 型 ， 能 够 在 初始 的 应 用 程序 域 中 创建 额外 的 
线程 

用 于 和 一 个 进程 中 的 ( 由 CLR 维 护 的 ) 线程 池 交 互 

代表 了 线程 调度 的 优先 级 别 ( Highest、Normal 等 ) 

该 委托 用 于 定义 一 个 线程 所 调用 的 方法 。 和 ParameterizedThreadStart 委 托 不 同 ， 
这 个 方法 的 目标 必须 符合 一 种 固定 的 原型 

代表 线程 处 于 的 状态 ( Running 、Aborted 等 ) 

提供 以 指定 的 时 间 间 隔 执行 方法 的 机 制 

该 委托 类 型 应 与 Timer 类 型 一 起 使 用 
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System.Threading 命 名 空间 


中 最 基本 的 类 型 是 Thread。 它 是 一 个 面向 对 象 的 包装 器 ， 包 装 特定 
Thread 类 型 中 定义 了 许多 方法 〈 包 括 静 态 的 和 共享 的 ) ， 使 用 这 些 


方法 能 够 在 当前 应 用 程序 域 中 创建 、 挂 起 、 停 止 和 销毁 线程 。 表 19-2 列 出 了 Thread 类 的 核心 静态 


应 用 程序 域 中 的 某 个 执行 单元 。 
成 员 。 
CurrentContext 
CurrentThread 


GetDomain() 和 和 GetDomainID() 
Sleep() 


表 19-2 Thread 类 型 的 主要 静态 成 员 
作 用 
只 读 属性 ， 返 回 当 前 线程 的 上 下 文 
只 读 属性 ， 返 回 当 前 线程 的 引用 
返回 当前 应 用 程序 域 的 引用 或 当前 线程 正在 运行 的 域 的 ID 
将 当前 线程 挂 起 指定 的 时 间 


Thread 类 也 支持 部 分 实例 级 的 成 员 ， 表 19-3 中 列 出 了 其 中 的 一 部 分 。 
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表 19-3 ”线程 类 型 的 主要 实例 级 成 员 





实例 级 成 员 作 用 

IsAlive 返回 布尔 值 ， 指 示 线 程 是 否 开 始 了 

IsBackground 获取 或 设置 一 个 值 ， 指 示 线 程 是 否 为 后 台 线 程 (后 面 有 详细 说 明 ) 
Name 给 线程 指定 的 友好 的 名 字 

priority 获取 或 设置 线程 的 调度 优先 级 。 它 是 ThreadPriority 枚 举 中 的 值 之 一 
ThreadState 获取 当前 线程 的 状态 。 它 是 ThreadState 枚 举 中 的 值 之 一 

Abort() 通知 CLR 尽 快 终止 本 线程 

Interrupt() 中 断 当 前 线程 ， 唤 醒 处 于 等 待 中 的 线程 

Join() 阻塞 调用 线程 ， 直 到 某 个 ( 调用 Join() 的 ) 线程 终止 为 上 
Resume() 使 已 挂 起 的 线程 继续 执行 

Start() 通知 CLR 尽 快 执 行 本 线程 

Suspend() 挂 起 当前 线程 ， 如 果 线 程 已 挂 起 ， 调 用 Suspend() 则 不 起 作用 


说 明 终止 或 挂 起 活动 线程 通常 不 是 一 个 好 主意 。 这 样 可 能 ( 当然， 可 能 性 很 小 ) 会 导致 线程 在 受 
到 扰乱 或 终止 时 “泄露 ”工作 量 。 


19.6.1 获得 当前 执行 线程 的 统计 信息 


回想 一 下 ， 可 执行 程序 集 的 入口 点 ( 即 Main() 方 法 ) 是 运行 在 主线 程 上 的 。 为 举例 说 明 Thread 类 
型 的 基本 用 法 ， 假定 有 一 个 新 的 名 为 ThreadStats 的 控制 台 程 序 。 如 读者 所 知 ， 静 态 的 
Thread.CurrentThread 属 性 找到 表示 当前 正在 执行 线程 的 Thread 对 象 。 一 旦 获得 了 当前 线程 ， 便 能 够 输 
出 各 种 统计 信息 。 如 下 所 示 : 


// 确认 引入 System.Threading 命 名 空间 
static void Main(string[] args) 


Console.WriteLine("***** primary Thread stats *****\n"); 


// 获取 当前 线程 的 名 字 
Thread primaryThread = Thread.CurrentThread; 
primaryThread.Name = "ThePrimaryThread"; 


// 显示 承载 的 应 用 程序 域 和 上 下 文 的 详细 信息 

Console.WriteLine("Name of current AppDomain: {0}", 
Thread.GetDomain().FriendlyName); 

Console.WriteLine("ID of current Context: {0}", 
Thread.CurrentContext.ContextID); 


// 输出 线程 的 一 些 信 息 

Console.WriteLine("Thread Name: {0}", 
primaryThread.Name); 

Console.WriteLine("Has thread started?: {0}", 
primaryThread.IsAlive); 

Console.WriteLine("Priority Level: {0}", 
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primaryThread.Priority); 
Console.WritelLine("Thread State: {0}", 

primaryThread.ThreadSstate) ; 
Console.ReadLine(); 


} 
下 面 显示 了 这 个 程序 的 输出 结果 : 





******* primary Thread stats ***** 


Name of current AppDomain: ThreadStats.exe 
ID of current Context: 0 

Thread Name: ThePrimaryThread 

Has thread started?: True 

Priority Level: Normal 

Thread State: Running 





19.6.2 Name 属性 


虽然 上 述 代码 或 多 或 少 有 自 描 述 的 性 质 ， 但 是 请 注意 Thread 类 支持 Name 属 性 。 如 果 没 有 设置 这 个 
值 的 话 , Name 将 返回 一 个 空 的 字符 串 。 然而 , 一 旦 为 一 个 给 定 的 线程 对 象 指 定 一 个 友好 的 字符 串 名 字 ， 
在 调试 的 时 候 就 简单 多 了 。 如 果 使 用 Visual Studio， 可 以 在 调试 的 时 候 访 问 Threads 窗 口 ( 在 菜单 上 选 
择 Debug 一 Windows 一 Threads )。 如 图 19-1 所 示 ， 能 够 很 容易 地 找到 想 调 试 的 线程 。 


2 FIREADS :et 2 ee a ee vmx 
Search: ~ X SearchCallStack | 村 - ， | Group bw ProcessID -~ Columns" “ 
ID Managed ID Category Name Lecation Priority 

~ Process iD: 4880 (6 threads) 
3644 0 WB Worker Thread <No Name> “not sv aiialle> Highest 
4924 ee Worker Thread <Ne Name> | Znot avaiiable> Normal 


ee Worker Thread <No Name> | <not available> | Normal 


ee Worker Thread vshost.RunparkingWindow ‘x [Managed to Native Transition] | Normal | 
a Worker Thread ‘NET SystemEvents v [Managed to Native Transition] Normal 
2 Wain Thread ‘ThePrimarylhread ^ ThreadStats,Program.Main Normal 
入 ThreadStats.exe! ThreadStats,.Pre 





图 19-1 在 Visual Studio 中 调试 线程 


19.6.3 ”Priority 属 性 


接 下 来 ， 注 意 Thread 类 型 定义 了 一 个 名 为 Priority 的 属性 ， 默 认 情况 下 ， 所 有 线程 的 优先 级 都 处 
于 Normal 级 别 。 但 是 ， 在 线程 生命 周期 的 任何 时 候 ， 都 可 以 使 用 ThreadPriority 属 性 修改 线程 的 优先 
级 ， 且 修改 的 值 必须 是 System.Threading.ThreadPriority 枚 举 中 的 一 个 ， 如 下 所 示 : 


public enum ThreadPriority 


{ 
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Lowest， 
BelowNormal, 
Normal， // 默认 值 
AboveNormal, 
Highest 


如 果 给 线程 的 优先 级 指定 一 个 非 默 认 值 ( 默认 值 为 ThreadPriority.Normal ) ， 应 当知 道 这 并 不 能 
控制 线程 调度 器 切换 线程 的 过 程 。 实 际 上 ， 一 个 线程 的 优先 级 仅仅 是 把 线程 活动 的 重要 程度 提供 给 
CLR。 因 此 ， 一 个 带 有 ThreadPriority.Highest 优 先 级 的 线程 并 不 一 定 保证 能 得 到 最 高 的 优先 级 。 

此 外 ， 如 果 线 程 调度 器 被 某 个 任务 ( 比如 同步 对 象 、 切 换 线程 或 线程 移动 ) 抢占 了 ， 那 么 线程 的 
优先 级 别 很 有 可 能 因此 会 被 修改 。 这 个 时 候 ，CLR 将 会 读 取 这 些 值 ， 并 指示 线程 调度 器 如 何 最 好 地 分 
配 时 间 片 。 总 地 来 说 ， 有 着 相同 优先 调度 级 别 的 线程 应 当 得 到 相同 数量 的 时 间 来 执行 任务 。 

大 多 数 情况 下 ， 我们 几乎 不 需要 直接 来 改变 线程 的 优先 级 别 。 理 论 上 ， 提 高 一 些 线程 的 优先 级 别 
会 阻止 那些 低 优先 级 别 的 线程 执行 任务 ( 所 以 需要 小 心 使 用 ) 。 


源 代码 ”ThreadStats 项 目的 源 代 码 位 于 Chapter 19 子 目录 下 。 


19.7 手工 创建 次 线程 


当 希 望 以 编程 方式 创建 次 线程 以 分 担 一 些 工作 单元 时 , 在 使 用 System.Threading 命 名 空间 下 的 类 
型 时 可 以 遵从 下 面 预定 的 步骤 。 

(1) 创建 一 个 方法 作为 新 线程 的 入口 点 。 

(2) 创建 一 个 ParameterizedThreadStart (或 者 ThreadStart ) 委托 ， 并 把 在 上 一 步 所 定义 方法 的 地 
址 传 给 委托 的 构造 函数 。 

(3) 创建 一 个 Thread 对 象 ， 并 把 ParameterizedThreadStart 或 ThreadStart 委 托 作 为 构造 函数 的 参数 。 

(4) 建立 任意 初始 化 线程 的 特性 ( 名 称 、 优 先 级 等 ) 。 

(5) 调用 Thread.Start() 方 法 。 在 第 (2) 个 步骤 中 建立 的 委托 所 指向 的 方法 将 在 线程 中 尽快 开始 执行 。 

按 步 又 (2) 的 规定 , 可 以 使 用 两 种 不 同 的 委托 类 型 指向 调用 将 在 次 线程 中 执行 的 方法 。Threadstart 
委托 指向 一 个 没有 参数 、 无 返回 值 的 方法 。 这 个 委托 在 一 个 方法 被 设计 用 来 仅仅 在 后 台 运行 、 而 没有 
更 多 的 交互 时 非常 有 用 。 

很 明显 ，Threadstart 的 局 限 是 用 户 无 法 给 过 程 传递 参数 。 但 是 ParameterizedThreadstart 委 托 类 
型 允许 包含 一 个 System.0bject 类 型 的 参数 。 由 于 任何 对 象 都 源 于 System.0bject, 所 以 可 以 通过 一 个 自 
定义 的 类 或 结构 来 传递 任意 数量 的 参数 "。 但 需要 注意 的 是 ，pParameterizedThreadStart 委 托 仅仅 指向 
无 返回 值 的 方法 。 


19.7.1 使 用 ThreadStart 委 托 
举例 说 明 构 建 多 线程 程序 的 过 程 ( 同时 也 是 展示 这 样 做 的 好 处 ) ， 假 定 有 一 个 控制 台 程序 





GD 即 可 以 自 定义 一 个 类 /结构 ， 这 个 类 /结构 包含 了 所 有 的 参数 。 一 一 译 者 注 
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( SimpleMultiThreadApp ) ， 它 能 够 让 用 户 选 择 是 采用 单线 程 还 是 两 个 分 离 的 线程 来 执行 任务 。 

假定 已 经 引入 了 System.Threading 命 名 空间 ， 首 先 需要 定义 一 个 方法 ， 它 〈 可 能 ) 在 次 线程 执行 
任务 。 关 注 多 线程 程序 的 构建 机 制 ， 这 个 方法 仅仅 在 控制 台 窗 口上 按 顺 序 循环 输出 一 些 数字 ， 每 一 次 19 
循环 大 概 和 暂停 两 秒 钟 。 下 面 是 Printer 类 完整 的 定义 : 


public class Printer 
public void PrintNumbers() 


// 显示 Thread 信 息 
Console.WritelLine("-> {0} is executing PrintNumbers()", 
Thread.CurrentThread.Name); 


// 输出 数字 
Console.Write("Your numbers: "); 
for(int i = 0; i < 10; i++) 


Console.Write("{0}, ", i); 
Thread.Sleep(2000); 


Console.WritelLine(); 


} 
} 


在 Main() 方 法 中 ， 首 先 要 提示 用 户 ， 让 他 来 确定 是 用 一 个 还 是 两 个 线程 来 执行 任务 。 如 果 用 户 需 
要 一 个 单独 线程 ， 那 么 在 主线 程 上 调用 PrintNumbers() 方 法 就 可 以 了 。 但 是 ， 如 果 用 户 指定 需要 两 个 
线程 ， 那 么 创建 一 个 指向 PrintNumbers() 方 法 的 Threadstart 委 托 ， 接 着 把 这 个 委托 对 象 传 给 一 个 新 创 
建 的 Thread 对 象 的 构造 函数 ， 并 且 调 用 这 个 Thread 对 象 的 Start() 方 法 以 通知 CLR: 线程 已 经 准备 好 执 
和 了 。 

首先 ,添加 System.Nindows.Forms.dl]1 程 序 集 引 用 和 System.Windows.Forms 命 名 空间 , 并 且 在 Main() 
中 使 用 MessageBox.Show() 显 示 一 条 消息 (一 旦 运行 程序 ， 就 能 看 到 它 执行 到 什么 地 方 ) 。 下 面 是 完整 
的 Main() 方 法 : 

static void Main(string[] args) 

Console.WriteLine("***** The Amazing Thread App *****\n"); 


Console.Write("Do you want [1] or [2] threads? "); 
string threadCount = Console.ReadLine(); 


// 命名 当前 线程 
Thread primaryThread = Thread.CurrentThread; 
primaryThread.Name = "Primary"; 


// 显示 线程 的 信息 


Console.WriteLine("-> {0} is executing Main()", 
Thread.CurrentThread.Name); 


// 创建 执行 任务 的 类 


Printer p = new Printer(); 
switch(threadCount) 


Case "2": 
// 设置 线程 
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Thread backgroundThread = 
new Thread(new ThreadStart(p.PrintNumbers)); 
backgroundThread.Name = "Secondary"; 
backgroundThread. Start(); 
break; 
case "1": 
p.PrintNumbers(); 
break; 


default: 
Console.WriteLine("I don't know what you want...you get 1 thread."); 


goto case "1"; 


// 做 其 他 一 些 工作 
MessageBox.Show("I'm busy!", "Work on main thread..."); 
} Console.ReadLine(); 
如 果 以 单线 程 运行 这 个 程序 ， 将 发 现 直 到 全 部 的 数字 输出 到 了 控制 台 上 后 ,消息 (对话 框 ) 才 被 
显示 出 来 。 由 于 在 每 个 数字 输出 来 后 都 需要 暂停 大 概 两 秒 钟 ， 所 以 这 是 一 种 非常 糟糕 的 用 户 体 验 。 然 


而 ， 如 果 选 择 两 个 线程 ， 消 息 对 话 框 就 会 立刻 显示 出 来 ， 因 为 单独 的 Thread 对 象 负责 将 数字 输出 到 控 
制 台 上 (如 图 19-2 所 示 )。 


EB C\Windows\system32\cmd.exe 
Mxxn The Amazing Thread 月 DID xx 


Do you want [1] or [2] threade? 2 
-> imary is sse 全 Main< 
n 





-> Secondary is et g BI tNunbersc> 


Nour numbers: 8 

















图 19-2 ”多 线程 应 用 程序 提供 更 多 客户 响应 


源 代 码 ”SimpleMultiThreadApp 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.7.2 ”使 用 ParameterizedThreadStart 委托 


回想 一 下 ，ThreadStart 委 托 仅仅 指向 无 返回 值 、 无 参数 的 方法 。 虽 然 这 能 满足 大 多 数 情 况 下 的 要 
求 ， 但 是 ， 如 果 想 把 数据 传递 给 在 次 线程 上 执行 的 方法 ， 则 需要 使 用 ParameterizedThreadSstart 委 托 
类 型 。 在 下 面 的 例子 中 ， 本 章 前 面 已 经 建立 了 AsyncCallbackDelegate 项 目 ， 我 们 将 在 此 之 上 重新 建立 
逻辑 ， 这 一 次 使 用 ParameterizedThreadStart 委 托 类 型 。 
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首先 ， 创 建 一 个 名 为 AddwithThreads 的 控制 台 程序 ， 并 引入 System.Threading 命 名 空间 。 由 于 
ParameterizedThreadStart 能 够 指向 任意 带 一 个 System.0bject 参 数 的 方法 ， 所 以 要 创建 一 个 自 定义 类 


型 ， 这 个 类 型 包含 要 增加 的 数字 ， 如 下 所 示 : 


class AddParams 
public int a, b; 
public AddParams(int numb1, int numb2) 


numb1; 
numb2; 


a 
b 
} 

} 


接 下 来 ， 在 Program 类 中 创建 一 个 静态 方法 ， 这 个 方法 使 用 AddParams 类 型 作为 参数 ， 用 于 输出 每 
次 相 加 的 结果 ， 如 下 所 示 : 


static void Add(object data) 
if (data is AddParams ) 


Console.WriteLine("ID of thread in Add(): {0}", 
Thread.CurrentThread.ManagedThreadId); 


AddParams ap = (AddParams)data; 
Console.WritelLine("{0} + {1} is {2}", 
ap.a, ap.b, ap.a + ap.b); 
} 
Main() 中 的 代码 直截了当 ,使 用 ParameterizedThreadStart 比 使 用 Threadstart 更 加 简单 ,如 下 所 示 : 


static void Main(string[] args) 


Console.WriteLine("***** Adding with Thread objects 汪 寂 相生 
Console.WriteLine("ID of thread in Main(): {0}", 
Thread.CurrentThread.ManagedThreadId); 


// 建立 AddParams 对 象 ， 将 其 传 给 次 线程 

AddParams ap = new AddParams(10, 10); 

Thread t = new Thread(new ParameterizedThreadStart(Add)); 
t.Start(ap); 


// 强制 等 待 以 让 其 他 线程 结 
Thread. Sleep(5); 


Console.ReadLine(); 


19.7.3 ”AutoResetEvent 类 


在 之 前 的 示例 中 ,我 们 使 用 了 一 种 简陋 的 方式 来 通知 主线 程 等 待 ， 直 到 次 线程 结束 。 在 学 习 异步 
委托 时 ， 我 们 使 用 了 一 个 简单 的 boo1 变 量 作为 开关 ， 但 这 并 不 是 推荐 的 解决 方案 ， 因 为 两 个 线程 都 能 
访问 相同 的 数据 点 ， 并 且 这 将 导致 数据 损坏 , ( data corruption )。 一 个 较 安 全 但 仍然 不 可 取 的 方法 是 调 
用 Thread.Sleep()， 等 待 一 段 固定 的 时 间 。 但 问题 是 你 并 不 想 等 待 过 长 的 时 间 。 
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一 个 简单 、 线 程 安全 的 方法 是 使 用 AutoResetEvent 类 ， 强 制 线程 等 待 ， 直 到 其 他 线程 结束 。 在 需 
要 等 待 的 线程 中 ( 如 Main() 方 法 ),， 创建 该 类 的 实例 ， 向 构造 函数 传人 false， 表 示 尚 未 收 到 通知 。 然 
后 在 需要 等 待 的 地 方 调用 Waitone() 方 法 。 以 下 是 修改 后 的 Program 类 ， 它 使 用 静态 的 AutoResetEvent 
成 员 变 量 进行 这 些 处 理 : 
class Program 
private static AutoResetEvent waitHandle = new AutoResetEvent(false); 
static void Main(string[] args) 


Console.Writeline("***** Adding with Thread objects *****"); 

Console.WriteLine("ID of thread in Main(): {0}", 
Thread.CurrentThread.ManagedThreadId); 

AddParams ap = new AddParams(10, 10); 

Thread t = new Thread(new ParameterizedThreadStart(Add)); 

t.Start(ap); 


// 等 待 ， 直 到 收 到 通知 
waitHandle.WaitOne(); 
Console.WriteLine("Other thread is done!"); 


Console.ReadLine(); 


当 其 他 线程 完成 任务 时 ， 将 调用 同一 个 AutoResetEvent 类 型 实例 的 Set() 方 法 : 
static void Add(object data) 
if (data is AddParams) 


Console.WritelLine("ID of thread in Add(): {0}", 
Thread.CurrentThread.ManagedThreadId); 


AddParams ap = (AddParams)data; 
Console.WritelLine("{0} + {1} is {2}", 
ap.a, ap.b, ap.a + ap.b); 


// 通知 其 他 线程 ， 该 线程 已 结束 
waitHandle.Set(); 





源 代码 AddWithThreads 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 





19.7.4 前 台 线 程 和 后 台 线 程 


了 解 如 何 使 用 System. Threading 命 名 安 s 间 创建 新 的 线程 之 后 ， 下 面 来 正式 看 一 看 前 台 线 程 和 后 台 
ea 
口 前 台 线 程 能 阻止 应 用 程序 的 终结 。 一 直到 所 有 的 前 台 线 程 终止 后 ，CLR 才 能 关闭 应 用 程序 ( 即 
印 载 承载 的 应 用 程序 域 ) 。 
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口 后 台 线 程 (有 时 也 叫 守护 线程 ，daemon thread ) 被 CLR 认 为 是 程序 执行 中 可 做 出 牺牲 的 途径 ， 
即 在 任何 时 候 ( 即使 这 个 线程 此 时 正在 执行 某 项 工作 ) 都 可 能 被 忽略 。 因 此 ， 如 果 所 有 的 前 
台 线 程 终 止 ， 当 应 用 程序 域 印 载 时 ， 所 有 的 后 台 线程 也 会 被 自动 终止 。 
值得 重点 注意 的 是 ， 前 台 线 程 和 后 台 线程 并 不 等 同 于 主线 程 和 工作 者 线程 。 默 认 情 况 下 ， 所 有 通 
过 Thread.Start() 方 法 创建 的 线程 都 自动 成 为 前 台 线 程 。 这 意味 着 ， 直 到 所 有 的 线程 本 身 单元 的 工作 
都 执行 完成 了 ， 应 用 程序 域 才 会 卸载 。 大 多 情况 下 ， 这 非常 有 必要 。 
但 是 ， 反 过 来 设想 一 下 ,假定 在 一 个 后 台 线 程 上 调用 Printer.PrintNumbers()， 这 意味 着 ,该 方 
法 通过 Thread 类 型 ( ThreadStart 或 ParameterizedThreadStart 委 托 ) 可 以 被 安全 地 结束 ， 而 此 时 所 有 
的 前 台 线 程 可 以 做 它们 自己 的 工作 。 只 要 把 IsBackground 属 性 设 为 true 就 可 以 将 线程 配置 为 后 台 线 程 : 


static void Main(string[] args) 
Console.Writeline("***** Background Threads *****\n"); 


Printer p = new Printer(); 
Thread bgroundThread = 
new Thread(new ThreadStart(p.PrintNumbers)); 
// 这 是 后 台 线 程 
bgroundThread.IsBackground = true; 
bgroundThread. Start(); 
} 


请 注意 ，Main() 方 法 中 没有 Console.ReadLine() 这 条 语句 ( 该 条 语句 能 够 保证 在 按 Enter 键 之 前 ， 
控制 台 窗 口 始终 可 见 ) 。 因 此 ， 由 于 Thread 对 象 被 定义 成 后 台 线程 ， 当 程序 一 运行 就 立即 结束 了 。 由 
于 Main() 方 法 触发 建立 主 前 台 线程 ， 所 以 一 旦 Main() 执 行 完 毕 ， 应 用 程序 域 将 会 在 次 线程 结束 自身 工 
作 之 前 印 载 。 

但 是 ， 如 果 注 释 掉 设置 IsBackground 属 性 的 那 行 语句 ， 所 有 数字 都 会 被 输出 来 ， 这 是 因为 ， 在 应 
用 程序 域 从 所 承载 的 进程 中 印 载 之 前 ， 所 有 的 前 台 线 程 必须 将 它们 的 任务 执行 完成 。 

多 数 情况 下 ， 当 程序 的 主任 务 完成 ， 而 工作 者 线程 正在 执行 无 关 紧 要 的 任务 时 ， 把 工作 线程 配置 
成 后 台 类 型 是 很 有 用 的 。 例 如 ， 构 建 一 个 每 隔 几 分 钟 就 ping 一 次 邮件 服务 器 看 有 没有 新 邮件 的 应 用 程 
序 ， 或 更 新 当前 天 气 条 件 等 其 他 无 关 紧 要 的 任务 。 
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在 构建 多 线程 应 用 程序 时 ， 需 要 确保 任何 共享 数据 都 处 于 被 保护 状态 ， 以 防止 多 个 线程 修改 它 的 
值 。 由 于 一 个 应 用 程序 域 中 的 所 有 线程 都 能 够 并 发 访问 共享 数据 ， 所 以 ， 想 象 一 下 当 它 们 正在 访问 其 
中 的 某 个 数据 项 时 ， 会 发 生 什 么 。 由 于 线程 调度 器 会 随机 挂 起 线程 ， 所 以 如 果 线 程 A 在 完成 之 前 被 挂 
起 了 ， 线程 B 读 到 的 就 是 一 个 不 稳定 的 数据 。 

为 举例 说 明 并 发 的 问题 ， 构 建 一 个 名 为 MultiThreadedPrinting 的 C# 控 制 台 程序 ， 这 个 程序 使 用 了 
前 面 创建 的 Printer 类 ， 这 一 次 PrintNumbers() 方 法 将 暂停 每 个 线程 ， 时 间 由 随机 数 决 定 : 


public class Printer 


public void PrintNumbers() 
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for (int i = 0; i < 10; i++) 


{ 
// 使 线程 休眠 数秒 
Random r = new Random(); 
Thread.Sleep(1000 * r.Next(5)); 
Console.Write("{0}, ", i); 


Console.WriteLine(); 
} 
} 


Main() 方 法 负责 创建 一 个 拥有 10 个 (不 同名 称 的 ) Thread 对 象 的 数组 ， 并 且 每 一 个 对 象 都 调用 
Printer 对 象 的 同一 个 实例 ， 如 下 所 示 


class Program 
static void Main(string[] args) 
Console.Writeline("*****Synchronizing Threads *****\n"); 
Printer p = new Printer(); 


// 使 10 个 线程 全 部 指向 同一 对 象 的 同一 方法 
Thread[] threads = new Thread[10]; 
for (int i = 0; i < 10; i++) 


threads[i] = 
new Thread(new ThreadStart(p.PrintNumbers)); 
threads[i].Name = string.Format("Worker thread #{0}", i); 


// 现在 开始 每 一 个 线程 
foreach (Thread t in threads) 
tStartt)s 
Console.ReadLine(); 
} 
} 


在 看 运行 结果 之 前 ， 我 们 来 归纳 一 下 问题 : 在 应 用 程序 域 中 的 主线 程 产生 了 10 个 工作 者 线程 ,每 
一 个 工作 者 线程 执行 同一 个 Printer 实 例 的 PrintNumbers() 方 法 。 由 于 没有 预防 锁定 共享 资源 ( 控制 
台 ) ， 故 在 PrintNumbers() 输 出 到 控制 台 之 前 ， 调 用 PrintNumbers() 方 法 的 线程 很 有 可 能 会 被 挂 起 。 因 
为 不 知道 挂 起 什么 时 候 (或 者 是 否 有 ) 可 能 发 生 ， 所 以 我 们 得 到 的 是 不 可 预测 的 结果 。 比 如 ， 可 能 得 
到 下 面 的 输出 结果 : 





******Synchronizing Threads ** 六 * 闪 


-> Worker thread #1 is executing PrintNumbers() 

Your numbers: -> Worker thread #0 is executing PrintNumbers() 

-> Worker thread #2 is executing PrintNumbers() 

Your numbers: -> Worker thread #3 is executing PrintNumbers() 

Your numbers: -> Worker thread #4 is executing PrintNumbers() 

Your numbers: -> Worker thread #6 is executing PrintNumbers() 

Your numbers: -> Worker thread #7 is executing PrintNumbers() 

Your numbers: -> Worker thread #8 is executing PrintNumbers() 

Your numbers: -> Worker thread #9 is executing PrintNumbers() 

Your numbers: Your numbers: -> Worker thread #5 is executing PrintNumbers() 
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5 


2，4， 
1，0， 


5; 本 5 65 Gy 65 25 Ty 7 3 sy 8 95 
9，1， 


3，2，3，3，9， 
9， 
6， 3， 6， 7， 4， 7， 6， 8， 7， 4， 8， 5， 5， 6， 6， 8， 7， 7， 9， 





现在 把 程序 运行 几 遍 。 下 面 显示 了 一 种 可 能 的 结果 (读者 的 运行 结果 可 能 明显 不 同 ) 。 





*****Synchronizing Threads 六 水 冰冰 


-> Worker thread #0 is executing PrintNumbers() 
-> Worker thread #1 is executing PrintNumbers() 
-> Worker thread #2 is executing PrintNumbers() 


Your 
Your 
Your 
Your 
Your 
Your 
Your 
Your 


numbers: -> Worker thread #4 is executing PrintNumbers() 

numbers: -> Worker thread #5 is executing PrintNumbers() 

numbers: Your numbers: -> Worker thread #6 is executing PrintNumbers() 
numbers: -> Worker thread #7 is executing PrintNumbers() 

numbers: Your numbers: -> Worker thread #8 is executing PrintNumbers() 
numbers: -> Worker thread #9 is executing PrintNumbers() 

numbers: -> Worker thread #3 is executing PrintNumbers() 

nimbers: 0, 0, 0 0 05 0; 0 05 0 0; Ss Ds Ds Ls Sy YL dy 


25 25 2 2 2 23 27 2y 33 Bs B33 39 3 3 33 3，3 3 4 4 4, 4 4 4, 4, 4s 4; 
4, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 6, 6, 6; 6, 6, 6, 6, 6, 6, 6, 7, 7, 7, 7, 7, 7 
，7, 7, 7, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 





说 明 如 果 ( 上面 例子 中 ) 无 法 得 到 随机 的 输出 ,请 把 线程 的 个 数 从 10 变 到 100, 或 调用 Thread.Sleep() 
方法 。 最 终 会 遇 到 并 发 的 问题 。 





显然 这 里 有 问题 。 当 每 个 线程 都 调用 Printer 来 输出 数字 的 时 候 ， 线 程 调度 器 可 能 正在 切换 线程 。 
这 导致 了 不 同 的 输出 结果 。 我 们 需要 找到 一 种 方式 来 通过 编程 控制 对 共享 资源 的 同步 访问 。 同 读者 猜 
想 的 一 样 ，System.Threading 命 名 空间 提供 了 一 些 以 同步 为 中 心 的 类 型 。C# 编 程 语言 也 提供 了 一 个 特 
别 的 关键 字 ， 它 能 在 多 线程 程序 中 同步 共享 数据 。 
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19.8.1 使 用 C# 的 lock 关 键 字 进行 同步 


同步 访问 共享 资源 的 首选 技术 是 C# 的 lock 关 键 字 。 这 个 关键 字 人 允许 定义 一 段 线程 同步 的 代码 语 
句 。 采 用 这 项 技术 ， 后 进入 的 线程 不 会 中 断 当 前 线程 ， 而 是 停止 自身 下 一 步 执行 。lock 关 键 字 需要 定 
义 一 个 标记 ( 即 一 个 对 象 引 用 ) ， 线 程 在 进入 锁定 范围 的 时 候 必 须 获 得 这 个 标记 。 当 试图 锁定 的 是 一 
个 实例 级 对 象 的 私有 方法 时 ， 使 用 方法 本 身 所 在 对 象 的 引用 就 可 以 了 ， 如 下 所 示 : 

private void SomePrivateMethod() 

// 使 用 当前 对 象 作 为 线程 标记 
lock(this) 
// 所 有 在 这 个 范围 内 的 代码 是 线程 安全 的 

} 

然而 , 如 果 需 要 锁定 公共 成 员 中 的 一 段 代码 , 比较 安全 ( 也 比较 推荐 ) 的 方式 是 声明 私有 的 object 
成 员 来 作为 锁 标 识 ， 如 下 所 示 : 

public class Printer 


// 锁 标 识 
private object threadLock = new object(); 


public void PrintNumbers() 


// 使 用 锁 标识 
lock (threadLock) 


ee 
} 
} 


如 果 分 析 PrintNumbers() 方 法 , 可 以 看 到 线程 强占 的 共享 资源 是 控制 台 窗口 , 因此 , 所 有 和 Console 
类 型 交互 的 代码 都 必须 在 锁定 范围 中 。 
public void PrintNumbers() 
// 使 用 私有 对 象 锁定 标记 
lock (threadLock) 
上 
// 显示 线程 信息 
Console.WriteLine("-> {0} is executing PrintNumbers()", 
Thread.CurrentThread.Name); 


// 输出 数字 

Console.Write("Your numbers: "); 

for (int 1 = 0 1 < 10; i144+) 
Random r = new Random(); 
Thread.Sleep(1000 * r.Next(5)); 
Console.Write("{0}, ", i); 


Console.WritelLine(); 
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现在 已 经 有 效 设计 了 一 个 保证 当前 线程 完成 任务 的 方法 。 一 旦 一 个 线程 进入 锁定 范围 ,在 它 退 出 
锁定 范围 且 释 放 锁 定之 前 ， 其 他 线程 将 无 法 访问 锁定 标记 ( 本 例 中 是 当前 对 象 的 引用 ) 。 因 此 ， 如 果 
线程 A 获 得 锁定 标记 ， 直 到 它 放弃 这 个 锁定 标记 ， 其 他 线程 才能 够 进入 锁定 范围 。 





说 明 如果 试图 锁定 静态 方法 中 的 代码 ， 只 需要 声明 一 个 私有 静态 对 象 成 员 变 量 作 为 锁定 标记 就 可 
及 了 


如 果 运 行 这 个 程序 ， 我 们 将 看 到 每 个 线程 都 能 够 完成 它们 的 相关 逻辑 ， 而 不 被 中 断 : 





******SynChronizing Threads 半 水 水 米 冰 


-> Worker thread #0 is executing PrintNumbers() 
Your numbers: O03 ls 27 3 的 Ss 6 7 8 95 
-> Worker thread #1 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #3 is executing PrintNumbers() 
Your numbers: 0, 1 2, 3; 4, 5, 6, 7, 8,. 9， 
-> Worker thread #2 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #4 is executing PrintNumbers() 
Your, nowbers: 0 Ls: 2 3 a Sy Gs Ti B53 
-> Worker thread #5 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #7 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #6 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #8 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
-> Worker thread #9 is executing PrintNumbers() 
Your numbers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 








源 代码 ”MultiThreadedPrinting 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.8.2 ”使 用 System.Threading.Monitor 类 型 进行 同步 


C# lock 声 明 实际 上 是 和 System.Threading.Monitor 类 一 同 使 用 时 的 速记 符号 。 经 过 编译 器 的 处 理 ， 
锁定 区 域 实际 上 被 转化 成 了 如 下 的 内 容 ( 可 以 使 用 ildasm.exe 进 行 验证 ) : 


public void PrintNumbers() 


Monitor.Enter(threadLock); 
try 


// 显示 线程 信息 
Console.WriteLine("-> {0} is executing PrintNumbers()", 
Thread.CurrentThread.Name); 
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// 输出 数字 
Console.Write("Your numbers: "); 
for (int i = 0; i < 10; i++) 


Random r = new Random(); 
Thread.Sleep(1000 * r.Next(5)); 
Console.Write("{0}, ", i); 


Console.WriteLine(); 

} 

finally 
Monitor.Exit(threadLock); 


} 

首先 , 请 注意 Monitor.Enter() 方 法 是 线程 标记 的 最 终 容器 ， 而 该 线程 标记 作为 参数 由 用 户 指定 给 
lock 关 键 字 。 接 下 来 ， 所 有 在 锁定 范围 中 的 代码 被 try 块 包含 。 而 对 应 的 finally 子 句 保 证 了 无 论 出 现 
什么 运行 错误 ， 线 程 标记 都 能 被 释放 ( 通过 Monitor.Exit() 方 法 )。 如 果 修 改 MultiThreadPrinting 程 序 
以 便 直接 使 用 Monitor 类 型 ( 像 上 面 显示 的 那样 )， 看 到 的 结果 是 一 样 的 。 

既然 使 用 lock 关 键 字 比 使 用 System.Threading.Monitor 类 型 的 代码 更 少 ， 那 么 直接 使 用 Monitor 类 
型 的 好 处 何在 ? 一 句 话 一 一 更 好 的 控制 能 力 。 使 用 Monitor 类 型 ， 可 以 (使 用 Monitor.Wait() 方 法 ) 指 
示 活 动 的 线程 等 待 一 段 时 间 , 在 当前 线程 完成 操作 时 ，( 使 用 Monitor.Pulse() 或 Monitor.PulseAll () ) 
通知 等 待 中 的 线程 。 

同 读者 预测 的 一 样 ， 在 大 多 数 情况 下 ，C# lock 关 键 字 就 够 用 了 。 如 果 对 Monitor 的 其 他 成 员 感 兴 
趣 的 话 ， 请 参考 .NET Framework 4.5 SDK 文 档 。 


19.8.3 ”使 用 System.Threading.Interlocked 类 型 进行 同步 


虽然 这 很 难 相信 , 但 如 果 看 了 底层 的 CIL 代 码 , 将 发 现 赋值 和 简单 的 数值 运算 都 不 是 原子 型 操作 。 
由 此 ，System.Threading 命 名 空间 提供 了 一 个 类 型 允许 我 们 来 原子 型 操作 单个 数据 ， 使 用 它 比 使 用 
Monitor 类 型 更 加 简单 。Interlocked 类 定义 如 表 19-4 所 示 的 静态 成 员 。 


表 19-4 System.Threading.Interlocked 类 型 的 部 分 静态 成 员 





成 员 作 用 

CompareExchange() 安全 地 比较 两 个 值 是 否 相 等 。 如 果 相 等 ， 将 第 3 个 值 与 其 中 1 个 值 交 换 
Decrement() 安全 递减 1 

Exchange() 安全 地 交换 数据 

Increment() 安全 递 加 1 


虽然 不 太 起 眼 , 但 是 原子 型 地 修改 单个 值 在 多 线程 环境 下 非常 普遍 。 假设 有 个 方法 名 为 Addone() 
它 用 来 给 名 为 intVval 的 整 型 变量 加 1， 写 出 如 下 的 同步 代码 : 
public void Addone() 


lock(myLockToken) 
{ 
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intVal++; 


} 

可 以 通过 静态 的 Interlocked.Increment() 方 法 简化 代码 ; 以 引用 方式 传人 要 递增 的 变量 。 注 意 ， 
Increment() 方 法 不 但 可 以 修改 传人 的 参数 值 ， 还 会 返回 递增 后 的 新 值 : 

public void Addone() 


int newVal = Interlocked.Increment(ref intVal); 


除了 Increment() 和 Decrement(), 使 用 Interlocked 类 型 还 可 以 原子 型 地 赋值 给 数字 或 对 象 。 例如 ， 
如 果 想 把 83 赋 给 一 个 成 员 变 量 ,无 须 明 确 使 用 lock 声 明 ( 或 Monitor 逻 辑 ), 使 用 Interlocked.Exchange() 
方法 就 可 以 了 ， 如 下 所 示 : 


public void SafeAssignment() 


Interlocked.Exchange(ref myInt, 83); 


最 后 ， 如 果 想 通过 在 线程 安全 的 情况 下 测试 两 个 值 是 否 相等 来 改变 比较 后 的 指向 ,可 以 像 下 面 这 
样 调用 Interlocked.CompareExchange() 方 法 : 
public void CompareAndExchange() 


{ 
// 如 果 i 等 于 83， 把 99 赋 给 i 
Interlocked.CompareExchange(ref i, 99, 83); 


19.8.4 使 用 [Synchronization] 特 性 进行 同步 


最 后 一 个 同步 化 原 语 是 [Synchronization] 特 性 。 它 位 于 System.Runtime.Remoting.Contexts 命 名 空 
间 下 。 这 个 类 级 别 的 特性 有 效 地 使 对 象 的 所 有 实例 的 成 员 都 保持 线程 安全 。 当 CLR 分 配 带 
[Synchronization] 的 对 象 时 ， 它 会 把 这 个 对 象 放 在 同步 上 下 文中 。 回 想 一 下 在 第 17 章 里 ， 要 想 对 象 不 
被 在 上 下 文 边界 中 移动 ， 就 必须 让 它 继 承 ContextBound0bject 类 。 因 此 ， 如 果 想 要 使 Printer 类 类 型 线 
程 安全 ( 在 类 成 员 中 不 使 用 明确 的 线程 安全 代码 )， 可 以 做 如 下 修改 : 


using System.Runtime.Remoting.Contexts; 


// Printer 的 全 部 方法 都 是 线程 安全 的 
[Synchronization] 
public class Printer : ContextBoundObject 


public void PrintNumbers() 


te 
} 


在 有 些 方面 ， 像 这 样 写 线程 安全 的 代码 是 一 种 “偷懒 的 ”方式 ， 因 为 它 不 需要 我 们 实际 深入 线程 
控制 敏感 数据 的 细节 。 这 种 方式 的 主要 问题 是 : 即使 一 个 方法 没有 使 用 线程 敏感 的 数据 ，CLR 仍 然 会 
锁定 对 该 方法 的 调用 。 很 明显 ， 这 会 全 面 降低 性 能 ， 所 以 要 小 心 使 用 这 种 方式 。 
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19.9 使 用 TimerCallback 编程 


许多 程序 需要 定期 调用 具体 的 方法 。 比 如 ， 可 能 有 一 个 应 用 程序 需要 在 状态 栏 上 通过 一 个 辅助 函 
数 显 示 当 前 的 时 间 ， 或者， 可 能 希望 应 用 程序 调用 一 个 辅助 函数 ， 让 它 经 常 执行 非 紧 迫 的 后 台 任 务 ， 
比如 检查 是 否 收 到 新 邮件 。 像 这 些 情况 ,就 可 以 使 用 System.Threading.Timer 类 型 和 与 其 相关 的 
TimerCallback 委 托 。 

为 举例 说 明 ， 设想 有 一 个 控制 台 应 用 程序 ( TimerApp )， 这 个 程序 每 隔 1 秒 把 当前 时 间 输 出 来 ， 直 
到 用 户 按键 中 断 这 个 程序 。 很 明显 , 第 一 步 我 们 要 写 这 个 输出 的 方法 , 这 个 方法 将 会 被 Timer 类 型 调用 
(确保 在 代码 文件 中 导入 了 System.Threading): 


class Program 
static void PrintTime(object state) 


Console.WriteLine("Time is: {0}", 
DateTime.Now.ToLongTimeString()); 


static void Main(string[] args) 
} 

} 

注意 PrintTime() 方 法 拥有 一 个 System.0bject 类 型 的 参数 并 且 返 回 void。 这 里 没有 其 他 的 选择 ， 
因为 TimerCallback 委 托 仅仅 调用 符合 这 样 的 签名 的 方法 。 传 人 TimerCallback 委 托 的 参数 可 以 是 任何 对 
象 类 型 ( 在 邮件 示例 程序 中 , 参数 可 能 表示 在 这 个 过 程 期 间 发 生 交互 的 Microsoft Exchange 服 务 器 的 名 
字 )。 还 需要 注意 的 是 , 由 于 这 个 参数 是 System.0bject 类 型 , 所 以 可 以 使 用 System.Array 或 者 自 定义 类 
/结构 传人 多 个 值 。 

下 一 步 ， 定 义 一 个 TimerCallback 委 托 实 例 ， 并 把 它 传人 Timer 对 象 中 。 除 了 定义 TimerCallback 委 
托 ，Timer 的 构造 函数 还 允许 定义 别 的 信息 传送 到 委托 指向 的 方法 中 : 一 个 可 选 参数 ( 定义 为 System. 
0bject 类 型 )、 访 问 时 间 间 隔 ， 以 及 在 第 一 次 调用 之 前 等 待 多 长 时 间 (以 毫秒 为 单位 )。 举 例如 下 : 

static void Main(string[] args) 


Console.WritelLine("***** Working with Timer type *****\n"); 


// 为 Timer 类 型 创建 委托 
TimerCallback timeCB = new TimerCallback(PrintTime); 


// 设置 Timer 类 
Timer t = new Timer( 
timeCB, // TimerCallback 委 托 对 象 
null, // 想 传 入 的 参数 (null 表 示 没 有 参数 ) 
0， // 在 开始 之 前 ， 等 待 多 长 时 间 (以 毫秒 为 单位 ) 
1000); // 每 次 调用 的 间隔 时 间 (以 毫秒 为 单位 ) 


Console.WriteLine( "Hit key to terminate..."); 
Console.ReadLine(); 
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本 例 中 ，PrintTime() 方 法 大 概 每 隔 一 秒 钟 调用 一 次 ， 并且 没 有 什么 信息 需要 传人 。 下 面 是 输出 





沙沙 冰 沙沙 Working with Timer type **** 闪 


Hit key to terminate... 
Time is: 6:51:48 PM 


Time is: 6:51:49 PM 
Time is: 6:51:50 PM 
Time is: 6:51:51 PM 


Time is: 6:51:52 PM 
Press any key to continue .. 





如 果 希 望 传递 一 些 信息 给 委托 指向 的 方法 ， 把 Timer 构 造 函 数 的 第 二 个 参数 用 指定 值 取 代 空 值 就 
可 以 了 ， 如 下 所 示 : 


// 设置 timer 类 
Timer t = new Timer(timeCB, "Hello From Main", 0, 1000); 


可 以 这 样 来 获得 传人 的 数据 : 
static void PrintTime(object state) 


Console.WriteLine("Time is: {0}, Param is: {1}", 
DateTime.Now.ToLongTimeString(), state.ToString()); 


源 代码 ”TimerApp 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.10 ”CLR 线程 池 


最 后 关于 线程 的 核心 主题 是 CLR 线 程 池 。 当 使 用 委托 类 型 ( 通过 BeginInvoke() 方 法 ) 进行 异步 方 
法 调用 的 时 候 ，CLR 并 不 会 创建 新 的 线程 。 为 了 取得 更 高 的 效率 ,委托 的 BeginInvoke() 方 法 创建 了 由 
运行 时 维护 的 工作 者 线程 池 。 为 了 更 好 地 和 这 些 线程 进行 交互 ，System.Threading 命 名 空间 提供 了 
ThreadPool 类 类 型 。 

如 果 想 使 用 池 中 的 工作 者 线程 排队 执行 一 个 方法 ， 可 以 使 用 ThreadPool1.QueueUserWorkItem() 方 
法 。 这 个 方法 进行 了 重 载 ， 除 了 可 以 传递 一 个 Waitcallback 委 托 之 外 还 可 以 指定 一 个 可 选 的 表示 自 定 
义 状态 数据 的 System.0bject: 


public static class ThreadPool 


public static bool QueueUserWorkItem(WaitCallback callBack); 
public static bool QueueUserWorkItem(WaitCallback callBack, 
object state); 


WaitCallback 委 托 指向 有 单个 System.0bject 类 型 的 参数 ( 代表 了 可 选 的 状态 数据 ) 且 无 返回 值 的 
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方法 。 注 意 ， 如 果 在 调用 QueueUserWorkItem() 时 不 提供 这 个 参数 ，CLR 会 自动 传送 null 值 。 为 举例 说 
明 CLR 线 程 池 中 使 用 的 队列 方法 , 仔细 思考 下 面 的 程序 。 它 再 次 使 用 了 前 面 的 Printer 类 型 , 但 是 , 在 
这 个 例子 中 ， 不 需要 手工 创建 Thread 对 象 数组 ， 只 要 把 线程 池 的 成 员 指向 PrintNumbers() 方 法 就 可 
以 了 。 
class Program 
static void Main(string[] args) 


Console.WriteLine("***** Fun with the CLR Thread Pool *****\n"); 


Console.WriteLine("Main thread started. ThreadID = {0}", 
Thread.CurrentThread.ManagedThreadId); 


Printer p = new Printer(); 
WaitCallback workItem = new WaitCallback(PrintTheNumbers); 
// 调用 这 个 方法 10 次 
for (int i = 0; i < 10; i++) 
ThreadPool .QueueUserWorkItem(workItem, p); 


Console.WriteLine("All tasks queued"); 
Console.ReadLine(); 


} 
static void PrintTheNumbers(object state) 


Printer task = (Printer)state; 
task.PrintNumbers(); 
} 
} 


现在 ,读者 可 能 想 知道 比 起 显 式 创建 Thread 对 象 ， 使 用 这 个 被 CLR 所 维护 的 线程 池 的 好 处 何在 。 
我 认为 使 用 线程 池 的 主要 好 处 是 : 
口 线程 池 减 少 了 线程 创建 、 开 始 和 停止 的 次 数 ， 而 这 提高 了 效率 ; 
口 使 用 线程 池 ， 能 够 使 我 们 将 注意 力 放 到 业务 逻辑 上 而 不 是 多 线程 架构 上 。 
然而 ， 在 某 些 情况 下 应 优先 使 用 手工 线程 管理 ， 具 体 如 下 。 
口 如 果 需 要 前 台 线 程 或 设置 优先 级 别 。 线 程 池 中 的 线程 总 是 后 台 线 程 ， 且 它 的 优先 级 是 默认 的 
( ThreadPriority.Normal )。 


口 如 果 需 要 有 一 个 带 有 固定 标识 的 线程 便于 退出 、 挂 起 或 通过 名 字 发 现 它 。 
源 代码 ”ThreadPoolApp 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


System.Threading 命 名 空间 的 学 习 至 此 告 一 段落 。 在 创建 多 线程 应 用 程序 时 ， 理 解 本 章 目 前 所 介 
绍 的 这 些 话题 ( 特别 是 并 行 问题 ) 绝对 是 非常 有 价值 的 。 有 了 这 些 基 础 ， 下 面 我 们 将 注意 力 转 到 一 些 
新 的 与 线程 相关 的 话题 ， 它 们 只 能 在 .NET 4.0 或 更 高 版 本 下 使 用 。 首 先 介绍 的 是 另 一 种 线程 模 
型 一 一 TPL。 
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19.11 使 用 任务 并 行 库 进 行 并 行 编程 


截至 目前 ， 本 章 介绍 了 两 种 构建 多 线程 软件 的 编程 技术 ( 使 用 异步 委托 或 通过 System.Threading 
的 成 员 )。 记 住 ， 这 两 种 方法 可 以 在 任何 版 本 的 .NET 平 台 下 工作 。 

从 .NET 4.0 开 始 ， 微 软 引 入 了 一 种 全 新 的 多 线程 应 用 程序 开发 方法 ， 即 使 用 TPL 并 行 编程 库 。 使 
用 System.Threading.Tasks 中 的 类 型 ， 可 以 构建 细 粒 度 的 、 可 扩展 的 并 行 代码 ， 而 不 必 直 接 与 线程 和 
线程 池 打 交道 。 

但 这 并 不 是 说 再 使 用 TPL 的 时 候 不 会 用 到 System.Threading。 实 际 上 ， 这 两 种 线程 工具 可 以 非常 
自然 地 一 起 工作 。 特别 是 因为 System.Threading 命 名 空间 还 提供 了 我 们 之 前 介绍 过 的 大 量 同步 基础 组 
件 (Monitor 、Interlocked 等 )。 也 就 是 说 ， 你 很 可 能 会 发 现 你 更 喜欢 使 用 TPL， 而 不 是 原始 的 
System.Threading 命 名 空间 ， 因 为 使 用 TPL， 同 样 的 任务 可 以 以 更 加 直接 的 方式 执行 。 


说 明 注意 ， 新 的 .NET 4.5 C# async 和 await 关 键 字 使 用 了 大 量 System.Threading.Tasks 命 名 空间 中 
的 成 员 。 


19.11.1 任务 并 行 库 API 


总 体 而 言 ，System.Threading.Tasks 中 的 类 型 被 称 为 任务 并 行 库 ( Task Parallel Library, TPL )。TPL 
使 用 CLR 线 程 池 自动 将 应 用 程序 的 工作 动态 分 配 到 可 用 的 CPU 中 。TPL 还 处 理工 作 分 区 、 线 程 调 度 、 
状态 管理 和 其 他 低级 别 的 细节 操作 。 最 终结 果 是 , 你 可 以 最 大 限度 地 提升 .NET 应 用 程序 的 性 能 ， 并且 
避免 直接 操作 线程 所 带 来 的 复杂 性 ( 如 图 19-3 所 示 )。 


Object Browser XxX A .C5 - 

Browse: My Solution = | i (ta 从 -~ 

<Search> ~ 让 
yin.Threading Tasks 





by ty Parallel 
b 33 ParallellL oopResutt 
b Wy parallelLoopState 
b sy ParalletlOptions 
by Task 
二 Task<TResult> 
b 0 TaskCanceledException 
b ty TaskCompletionSource< TResult> 
b 本 TaskContinuaticonOptions 
> 中 TaskCreationOptions 
by He TaskFactory 
b Hy TaskFactory< TResult> a 
bp Wy TaskScheduler 屿 
b Wy TaskSchedulerException | 
bp 曙 TaskStatus 3 
Ce UnobservedTaskExceptionEventArgs 
b sa System - 
« 


I i | 


namespace System.Threading.Tasks 
Member of mscorlib 


图 19-3 ”System.Threading.Tasks 命 名 空间 的 成 员 
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19.11.2 ”Parallel 类 的 作用 


TPL 中 一 个 十 分 重要 的 类 是 System.Threading.Tasks.Parallel， 它 提供 了 大 量 方法 ,能够 以 并 行 
的 方式 迭代 数据 集合 ( 实现 了 IEnumerable<T> 的 对 象 ), 在 .NET Framework 4.5 SDK 文 档 中 查看 Parallel 
类 ， 你 会 发 现 该 类 支持 两 个 主要 的 静态 方法 一 parallel.For() 和 Parallel.ForEach()， 每 个 方法 都 有 很 多 
重 载 版 本 。 

这 些 方法 可 用 于 编写 并 行 执行 的 代码 体 。 从 概念 上 说 ， 这 些 语句 的 逻辑 与 普通 循环 (使 用 for 或 
foreach 关 键 字 ) 中 的 逻辑 完全 相同 。 不 过 好 处 是 ，Parallel 类 将 从 线程 池 中 为 我 们 提取 线程 ( 和 管理 
并 发 )。 

这 两 个 方法 都 要 求 指 定 一 个 与 IEnumerable 或 IEnumerable<T> 兼 容 的 容器 ， 来 保存 需要 并 行 处 理 的 
数据 。 容 器 可 以 是 简单 的 数组 、 非 泛 型 集合 ( 如 ArrayList )、 泛 型 集合 ( 如 ListxT> ) 或 LINQ 查 询 的 
结果 。 

此 外 , 你 还 需要 使 用 System.Func<T> 和 System.ActioncT> 委 托 来 指定 要 调用 的 处 理 数据 的 方法 。 我 
们 在 第 12 章 中 介绍 LINQ to Object 时 已 经 学 习 了 FuncxT> 委 托 。 它 表示 一 个 拥有 给 定 返回 值 和 不 同 数量 
参数 的 方法 。Action<T> 委 托 与 Func<T> 类 似 ， 指 向 有 几 个 参数 的 方法 。 但 是 Action<T> 只 能 返回 void。 

尽管 在 调用 Parallel.For() 和 Parallel.ForEach() 方 法 时 可 以 传递 强 类 型 的 Funcx<T> 或 Action<T> 委 
托 对 象 ， 你 也 可 以 使 用 恰当 的 C# 匿 名 方法 或 Lambda 表 达 式 来 简化 编程 。 


19.11.3 ”使 用 paralle1 类 的 数据 并 行 


使 用 TPL 的 第 一 种 方式 是 执行 数据 并 行 ( data parallelism )。 简 单 地 说 ， 该 术语 是 指使 用 
Parallel.For() 或 Parallel.ForEach() 方 法 以 并 行 方 式 对 数组 或 集合 中 的 数据 进行 迭代 假设 需要 执行 
一 些 大 工作 量 的 文件 IO 操 作 。 如 需要 向 内 存 中 加 载 大 量 *.jpg 文 件 并 进行 翻转 , 然后 将 修改 后 的 图 像 数 
据 保 存 到 新 的 位 置 。 

.NET Framework 4.5 SDK 文 档 针 对 这 种 情形 提供 了 一 个 基于 控制 台 的 示例 ， 而 我 们 要 用 图 形 用 户 
界面 来 执行 相同 的 任务 ， 用 “匿名 委托 ”来 让 次 线程 更 新 主 用 户 界面 线程 ( 即 UI 线程 )。 


说 明 在 构建 多 线程 图 形 用 户 界面 (GUI ) 应 用 程序 时 ， 次 线程 永远 无 法 直接 访问 用 户 界 面 控件 。 原 
因 是 这 些 控件 ( 按钮、 文本 框 、 标 签 、 进 度 条 等 ) 与 创建 它们 的 线程 存在 线程 相关 性 。 在 下 
面 的 示例 中 ， 我 将 演示 一 种 让 次 线程 以 线程 安全 的 方式 访问 UI 项 的 途径 。 在 介绍 .NET 4.5 C# 
async 和 await 关 键 字 的 时 候 ， 你 还 将 看 到 更 简单 的 方法 。 


创建 一 个 Windows Forms 应 用 程序 DataParallelismWithForEach， 使 用 Solution Explorer 将 Forml.cs 
改名 为 MainForm.cs。 然 后 ， 在 主 代码 文件 中 引入 下 面 的 命名 空间 : 


// 确保 引入 下 面 这 些 命名 空间 
using System.Threading.Tasks; 
using System.Threading; 

using System.I0; 


该 应 用 程序 的 GUI 包含 一 个 多 行 的 TextBox 和 一 个 Button ( 名 为 btnProcessImages )。 当 任务 在 后 台 
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执行 时 ,你 可 以 向 文本 区 域 输入 数据 ， 以 此 来 演示 并 行 任务 的 无 阻塞 性 。 该 Button 的 Click 事 件 最 终 将 
使 用 TPL， 但 现在 先 使 用 下 面 的 阻塞 代码 。 


说 明 你 应 该 修改 传 入 给 Directory.GetFiles() 方 法 调用 的 字符 串 ， 让 它 指向 电脑 中 包含 图 片 文 件 
的 路 径 (如 存放 家 庭 照片 的 个 人 文件 夹 )。 这 里 我 只 指向 了 存放 在 Ci\Users\Public\ 
Pictures\Sample Pictures 下 的 一 些 图 片 。 





public partial class MainForm : Form 
public MainForm() 


InitializeComponent(); 


private void btnprocessImages Click(object sender, EventArgs e) 


ProcessFiles(); 


private void ProcessFiles() 


{ 
// 加 载 所 有 *.jpg 文 件 ， 并 为 修改 后 的 数据 新 建 一 个 文件 夹 
string[] files = Directory.GetFiles 
(@"C:\Users\Public\Pictures\Sample Pictures", "*.jpg", 
SearchOption.AllDirectories); 
string newDir = @"C:\Modifiedpictures"; 
Directory.CreateDirectory(newDir); 


// 以 阻塞 方式 处 理 图 像 数 据 
foreach (string currentFile in files) 


string filename = Path.GetFileName(currentFile); 
using (Bitmap bitmap = new Bitmap(currentFile)) 


bitmap.RotateFlip(RotateFlipType.Rotate180FlipNone); 
bitmap.Save(Path.Combine(newDir, filename)); 


// 打印 处 理 当前 图 像 的 线程 ID 
this.Text = string.Format("Processing {0} on thread {1}", filename, 
Thread.CurrentThread.ManagedThreadId); 
} 


} 
中 
} 


注意 ，ProcessFiles() 方 法 将 翻转 指定 目录 下 的 所 有 37 个 *.jpg 文 件 ( 再 次 强调 ， 必 要 时 可 以 更 改 
Directory.GetFiles() 方 法 的 路 径 )。 现在， 所 有 的 工作 都 发 生 在 程序 的 主线 程 上 。 因 此 单 击 按钮 将 挂 
起 程序 。 此 外 ， 窗 口 标题 将 显示 正在 处 理 文件 的 为 相同 的 主线 程 ， 因 为 我 们 只 有 一 个 执行 线程 。 

为 了 让 文件 在 更 多 的 CPU 中 处 理 ， 可 以 使 用 Parallel.ForEach() 来 代替 当前 的 foreach 循 环 。 该 方 
法 有 多 个 重 载 版 本 ， 不 过 最 简单 的 版 本 只 要 求 指 定 一 个 与 IEnumerable<T> 兼 容 的 包含 待 处 理 数据 的 对 
象 〈 文 件 字 符 串 数组 ) 和 一 个 用 于 指向 执行 工作 的 方法 的 Action<T> 委 托 。 
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以 下 是 相关 的 修改 ， 其 中 使 用 了 C# 的 Lambda 操 作 符 来 代替 字面 的 Action<T> 委 托 对 象 。 注 意 ,我 
们 现在 注释 掉 了 显示 执行 当前 图 像 文件 的 线程 ID。 原 因 到 下 一 节 再 揭晓 。 
// 以 并 行 方式 处 理 图 像 数据 
Parallel.ForEach(files, currentFile => 
string filename = Path.GetFileName(currentFile); 


using (Bitmap bitmap = new Bitmap(currentFile)) 


bitmap.RotateFlip(RotateFlipType.Rotate180FlipNone); 
bitmap.Save(Path.Combine(newDir, filename)); 


// 下 面 的 语句 现在 有 问题 | 参见 下 一 节 
// this.Text = string.Format("Processing {0} on thread {1}", filename, 
// Thread.CurrentThread.ManagedThreadId); 
} 
} 
); 


19.11.4 ”在 次 线程 中 访问 UI 元 素 


你 会 发 现 我 注释 了 上 面 用 当前 执行 线程 的 ID 更 新 主 窗 体 标题 的 代码 行 。 如 上 所 述 ，GUI 控 件 与 创 
建 它 的 线程 具有 “线程 相关 性 ”。 如 果 次 线程 试图 访问 不 是 由 它 直 接 创建 的 控件 ， 在 调试 软件 时 一 定 
会 遇 到 运行 时 错误 。 另 一 方面 ， 如 果 运 行程 序 ( 通过 Ctrl+F5 )， 原 始 代码 可 能 永远 不 会 产生 任何 错误 。 


说 明 重申 一 下 : 在 调试 (F5 ) 多 线程 应 用 程序 时 ， 当 次 线程 “触摸 ”主线 程 创建 的 控件 时 ，Visual 
Studio 通 常会 捕获 到 因此 引发 的 错误 。 但 是 ， 在 运行 (Ctrl+F5 ) 应 用 程序 时 ， 往 往 会 运行 正确 
(当然 也 可 能 会 出 错 )。 如 果 不 采 取 防 范 措 施 (下 面 会 介绍 )， 你 的 应 用 程序 在 这 种 条 件 下 会 存 
在 引发 运行 时 错误 的 可 能 。 


我 们 可 以 使 用 一 种 方法 来 让 次 线程 以 线程 安全 的 方式 访问 这 些 控件 ， 即 用 另 一 种 与 委托 相关 的 技 
术 一 一 匿名 委托 。Windows Forms API 中 的 Control 父 类 定义 了 一 个 Invoke() 方 法 ， 接 受 一 个 
System.Delegate 作 为 参数 。 你 可 以 在 次 线程 的 上 下 文中 调用 该 方法 ， 可 以 线程 安全 地 更 新 给 定 控 件 
的 UI。 如 今 ， 尽管 我 们 可 以 直接 编写 所 有 需要 的 委托 代码 , 但 大 多 数 开发 者 还 是 选择 简单 地 使 用 匿名 
委托 。 下 面 的 代码 相应 地 修改 了 上 面 注释 的 代码 : 


using (Bitmap bitmap = new Bitmap(currentFile)) 


bitmap.RotateFlip(RotateFlipType.Rotate180FlipNone); 
bitmap.Save(Path.Combine(newDir, filename)); 


// 呢 | 不 能 再 用 了 1 
//this.Text = string.Format("Processing {0} on thread {1}", filename, 
// Thread.CurrentThread.ManagedThreadId); 


// 在 Form 对 象 上 调用 ， 克 许 次 线程 以 线程 安全 的 方式 访问 控件 
this.Invoke((Action)delegate 


{ 
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this.Text = string.Format("Processing {0} on thread {1}", filename, 
Thread.CurrentThread.ManagedThreadId); 
} 


)3 
} 


说 明 this.Invoke() 方 法 只 在 Windows Form API 中 存在 。 在 构建 WPF 应 用 程序 时 ， 可 以 使 用 
this.Diepatcher.Invoke() 来 达到 同样 的 目的 。 


现在 运行 程序 ，TPL 会 将 工作 分 配给 线程 池 中 的 多 个 线程 ， 使 用 尽 可 能 多 的 CPU。 但 是 ， 在 所 有 
图 像 处 理 完毕 之 前 ， 你 无 法 看 到 窗口 标题 显示 每 个 线程 的 名 称 ， 也 无 法 看 到 在 文本 框 中 输入 的 内 容 。 
这 是 因为 主 UI 线 程 仍然 被 阻塞 ， 等 待 所 有 线程 完成 它们 的 工作 。 


19.11.5 _ Task 类 


Task 类 可 以 轻松 地 在 次 线程 中 调用 方法 ， 可 以 作为 异步 委托 的 简单 替代 品 。 更 新 Button 控 件 的 
Click 处 理 程序 : 


private void btnprocessImages Click(object sender, EventArgs e) 


人 
// 启动 一 个 新 的 “任务 ”来 处 理 文件 
Task.Factory.StartNew(() => 


ProcessFiles(); 


3》 


Task 的 Factory 属 性 返回 一 个 TaskFactory 对 象 。 在 调用 startNew() 方 法 时 , 传人 一 个 Action<T> 委 托 
( 这 里 为 一 个 Lambda 表 达 式 ), 指向 以 异步 方式 进行 调用 的 方法 。 经 过 这 个 小 的 修改 , 你 会 发 现 窗口 的 
标题 可 以 显示 线程 池 中 正在 处 理 文件 的 线程 名 称 ， 更 棒 的 是 ， 文 本 区 域 也 可 以 接收 输入 了 ， 因 为 UI 
线程 已 经 不 再 是 阻塞 的 了 。 


19.11.6 ”处 理 取 消 请 求 


可 以 对 当前 示例 作 一 个 改进 ， 让 用 户 可 以 通过 一 个 Cancel 按 钮 停止 处 理 图 像 数 据 。 幸 好 
Parallel.For() 和 Parallel.ForEach() 方 法 都 支持 取消 标记 。 调 用 Parallel 的 方法 时 ， 可 以 传人 一 个 
Parallel0ptions 对 象 ， 它 包含 一 个 CancellationTokenSource 对 象 。 

首先 ， 在 Form 派 生 类 中 定义 下 面 的 cancellationTokenSource 类 型 的 私有 成 员 变 量 cancelToken: 


public partial class MainForm : Form 


// 新 的 Form 级 别 的 变量 
private CancellationTokenSource cancelToken = 
new CancellationTokenSource(); 


现在 , 假定 已 经 在 设计 器 上 添加 了 一 个 新 的 Button( btnCancel ), 处 理 其 Click 事 件 , 并 实现 处 理 程序 : 


private void btnCancel Click(object sender, EventArgs e) 
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{ 
// 停止 所 有 工作 者 线程 
cancelToken.Cancel(); 


} 
真正 的 修改 发 生 在 ProcessFiles() 方 法 中 。 考 虑 下 面 的 最 终 实现 : 


private void ProcessFiles() 


{ 
// 使 用 Parallel0ptions 实 例 保 存 CancellationToken 
Parallel0ptions parOpts = new ParallelOptions(); 
parOpts.CancellationToken = cancelToken.Token; 
parOpts .MaxDegreeOfParallelism = System.Environment.ProcessorCount; 


// 加 载 所 有 *.jpg 文 件 ， 并 为 修改 后 的 数据 新 建 一 个 文件 夹 
string[] files = Directory.GetFiles 
(@"C:\Users\Public\Pictures\Sample Pictures", "*.jpg", 
SearchOption.AllDirectories); 
string newDir = @"C:\ModifiedPictures"; 
Directory.CreateDirectory(newDir); 


try 


// 以 并 行 方式 处 理 图 像 数据 
Parallel.ForEach(files, parOpts, currentFile => 


{ 
parOpts.CancellationToken.ThrowIfCancellationRequested(); 


string filename = Path.GetFileName(currentFile); 
using (Bitmap bitmap = new Bitmap(currentFile)) 


bitmap.RotateFlip(RotateFlipType.Rotate180FlipNone); 
bitmap.Save(Path.Combine(newDir, filename)); 
this.Invoke((Action)delegate 


this.Text = string.Format("Processing {0} on thread {1}", filename, 
Thread.CurrentThread.ManagedThreadId); 


catch (OperationCanceledException ex) 


this.Invoke((Action)delegate 
{ this.Text = ex.Message; 
}); 


} 
} 


注意 ， 在 方法 的 开始 我 们 配置 了 parallel0ptions 对 象 ， 使 用 CancellationTokenSource 标 记 设 置 其 
CancellationToken 属 性 。 还 要 注意 ,在 调用 Parallel.ForEach() 方 法 时 ， 将 Parallel0ptions 对 象 作为 
第 二 个 参数 。 

在 循环 逻辑 的 作用 域内 , 我 们 调用 了 标记 的 ThrowIfCancellationRequest(), 它 将 确保 在 用 户 单 击 
Cancel 按 钮 时 ， 所 有 的 线程 都 会 停止 ， 并 抛 出 一 个 运行 时 异常 进行 通知 。 捕 获 这 个 operation 
CanceledException 错 误 ， 将 错误 消息 显示 在 主 窗 口 的 文本 字段 中 。 
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源 代 码 ”DataParallelismWithForEach 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 








19.11.7 ”使 用 并 行 类 的 任务 并 行 


除了 数据 并 行 ，TPL 还 可 以 使 用 Parallel.Invoke() 方 法 轻松 地 触发 多 个 异步 任务 。 这 种 方法 比 使 
用 委托 或 system.Threading 成 员 要 更 直接 ， 但 如 果 想 要 对 任务 的 执行 方式 有 更 多 的 控制 ， 可 以 放弃 
Parallel.Invoke() ， 而 像 前 面 的 示例 那样 直接 使 用 Task 类 。 

为 了 演示 任务 并 行 , 新 建 一 个 Windows Forms 应 用 程序 MyEBookReader, 并 确保 引入 System.Threading. 
Tasks 和 System.Net 命 名 空间 。 这 个 示例 改编 自 .NET Framework 4.5 SDK 文 档 中 的 一 个 有 用 示例 , 它 从 Project 
Gutenberg( www.gutenberg.org ) 中 获取 公开 可 用 的 电子 书 ， 然 后 并 行 地 执行 一 些 复杂 的 任务 。 

该 GUI 包含 一 个 多 行 的 TextBox 控 件 〈txtBook ) 和 两 个 Button 控 件 (btnDownload 和 btnGetStats )。 
设计 好 UI 之 后 ， 处 理 每 个 Button 的 Click 事 件 ， 并 在 窗 体 的 代码 文件 中 声明 一 个 类 级 别 的 string 变 量 
theEBook。btnDownload 的 Click 处 理 程序 的 实现 如 下 : 


private void btnDownload Click(object sender, EventArgs e) 


WebClient wc = new WebClient(); 
wc.DownloadStringCompleted += (s, eArgs) => 


theEBook = eArgs.Result; 
txtBook. Text = theEBook; 


3 


// Project Gutenberg 中 的 电子 书 ， 查 尔 斯 - 狄更斯 所 著 的 《双城记 》 
wc.DownloadStringAsync(new Uri("http://www.gutenberg.org/files/98/98-8.txt")); 
} 


WebClient 类 是 System.Net 中 的 成 员 。 该 类 提供 了 大 量 方法 ， 可 以 向 一 个 由 URI 标 识 的 资源 发 送 或 
接收 数据 。 实 际 上 ， 这 些 方 法 中 的 大 多 数 都 有 异步 版 本 ， 如 DownloadStringAsync()。 该 方法 将 自动 从 
线程 池 中 获取 一 个 新 的 线程 。 当 WebClient 获 取 完 数据 之 后 , 将 触发 DownloadStringCompleted 事 件 , 我 
们 已 经 在 此 使 用 C# Lambda 表 达 式 处 理 了 该 事件 。 如 果 调 用 该 方法 ( Downloadstring() ) 的 异步 版 本 ， 
窗 体 将 在 相当 长 的 一 段 时 间 内 失去 响应 。 

btnGetstats 按 钮 控件 的 Click 事 件 处 理 程序 将 提取 theEBook 变 量 中 包含 的 单词 , 然后 将 字符 串 数 组 
传递 给 辅助 函数 进行 处 理 ， 如 下 所 示 : 

private void btnGetStats Click(object sender, EventArgs e) 


{ 
// 从 电子 书 中 获取 单词 
string[] words = theEBook. Split(new char[] 
NOOR Ts a re et A 
StringSplitOptions, RemoveEmptyEntries); 


// 找到 最 常用 的 10 个 单词 


string[] tenMostCommon = FindTenMostCommon(words); 


// 获取 最 长 的 单词 


string longestWord = FindLongestWord(words); 
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// 完成 所 有 任务 之 后 ， 创 建 一 个 字符 事 以 在 消息 框 中 显示 所 有 的 统计 信息 
StringBuilder bookStats = new StringBuilder("Ten Most Common Words are:\n"); 
foreach (string s in tenMostCommon) 


bookStats.AppendLine(s); 


bookStats.AppendFormat("Longest word is: {0}", longestWord); 
bookStats .AppendLine(); 
MessageBox.Show(bookStats.ToString(), "Book info"); 


} 
FindTenMostCommon() 方 法 使 用 LINQ 查 询 获 取 一 个 列表 ， 其 中 包含 string 数 组 中 出 现 最 频繁 的 
string 对 象 。FindLongestWord() 获 取 最 长 的 单词 : 


private string[] FindTenMostCommon(string[] words) 


var frequencyOrder = from word in words 
where word.Length > 6 
group word by word into g 
orderby g.Count() descending 
select g.Key; 


string[] commonWords = (frequencyOrder.Take(10)).ToArray(); 
return commonWords; 


} 
private string FindLongestWord(string[] words) 


return (from w in words orderby w.Length descending select w).FirstOrDefault(); 


运行 该 项 目 , 执行 所 有 任务 所 消耗 的 时 间 与 计算 机 中 CPU 的 数量 和 处 理 器 的 整体 速度 有 关 。 最 终 ， 
将 看 到 如 图 19-4 所 示 的 输出 结果 。 
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图 19-4 所 下 载 电子 书 的 统计 信息 
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你 可 以 并 行 地 调用 FindTenMostCommon() 和 FindLongestWord() 方 法 ,让 应 用 程序 使 用 所 有 计算 机 中 
可 用 的 CPU。 修 改 btnGetStats_Click() 方 法 ， 具 体 如 下 : 
private void btnGetStats Click(object sender, EventArgs e) 
// 从 电子 书 中 获取 单词 
string[] words = theEBook. Split( 
new ChazftT { © "NUO00A yy ST Sas Ss os 
StringSplitOptions. RemoveEmptyEntries); 


string[] tenMostCommon = null; 
string longestWord = string. Empty; 


Parallel.Invoke( 
() => 


{ 
// 找到 最 常用 的 10 个 单词 
tenMostCommon = FindTenMostCommon(words); 
2 
) => 


// 获取 最 长 的 单词 
longestWord = FindLongestWord(words); 


// 完成 所 有 任务 之 后 ， 创 建 一 个 字符 囊 以 在 消息 框 中 显示 所 有 的 统计 信息 
F a 


Parallel.Invoke() 方 法 要 求 一 个 Action<> 委 托 的 参数 数组 ， 我 们 间接 地 使 用 Lambda 表 达 式 来 提 
供 。 尽 管 输出 结果 相同 ， 但 TPL 的 好 处 是 ， 所 有 计算 机 中 可 用 的 处 理 器 都 用 来 并 行 地 调用 各 个 方法 。 


me 


源 代码 MyEBookReader 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.12 并行 LINQ 查询 (PLINQ) 


在 学 习 TPL 的 最 后 ， 要 注意 还 有 一 种 在 .NET 应 用 程序 里 使 用 并 行 任务 的 方法 。 你 可 以 使 用 一 组 扩 
展 方法 ， 构 造 LINQ 查 询 来 并 行 地 执行 工作 。 为 并 行 运行 而 设计 的 LINQ 查 询 称 为 PLINQ 查 询 。 

与 使 用 Parallel 类 编写 的 并 行 代码 类 似 ，PLINQ 也 可 以 在 需要 时 选择 忽略 并 行 处 理 集合 的 请 求 。 
PLINQ 框 架 进 行 了 很 多 优化 ， 其 中 包括 判断 查询 是 否 在 同步 方式 下 会 运行 得 更 快 。 

在 运行 时 ，PLINQ 分 析 查 询 的 整个 结构 ， 如 果 查 询 能 从 并 行 化 中 受益 ， 则 将 同时 运行 。 而 如 果 并 
行 执行 查询 会 损害 性 能 ，PLINQ 将 按 顺序 运行 查询 。 对 于 昂贵 的 并 行 算法 和 廉价 的 顺序 算法 ，PLINQ 
默认 会 选择 后 者 。 

System.Linq 命 名 空间 的 ParallelEnumerable 类 中 包含 了 必要 的 扩展 方法 。 表 19-5 列 出 了 一 些 有 用 
的 PLINQ 扩 展 。 

要 在 实战 中 演示 PLINQ , 创建 一 个 Windows Forms 应 用 程序 PLINQDataProcessingWithCancellation， 
引入 System.Threading 命 名 空间 。 这 个 简单 的 窗 体 仅 需要 两 个 Button 控 件 一 一 btnExecute 和 btnCancel。 
单 击 Execute 按 钮 时 ， 将 启动 一 个 Task， 它 对 一 个 非常 大 的 整 型 数组 执行 LINQ 查 询 ， 查 找 x % 3 == 
为 true 的 项 。 以 下 是 该 查询 的 非 并 行 版 本 。 





604 第 19 章 ”多 线程 、 并 行 和 异步 编程 


表 19-5 ”ParallelEnumerable 类 中 的 部 分 成 员 


成 员 作 用 
AsParallel() 指明 如 果 可 能 的 话 ， 查 询 的 其 余部 分 应 该 并 行 化 
WithCancellation() 指明 PLINQ 应 该 定期 监视 取消 标记 的 状态 ， 并 在 需要 的 时 候 取消 执行 
WithDegreeOfParallelism() 指明 PLINQ 进 行 并 行 查询 时 能 使 用 的 最 大 处 理 器 数 
ForA11() 使 用 foreach 关 键 字 枚 举 LINQ 结 果 时 进行 并 行 处 理 ， 不 必 向 消费 者 线程 返 
回合 并 的 结果 


public partial class MainForm : Form 


private void btnExecute Click(object sender, EventArgs e) 


{ 
// 开始 一 个 新 的 “任务 ”来 处 理 整数 
Task.Factory.StartNew(() => 


ProcessIntData(); 


3 


. 


private void ProcessIntData() 


// 获得 一 个 非常 大 的 整数 数组 
int[] source = Enumerable.Range(1, 10000000).ToArray(); 


// 找到 num % 3 == 0 为 true 的 数字 ， 降 序 返回 
int[] modThreeIsZero = (from num in source where num % 3 == 
orderby num descending select num) .ToArray(); 


MessageBox.Show(string.Format("Found {0} numbers that match query!", 
modThreelsZero.Count())); 
} 


} 


19.12.1 使 用 PLINQ 查询 
如 果 希 望 TPL 并 行 地 执行 该 查询 ( 如 果 可 以 的 话 )， 可 以 像 下 面 这 样 使 用 AsParallel() 扩 展 方法 : 


int[] modThreeIsZero = (from num in source.AsParallel() where num % 3 == 
orderby num descending select num).ToArray(); 


注意 ，LINQ 查 询 的 整个 格式 与 前 几 章 中 看 到 的 完全 一 样 。 但 通过 调用 AsParallel()，TPL 将 尝试 
将 工作 传递 给 可 用 的 CPU。 


19.12.2 取消 PLINQ 查询 


还 可 以 使 用 CancellationTokenSource 对 象 通知 PLINQ 查 询 ， 在 条 件 满足 时 (通常 是 由 于 用 户 的 干 
预 ) 停 止 处 理 。 声明 一 个 窗 体 级 别 的 CancellationTokenSsource 对 象 cancelToken, 实现 btnCancel 的 Click 
处 理 程序 ， 调 用 该 对 象 的 cancel() 方 法 。 以 下 是 相关 的 代码 : 
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public partial class MainForm : Form 
private CancellationTokenSource cancelToken = new CancellationTokenSource(); 
private void btnCancel Click(object sender, EventArgs e) 四 
19 


cancelToken.Cancel(); 


现在 ， 链 式 地 调用 WithCancellation() 扩 展 方法 并 传人 标记 ， 就 可 以 向 PLINQ 查 询 中 引入 取消 请 
求 。 此 外 ， 还 要 将 PLINQ 查 询 包 装 在 恰当 的 try/catch 作 用 域内 ， 并 处 理 可 能 的 异常 。 以 下 是 
ProcessIntData() 方 法 的 最 终 版 本 : 


private void ProcessIntData() 


// 获得 一 个 非常 大 的 整数 数组 
int[] source = Enumerable.Range(1, 10000000).ToArray(); 


// 找到 num % 3 == 0 为 true 的 数字 ， 降 序 返 回 
int[] modThreeIsZero = null; 
try 


modThreelsZero = (from num in 
source.AsParallel().WithCancellation(cancelToken.Token) 
where num % 3 == 0 orderby num descending 
select num).ToArray(); 

MessageBox.Show(string.Format("Found {0} numbers that match query!", 
modThreeIsZero.Count())); 


catch (OperationCanceledException ex) 
this.Invoke((Action)delegate 
{ 


this.Text = ex.Message; 


和 


} 


源 代码 ”PLINQDataProcessingWithCancellation 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 
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我 们 在 本 章 ( 相当 长 的 一 章 ) 中 已 经 介绍 了 很 多 简单 的 元 素 。 毫 无 疑问 ， 构建、 调试 和 理解 复杂 
的 多 线程 应 用 程序 在 任何 框架 中 都 是 一 种 挑战 。 尽 管 TPL、PLINQ 和 委托 类 型 可 以 在 某 种 程度 上 简化 
操作 ( 特别 是 和 其 他 平台 和 语言 比 起 来 ) ， 但 开发 者 仍然 需要 了 解 各 种 高 级 技术 的 来 龙 去 脉 。 

随 着 .NET 4.5 的 发 布 ，C# 编 程 语言 ( 以 及 VB ) 新 增 了 两 个 关键 字 ， 进一步 简化 了 编写 异步 代码 的 
过 程 , 相 比 本 章 前 面 介绍 的 所 有 示例 ， 使 用 新 的 async 和 await 关 键 字 ， 编译 器 将 使 用 System.Threading 
和 System.Threading.Tasks 命 名 空间 中 的 众多 成 员 ， 为 我 们 生成 大 量 线程 代码 。 
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19.13.1 C# async 和 await 关 键 字 初探 

C# async 关 键 字 用 来 指定 某 个 方法 、Lanbda 表 达 式 或 匿名 方法 自动 以 异步 的 方式 来 调用 。 是 的 ， 
没 错 。 就 是 用 async 修 饰 符 声明 方法 这 么 简单 ，CLR 会 创建 新 的 执行 线程 来 处 理 任务 。 在 调用 async 方 
法 时 ，await 关 键 字 会 自动 暂停 当前 线程 中 任何 其 他 活动 ， 直 到 任务 完成 ， 离 开 调用 线程 ， 并 继续 其 


幸福 之 旅 。 
为 了 演示 这 一 点 ， 我 们 创建 一 个 新 的 Windows Forms 应 用 程序 FunWithCSharpAsync， 并 在 窗 体 的 


主 代码 文件 ( 重 命名 为 MainForm ) 中 引入 System.Threading 命 名 空间 。 这 之 后 ， 将 一 个 Button 控 件 
(btnCallMethod ) 和 一 个 TextBox 控 件 (txtInput ) 放 到 设计 器 表面 上 ， 并 配置 基本 的 UI 属性 ( 颜色 、 
字体 、 文 本 ) 。 现在, 处理 Button 控 件 的 Click 事 件 , 在 事件 处 理 程序 中 , 调用 私有 辅助 方法 DowWork()， 
它 强 制 使 线程 等 待 10 秒 钟 。 如 下 所 示 : 


public partial class MainForm : Form 
public MainForm() 


InitializeComponent(); 


private void btnCallMethod Click(object sender, EventArgs e) 


this.Text = Dowork(); 


private string Dowork() 


Thread. Sleep(10000); 
return "Done with work!"; 


} 

基于 本 章 所 学 过 的 知识 你 会 知道 ， 如 果 运 行程 序 并 点 击 该 按钮 ,需要 等 待 10 秒 钟 ， 文 本 框 控件 才 
能 接收 到 键盘 输入 。 此 外 ， 同 样 需要 等 待 10 秒 钟 主 窗 体 的 标题 才 会 修改 为 “Done with work!”。 

如 果 要 用 本 章 之 前 介绍 的 技术 使 程序 响应 得 更 快 ， 需 要 做 很 多 工作 。 但 在 .NET 4.5 下 ， 可 以 编写 
如 下 的 代码 : 


public partial class MainForm : Form 
public MainForm() 


InitializeComponent(); 


private async void btnCallMethod Click(object sender, EventArgs e) 
this.Text = await DoWork(); 

// 对 下 面 的 代码 进行 走 查 

private Task<string> Dowork() 


return Task.Run(() => 
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Thread.Sleep(10000); 
return "Done with work!"; 


); 

} 

首先 ， 注 意 按钮 的 Click 事 件 处 理 程序 标记 了 async 关 键 字 。 这 意味 着 该 方法 可 以 作为 非 阻塞 式 调 
用 的 成 员 。 同 样 注意 该 事件 处 理 程序 的 实现 在 被 调用 的 方法 名 前 使 用 了 await 关 键 字 。 这 很 重要 : 如 
果 用 async 关 键 字 修饰 某 个 方法 , 但 方法 内 部 没有 一 个 await 方 法 调用 ,那么 实质 上 仍 将 构建 一 个 阻塞 
的 、 同 步 的 方法 调用 (实际 上 会 得 到 一 个 编译 器 警告 ) 。 

现在 , 注意 我 们 需要 使 用 System.Threading.Tasks 命 名 空间 中 的 Task 类 来 重 构 DoWork() 方 法 使 其 
正常 工作 。 我 们 不 直接 返回 特定 的 值 (本 例 中 为 字符 串 对 象 ) ， 而 是 返回 一 个 Task<T> 对 象 ， 其 泛 型 
类 型 参数 T 即 为 实际 返回 值 ( 能 跟 上 吗 ? ) 。 

现在 Dowork() 的 实现 直接 返回 Task<T> 对 象 了 ， 它 是 Task.Run() 的 返回 值 。Run() 方 法 接受 一 个 
Func<> 或 Action<> 委 托 。 阅 读 到 本 书 这 里 的 时 候 你 已 经 知道 ， 我 们 可 以 用 Lambda 表 达 式 来 简化 委托 。 
基本 上 ， 新 版 的 DoWork() 在 表述 下 面 这 样 的 事实 : 





新 的 任务 ， 因 为 你 的 调用 而 运行 。 旧 的 任务 ， 从 此 开始 休眠 。10 秒 ， 只 需 10 秒 它 就 会 睡 醒 ， 继 续 
运行 。 它 回馈 我 一 串 字 符 ， 我 将 把 它们 放 入 新 的 Task<string> 对 象 ， 返 回 给 ， 最初 的 那个 调用 者 。 


rn pee 


将 DoWork() 的 新 实现 翻译 成 更 自然 的 语言 ( 像 诗 一 样 ) 之 后 ， 我 们 对 await 标 记 的 真正 作用 有 了 
一 定 的 了 解 。 该 关键 字 总 是 修饰 返回 Task 对 象 的 方法 。 当 逻辑 流 到 达 await 标 记 后 ， 调 用 线程 挂 起 直 
到 调用 完成 。 运 行 该 版 本 的 应 用 程序 ， 你 会 发 现 你 可 以 点 击 按钮 ， 然 后 立即 在 文本 区 域 输入 值 。10 秒 
钟 之 后 ， 窗 体 的 标题 更 新 为 完整 的 消息 通知 。 


19.13.2 “异步 方法 的 命名 约定 
现在 ， 新 版 的 DoWork() 已 经 展示 ,但 按钮 的 Click 事 件 处 理 程序 还 如 下 所 示 : 


private async void btnCallMethod Click(object sender, EventArgs e) 


// 哦 ， 这 里 没有 await 关 键 字 
this.Text = DoWork(); 


注意 , 我 们 对 该 方法 使 用 了 async 关 键 字 标记 , 但 在 调用 DoWork() 方 法 时 没有 用 await 关 键 字 修饰 。 
这 时 将 会 得 到 编译 器 错 误 ， 因 为 Dowork() 的 返回 值 是 一 个 Task 对 象 ,我 们 将 它 直接 赋值 给 接受 字符 串 
数据 类 型 的 Text 属 性 。 记 住 ，await 标 记 负 责 提 取 包 含 在 Task 对 象 中 的 内 在 返回 值 。 由 于 没有 使 用 该 
标记 ， 类 型 就 不 匹配 了 。 如 图 19-5 所 示 ， 编 译 器 将 通知 我 们 ， 要 调用 的 方法 是 “awaitable” 的 ， 并 推 
荐 了 调用 该 方法 的 正确 形式 。 


注意 “awaitable” 的 方法 是 指 返 回 Task<T> 的 方法 。 
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图 19-5 返回 Task 对 象 的 方法 可 以 通过 await 调 用 
由 于 返回 Task 对 象 的 方法 可 以 通过 async 和 await 标 记 以 非 阻 塞 的 方式 调用 ， 微 软 推 荐 ( 也 是 最 佳 


实践 ) 任何 返回 Task 的 方法 都 用 “Async” 作 为 后 缀 。 这 样 ， 了 解 该 命名 约定 的 开发 者 看 到 该 方法 后 
就 会 知道 ， 如 果 要 在 异步 上 下 文中 调用 该 方法 ， 就 需要 使 用 await 关 键 字 。 


说 明 使 用 async/await 关 键 字 的 GUI 控件 的 事件 处 理 程序 ( 如 按钮 的 Click 处 理 程序 ) 不 遵循 这 一 命 
名 约定 ( 按照 约定 ， 应 该 避免 宛 余 ) 。 


此 外 ，DoWork() 方 法 还 可 以 用 async 和 await 标 记 修 饰 ( 尽管 当前 示例 不 必 严 格 遵循 这 一 点 ) 。 
此 ， 最 终 修改 的 示例 如 下 ， 它 符合 推荐 的 命名 约定 : 


public partial class MainForm : Form 
public MainForm() 


InitializeComponent(); 


private async void btnCallMethod Click(object sender, EventArgs e) 


this.Text = await DoWorkAsync(); 


private async Task<string> DoWorkAsync() 
{ 
return await Task.Run(() => 


Thread.Sleep(10000); 
return "Done with work!"; 


3 


19.13 .NET 4.5 下 的 异步 调用 609 


19.13.3 ”返回 void 的 异步 方法 


目前 ，DowWork() 方 法 返回 一 个 Task， 它 包含 调用 者 可 以 通过 显 式 的 await 关 键 字 获 取 的 “真正 的 
数据 ”。 但 如 何 构建 一 个 返回 void 的 匿名 方法 呢 ? 这 时 我 们 要 使 用 非 泛 型 的 Task 类 ， 并 忽略 return 语 
句 ， 如 下 所 示 

private async Task MethodReturningVoidAsync() 

await Task.Run(() => { /* 进 行 一 些 处 理 ... */ 
Thread. Sleep(4000); 


}); 
} 


该 方法 的 调用 者 〈 比如 另 一 个 按钮 的 Click 事 件 处 理 程序 ) 将 按照 下 面 的 形式 使 用 await 和 async 
关键 字 : 
private async void btnVoidMethodCall Click(object sender, EventArgs e) 


await MethodReturningVoidAsync(); 
MessageBox.Show("Done!"); 


19.13.4 具有 多 个 await 的 异步 方法 


单个 async 方 法 完全 可 以 在 其 实现 中 拥有 多 个 await 上下文。 假设 我 们 的 应 用 程序 存在 第 三 个 按钮 
Click 事 件 处 理 程序 ， 并 且 用 async 关 键 字 标 记 。 在 前 面 的 示例 中 ，Click 人 处 理 程序 特意 调用 了 运行 真 
正 Task 的 外 部 方法 。 其 实 你 也 可 以 通过 一 组 Lambda 表 达 式 来 内 联 这 些 逻 辑 ， 如 下 所 示 : 

private async void btnMutliAwaits Click(object sender, EventArgs e) 


await Task.Run(() => { Thread.Sleep(2000); }); 
MessageBox.Show("Done with first task!"); 


await Task.Run(() => { Thread.Sleep(2000); }); 
MessageBox.Show("Done with second task!"); 


await Task.Run(() => { Thread.Sleep(2000); }); 
MessageBox.Show("Done with third task!"); 


同样 ， 这 里 的 每 个 任务 都 只 是 将 当前 线程 挂 起 一 段 时 间 。 但 是 ,任何 工作 单元 都 可 以 用 这 些 任 务 
来 表示 ( 如 调用 Web 服 务 、 读 取 数 据 库 等 ) 。 我 们 将 本 例 中 的 一 些 关 键 点 总 结 如 下 : 

口 方法 (包括 Lambda 表 达 式 和 匿名 方法 ) 可 以 用 async 关 键 字 标记 ， 人 允许 该 方法 以 非 阻塞 的 形式 
进行 工作 。 

口 用 async 关 键 字 标记 的 方法 (包括 Lambda 表 达 式 和 匿名 方法 ) 在 遇 到 await 关 键 字 之 前 将 以 阻 
塞 的 形式 运行 。 

口 单个 async 方 法 可 以 拥有 多 个 await 上 下 文 。 

口 当 过 到 await 表 达 式 时 ,调用 线程 将 挂 起 ， 直 到 await 的 任务 完成 。 同 时 ,控制 将 返回 给 方法 的 
调用 者 。 
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口 await 关 键 字 将 从 视图 中 隐藏 返回 的 Task 对 象 ， 直 接 返 回 实际 的 返回 值 。 没 有 返回 值 的 方法 可 
以 简单 地 返回 void。 
口 根据 命名 约定 ， 要 被 异步 调用 的 方法 应 该 以 “Async” 作 为 后 缀 。 


源 代码 ”FunWithCSharpAysnc 项 目的 源 代码 位 于 Chapter 19 子 目录 下 。 


19.13.5 用 async/await 改 进 AddWithThreads 示 例 


在 本 章 开 头 ， 我们 构建 了 一 个 示例 AddWithThreads ， 使 用 了 .NET 平台 的 原始 线程 API 
System.Threading。 现 在 ， 我 们 来 用 新 的 C# async 和 await 关 键 字 改进 这 一 示例 ， 来 看 看 应 用 程序 逻 
辑 可 以 清晰 到 何 种 地 步 。 首 先 来 看 看 AddWithThreads 项 目 原来 是 如 何 工作 的 。 

口 创建 自 定义 的 AddParams 类 ， 表 示 要 被 求 和 的 数据 。 

口 使 用 Thread 类 和 pParameterizedThreadStart 委 托 ， 指 向 一 个 接受 AddpParams 对 象 的 Add() 方 法 。 

口 使 用 AutoResetEvent 类 来 确保 调用 线程 会 等 待 次 线程 完成 。 

最 重要 的 是 ， 对 于 在 次 执行 线程 计算 两 个 数字 之 和 这 种 简单 的 任务 来 说 ， 所 需要 的 代码 太 多 了 。 
以 下 是 同样 的 项 目 , 使 用 学 过 的 .NET 4.5 中 的 新 技术 进行 重 构 ( AddParams 类 此 处 不 再 獒 述 ， 只 需 记得 
它 包 含 两 个 字段 a 和 b， 来 表示 数据 之 和 ) : 

class Program 


static void Main(string[] args) 


AddAsync(); 
Console.ReadLine(); 
private static async Task AddAsync() 
Console.WriteLine("***** Adding with Thread objects *****"); 
Console.WriteLine("ID of thread in Main(): {0}", 
Thread.CurrentThread.ManagedThreadId); 


AddParams ap = new AddParams(10, 10); 
await Sum(ap); 


Console.WritelLine("Other thread is done!"); 


static async Task Sum(object data) 
await Task.Run(() => 
if (data is AddParams) 


Console.WriteLine("ID of thread in Add(): {0}", 
Thread.CurrentThread.ManagedThreadId); 


AddParams ap = (AddParams)data; 
Console.WritelLine("{0} + {1} is {2}", 
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ap.a，ap.b，ap.a + ap.b); 


} 
)); 
, } 
我 首先 想 指 出 的 是 ， 原 来 在 Main() 中 的 代码 被 移 到 了 新 的 AddAsync() 方 法 中 。 原 因 不 仅 是 符合 期 


望 的 命名 约定 ， 还 包括 非常 重要 的 一 点 : 





说 明 “可 执行 程序 中 的 Main() 方 法 不 能 用 async 关 键 字 标记 。 


注意 AddAsync() 用 async 标 记 ， 并 定义 了 一 个 await 上下文。 同样 Sum() 方 法 包含 一 个 新 的 Task 来 
执行 工作 单元 。 不 论 怎样 ， 运 行程 序 ， 我 们 会 发 现 10 加 10 始 终 是 20。 注 意 ， 我 们 确实 有 两 个 不 同 的 线 
程 ID ( 如 图 19-6 所 示 ) 。 











有 
| CWindows\system32\cmd.exe 


hdaing with Thread objects wxxxx A 
ID of thread in MainK>: 1 ; 
ID of thread in fldd<»: 3 

@ + 1 is 2@ 

ther thread is done? 

ress any key to continue . . . 














从 4 


图 19-6 用 .NET 4.5 的 异步 特性 改进 的 System.Threading 示 例 





源 代码 ”AddWithThreadsAsync 项 目的 源 代 码 位 于 Charpter 19 子 目录 下 。 





如 你 所 见 ，.NET 4.5 引 入 的 async 和 await 关 键 字 从 根本 上 简化 了 再 次 执行 线程 调用 方法 的 过 程 。 尽 
管 我 们 只 介绍 了 几 个 关于 这 个 C#i 语 言 新 功能 的 示例 ， 但 你 已 经 为 今后 的 学 习 打下 了 一 个 良好 的 基础 。 


19.14 小结 


本 章 首 先 研 究 了 如 何 配 置 .NET 委 托 类 型 以 进行 异步 调用 。 读 者 已 经 看 到 了 ，BeginInvoke() 和 
EndInvoke() 方 法 允许 我 们 使 用 最 小 的 代价 来 操作 次 线程 。 本 章 还 介绍 了 IAsyncResult 接 口 和 AsyncResult 
类 类 型 。 这 些 类 型 提供 了 多 种 方式 来 同步 调用 线程 和 获取 方法 的 返回 值 。 

接着 分 析 了 System.Threading 命 名 空间 的 作用 。 当 一 个 程序 创建 了 多 个 执行 线程 后 ， 这 个 程序 的 
运行 结果 可 能 (看 起 来 ) 在 同一 时 间 执 行 多 个 任务 。 我 们 也 研究 了 保护 线程 敏感 代码 的 几 种 方式 ， 确 
保 共 享 资源 不 会 变 成 无 法 使 用 的 脏 数 据 。 

本 章 接着 介绍 了 .NET4.0 引 入 的 关于 多 线程 开发 的 新 模型 ,如 TPL 和 PLINQ。 最 后 我 们 介绍 了 .NET 4.5 
的 C# async 和 await 关 键 字 的 作用 。 如 你 所 见 ， 这 两 个 关键 字 在 后 台 使 用 了 很 多 TPL 框 架 的 类 型 ， 只 不 
过 编译 器 为 我 们 做 了 大 量 的 工作 ， 来 创建 复杂 的 线程 和 同步 代码 。 
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ee 那么 在 用 户 会 话 之 间 保 存 信息 是 必 不 可 少 的 。 本 章 将 从 .NET 
Framework 的 视角 来 研究 一 系列 与 JO 相 关 的 主题 。 首 先 研究 System.I0 命 名 空间 定义 的 一 些 
重要 类 型 ， 进 而 理解 怎样 以 编程 方式 修改 计算 机 的 目录 和 文件 结构 。 掌 握 了 这 些 后 ， 接 下 来 的 任务 就 
是 研究 读 写 基 于 字符 、 二 进 制 、 字 符 串 、 内 存 的 各 种 数据 存储 内 容 的 方法 。 

在 学 习 了 如 何 使 用 核心 JO 类 型 操作 文件 和 目录 之 后 , 我 们 将 介绍 对 象 序列 化 相关 的 内 容 。 你 可 以 
使 用 对 象 序列 化 将 对 象 的 状态 持久 化 为 System.I0.Stream 的 派生 类 , 或 从 System.I0.Stream 派 生 类 中 获 
取 对 象 的 状态 。 当 你 使 用 不 同 的 远程 技术 ( 如 WCEF ) 向 远程 计算 机 复制 对 象 时 ， 这 种 序列 化 对 象 的 能 
力 就 尤为 重要 。 其 实 ， 序列 化 本 身 也 是 非常 有 用 的 ,将 在 很 多 .NET 应 用 程序 ( 分 布 式 或 非 分 布 式 ) 中 
发 挥 作用 。 


20.1 研究 System.I0 命名 空间 


在 .NET Framework 中 ，System.I0 命 名 空间 主要 包含 基于 文件 ( 和 基于 内 存 ) 的 输入 输出 (IO ) 
服务 的 相关 基础 类 库 。 和 其 他 命名 空间 一 样 ，System.I0 定 义 了 一 系列 类 、 接 口 、 枚 举 、 结 构 和 委托 。 
它们 大 多 数 包含 在 mscorlib.dll 中 ， 另 外 有 一 部 分 System.I0 命 名 空间 的 成 员 则 包含 在 System.dll 程 序 集 
中 。 注 意 Visual Studio 会 自动 为 项 目 添加 这 些 程序 集 的 引用 。 

System.I0 命 名 空间 的 多 数 类 型 主要 用 于 编程 操作 物理 目录 和 文件 , 而 另 一 些 类 型 则 提供 了 从 字符 
串 缓冲 区 和 内 存 区 域 中 读 写 数据 的 方法 。 为 了 让 读者 了 解 sSystem.I0 功 能 的 概况 , 表 20-1 列 出 了 一 些 主 
要 的 ( 非 抽 象 ) 类 。 


表 20-1 System.I0 命 名 空间 的 主要 成 员 





非 抽象 VO 类 类 型 作 用 
BinaryReader 和 BinaryWriter 这 两 个 类 型 能 够 以 二 进 制 值 存储 和 读 取 基 本 数据 类 型 ( 整 型 、 布 尔 型 、 字 符 串 型 和 
其 他 类 型 ) 
BufferedStream 这 个 类 型 为 字 节 流 提 供 了 临时 的 存储 空间 ， 可 以 以 后 提交 
Directory 和 DirectoryInfo 这 两 个 类 型 用 来 操作 计算 机 的 目录 结构 。Directory 类 型 主要 的 功能 通过 静态 方法 实 


现 。DirectoryInfo 类 型 则 通过 一 个 有 效 的 对 象 引用 来 实现 类 似 功 能 
DriveInfo 提供 计算 机 驱动 器 的 详细 信息 
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( 续 ) 
6 和 UVO% 尖 型 作用 
File 和 FileInfo 这 两 个 类 型 用 来 操作 计算 机 上 的 一 组 文件 。 File 类 型 主要 的 功能 通过 静态 成 员 实 现 ， 
FileInfo 类 型 则 通过 一 个 有 效 的 对 象 引用 来 实现 类 似 功能 
FileStream 这 个 类 型 实现 文件 随机 访问 〈 比如 寻 址 能 力 ) ， 并 以 字 节 流 来 表示 数据 
FileSystemWatcher 这 个 类 型 监控 对 指定 外 部 文件 的 更 改 
MemoryStream 这 个 类 型 实现 对 内 存 ( 而 不 是 物理 文件 ) 中 存储 的 流 数据 的 随机 访问 
Path 这 个 类 型 对 包含 文件 或 目录 路 径 信息 的 System.String 类 型 执行 操作 。 这 些 操作 是 与 
平台 无 关 的 


StreamWriter 和 lStreamReader 这 两 个 类 型 用 来 在 (从 ) 文件 中 存储 (获取 ) 文本 信息 。 不 支持 随机 文件 访问 


StringWriter 和 StringReader 和 StreamWriter/StreamReader 类 型 差不多 ， 这 两 个 类 型 同样 和 文本 信息 打交道 ,不 
同 的 是 基层 的 存储 器 是 字符 串 缓冲 区 而 不 是 物理 文件 


除了 这 些 类 类 型 , system.I0 还 定义 了 许多 枚 举 类 型 和 一 组 抽象 类 ( Stream TextReader 和 TextWriter 
等 )， 它 们 为 所 有 派生 类 定义 了 共享 的 多 态 接 口 。 本 章 后 面 有 更 多 有 关 这 些 类 型 的 介绍 。 


20.2 Directory(Info) 和 File(Info) 类 型 


System.I0 提 供 了 4 个 类 型 来 实现 对 单个 文件 和 计算 机 目录 结构 的 操作 。 前 两 个 类 型 Directory 和 
File 通 过 各 种 静态 成 员 实现 建立 、 删 除 、 复 制 和 移动 操作 。 与 之 紧密 关联 的 FileInfo 和 DirectoryInfo 
类 型 则 通过 实例 级 方法 来 实现 类 似 的 功能 ( 因此 必须 用 new 关 键 字 分 配 它们 )。 从 图 20-1 中 ， 我 们 注意 
到 Directory 和 File 类 型 直接 扩展 了 System.0bject， 而 DirectoryInfo 和 FileInfo 则 从 FilesystemInfo 抽 
象 类 派生 。 








Object 田 
类 
人 
‘FileSysteminfo 加 File Directory 
抽象 类 : 类 类 


Sim sn 


Filetafo 四 
类 
FileSysteminto 六 二 


图 20-1 ”File 和 Directory 相 关 类 型 


一 般 说 来 ，FileInfo 和 DirectoryInfo 是 获取 文件 或 目录 细节 ( 如 创建 时 间 、 读 写 能 力 等 ) 更 好 的 
方式 ， 因 为 它们 的 成 员 往 往 会 返回 强 类 型 的 对 象 。 相 反 ,， Directory 和 File 类 成 员 往往 会 返回 简单 字符 











614 第 20 章 文件 输入 输出 和 对 象 序列 化 


串 值 而 不 是 强 类 型 对 象 。 不 过 ， 这 仅仅 是 一 个 准则 。 在 很 多 情况 下 ， 你 都 可 以 使 用 File/FileInfo 或 
Directory/DirectoryInfo 完 成 相同 的 工作 。 
FileSystemInfo 抽 象 基 类 


DirectoryInfo 和 FileInfo 类 型 实现 了 许多 FileSystemInfo 抽 象 基 类 的 行为 。 大 部 分 FileSystemInfo 
类 成 员 的 作用 是 用 来 获取 指定 文件 或 目录 的 一 般 特性 ( 比如 创建 时 间 、 各 种 特性 等 )。 表 20-2 列 举 了 一 
些 重要 属性 。 


表 20-2 FileSystemInfo 属 性 


属 性 作 用 
”Attributes 获取 或 设置 与 当前 文件 关联 的 特性 ， 由 FileAttributes 枚 举 表示 (例如 ， 是 只 读 、 加 密 、 隐 藏 
或 压缩 文件 或 目录 ) 
CreationTime 获取 或 设置 当前 文件 或 目录 的 创建 时 间 
Exists 用 来 判断 指定 文件 或 目录 是 否 存 在 的 值 
Extension 获取 文件 的 扩展 名 
FullName 获取 目录 或 文件 的 完整 路 径 


LastAccessTime 获取 或 设置 上 次 访问 当前 文件 或 目录 的 时 间 
LastWriteTime 获取 或 设置 上 次 写 入 当前 文件 或 目录 的 时 间 
Name 获取 当前 文件 或 目录 的 名 称 


FileSystemInfo 类 型 还 定义 了 Delete() 方 法 ， 该 操作 由 派生 类 型 从 硬盘 中 删除 指定 文件 或 目录 来 
实现 。 同 样 ， 在 获取 文件 特性 前 使 用 Refresh() 方 法 能 确保 当前 文件 (或 目录 ) 的 统计 信息 是 最 新 的 。 


20.3 ”使 用 DirectoryInfo 类 型 


我 们 首先 要 讨论 的 用 于 IO 的 类 型 是 DirectoryInfo 类 。 它 包含 一 组 用 来 创建 、 移 动 、 删 除 和 枚 举 
所 有 目录 / 子 目 录 的 成 员 。 表 20-3 详 细 列举 了 除了 它 的 基 类 ( FileSystemInfo ) 提供 的 功能 外 的 一 些 
成 员 。 


表 20-3 DirectoryInfo 类 型 的 主要 成 员 


成 “ 员 作 用 
Create() 和 CreateSubdirectory() 按照 路 径 名 建立 一 个 目录 (或 者 一 组 子 目 录 ) 
Delete() 删除 一 个 目录 和 它 的 所 有 内 容 
GetDirectories() 返回 一 个 表示 当前 目录 中 所 有 子 目 录 的 DirectoryInfo 对 象 数组 
GetFiles() 返回 FileInfo 对 象 数组 ， 表 示 指 定 目录 下 的 一 组 文件 
MoveTo() 将 一 个 目录 及 其 内 容 移动 到 一 个 新 的 路 径 
Parent 获取 指定 路 径 的 父 目 录 


Root 获取 路 径 的 根部 分 
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我 们 首先 使 用 DirectoryInfo 类 型 指定 一 个 特别 的 目录 路 径 作 为 构造 函数 的 参数 。 如 果 需 要 访问 当 
前 应 用 程序 目录 的 话 ( 比如 执行 的 应 用 程序 的 目录 )， 可 以 使 用 “.” 符 号 。 下 面 是 一 些 例子 : 


// 绑 定 到 当前 的 应 用 程序 目录 
DirectoryInfo dir1 = new DirectoryInfo("."); 


// 使 用 verbatim 字 符 事 绑 定 到 C:\Windows 

DirectoryInfo dir2 = new DirectoryInfo(@"C:\Windows"); 

在 第 二 个 例子 中 ,必须 确保 传人 构造 函数 的 路 径 ( C:\Windows ) 是 在 物理 计算 机 上 存在 的 。 然 而 
如 果 试 图 使 用 一 个 不 存在 的 目录 ,系统 会 引发 System.I0.DirectoryNotFoundException 异 常 。 因 此 ， 如 
果 指 定 了 一 个 尚未 创建 的 目录 的 话 ， 在 对 目录 进行 操作 前 首先 需要 调用 Create() 方 法 。 

// 绑 定 到 一 个 不 存在 的 目录 ， 然 后 创建 它 


DirectoryInfo dir3 = new DirectoryInfo(@"C:\MyCode\Testing"); 
dir3.Create(); 


创建 了 DirectoryInfo 对 象 后 ， 就 能 使 用 任何 一 个 派生 自 FilesystemInfo 的 属性 来 获取 底层 目录 的 
内 容 。 为 了 演示 ， 创 建 一 个 新 的 控制 台 应 用 程序 DirectoryApp 并 更 新 C# 文 件 来 导 人 System.I0。 
修改 Program 类 的 静态 方法 ， 这 个 方法 创建 了 一 个 新 的 DirectoryInfo 对 象 ， 它 映射 到 C:\Windows 
( 如 果 需 要 的 话 ， 可 以 调整 路 径 )， 显 示 了 许多 相关 的 统计 信息 : 
class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Directory(Info) *****\n"); 
ShowWindowsDirectoryInfo(); 
Console.ReadLine(); 


static void ShowWindowsDirectoryInfo() 


// 转 储 目录 信息 

DirectoryInfo dir = new DirectoryInfo(@"C:\Windows"); 
Console.WritelLine("***** Directory Info *****"); 
Console.WritelLine("FullName: {0}", dir.FullName); 
Console.WriteLine("Name: {0}", dir.Name); 
Console.WritelLine("Parent: {0}", dir.Parent); 
Console.WritelLine("Creation: {0}", dir.CreationTime); 
Console.Writeline("Attributes: {0}", dir.Attributes); 
Console.WriteLine("Root: {0}", dir.Root); 
Console.WriteLine( 时 玉米 六 六 六 六 浆 闵 六 六 六 六 闵 六 六 六 六 玉米 六 六 六 冰冰 六 站 ys 


} 
你 的 输出 结果 可 能 会 不 同 ,但 是 你 应 该 能 看 到 类 似 下 面 的 信息 : 





** 冰 ** Fun with Directory(InfoO) 六 冰 水 冰冰 


+ Directory. Info. ee 
FullName: C:\Windows 

Name: Windows 

Parent: 

Creation: 7/13/2012 10:22:32 PM 
Attributes: Directory 


616 第 20 章 文件 输入 输出 和 对 和 象 序列 化 


Root: C:\ 
闵 米 米 六 六 水 玉 冰 冰冰 冰 六 六 六 六 玉米 米 冰 闵 玉 六 六 玉米 米 





20.3.1 使 用 DirectoryInfo 类 型 枚 举 出 文件 


除了 获取 已 存在 目录 的 基本 信息 外 , 我 们 还 能 使 用 DirectoryInfo 类 型 的 一 些 方法 来 扩展 当前 的 例 
子 。 首 先 ， 使 用 GetFiles() 方 法 来 获取 C:\Windows\Web\Wallpaper 目 录 下 所 有 *.jpg 文 件 的 信息 。 


说 明 ”如 果 我 们 的 机 器 没有 C:\Windows\Web\Wallpaper 目 录 ， 则 修改 代码 来 读 取 机 器 目录 里 的 文件 
(例如 从 C:\Windows 目录 读 取 所 有 的 *.bmp 文 件 )。 


GetFiles() 方 法 返回 FileInfo 类 型 的 数组 ， 每 个 FileInfo 类 型 都 包含 了 一 个 文件 的 细节 (有关 
FileInfo 类 型 的 详细 内 容 在 本 章 后 面 进行 讨论 )。 假 定 从 Main() 中 调用 了 Program 类 的 静态 方法 : 
static void DisplayImageFiles() 
DirectoryInfo dir = new DirectoryInfo(@"C:\Windows\Web\Wallpaper"); 


// 获取 所 有 *.jpg 文 件 
FileInfo[] imageFiles = dir.GetFiles("*.jpg", SearchOption.AllDirectories); 


// 我 们 找到 多 少 文件 
Console.WritelLine("Found {0} *.jpg files\n", imageFiles.Length); 


// 输出 每 个 文件 的 信息 


foreach (FileInfo f in imageFiles) 


Console .WriteLine("** 玉 六 六 永 六 水 来 水 闵 六 六 冰冰 六 冰冰 六 冰冰 六 站 六 冰 阔 ") > 


Console.WritelLine("File name: {0}", f.Name); 
Console.WriteLine("File size: {0}", f.Length); 
Console.WriteLine("Creation: {0}", f.CreationTime); 


Console.WritelLine("Attributes: {0}", f.Attributes); 
Console .WriteLine ( "六 六 六 六 六 冰 闵 闵 米 来 米 来 玉 水 闵 冰 六 冰冰 闵 来 闵 冰 六 来 阔 \ nn”) 3 


} 
} 


注意 ， 在 调用 GetFiles() 时 指定 了 搜索 选项 ( search option )。 这 样 就 可 以 查看 所 有 子 目录 。 运 行 
该 应 用 程序 ， 将 会 列 出 所 有 匹配 搜索 模式 的 文件 。 


20.3.2 ”使 用 DirectoryInfo 类 型 创建 子 目录 

我 们 能 使 用 DirectoryInfo.CreateSubdirectory() 方 法 以 编程 方式 扩展 目录 结构 。 使 用 这 个 方法 ， 
可 以 建立 一 个 子 目录 ,也 可 以 一 次 建立 多 个 散 套 子 目录 。 例如， 下 面 这 段 代码 通过 建立 一 些 自 定义 子 
目录 来 扩展 C: 的 目录 结构 : 

static void ModifyAppDirectory() 


DirectoryInfo dir = new DirectoryInfo(@"C:\"); 


// 在 应 用 程序 目录 下 创建 \MyFolder 
dir.CreateSubdirectory("MyFolder"); 
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// 在 应 用 程序 目录 下 创建 \MyFolder2\Data 
dir.CreateSubdirectory(@"MyFolder2\Data"); 


} 
如 果 从 Main() 调 用 这 个 方法 并 使 用 Windows 资 源 管 理 需 来 检查 Windows 目 录 ， 会 发 现 这 些 子 目 录 
已 被 成 功 创建 ( 如 图 20-2 所 示 )。 0 
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图 20-2 ”创建 子 目 录 
尽管 不 一 定 要 去 捕获 CreateSubdirectory() 方 法 的 返回 值 ， 但 是 需要 知道 的 是 ， 如 果 执 行 成 功 ， 
它 会 返回 表示 新 建 项 的 DirectoryInfo 类 型 。 考 虑 对 前 面 方法 的 修改 。 注意, DirectoryInfo 构 造 函 数 中 
的 点 标记 ， 它 允许 我 们 访问 应 用 程序 的 安装 点 。 
static void ModifyAppDirectory() 
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DirectoryInfo dir = new DirectoryInfo("."); 


// 在 初始 目录 下 创建 \MyFolder 
dir.CreateSubdirectory("MyFolder"); 


// 捕获 返回 的 DirectoryInfo 类 型 
DirectoryInfo myDataFolder = dir.CreateSubdirectory(@"MyFolder2\Data"); 


// 在 .MyFolder2\Data 上 输出 路 径 
Console.WritelLine("New Folder is: {0}", myDataFolder); 


20.4 ”使 用 Directory 类 型 


在 实践 过 了 DirectoryInfo 以 后 ,我 们 来 研究 Directory 类 型 。Directory 的 静态 成 员 实 现 了 由 
DirectoryInfo 定 义 的 实例 级 成 员 的 大 部 分 功能 。 前 面 说 过 ，Directory 成 员 返 回 的 是 字符 串 数 据 而 不 
是 强 类 型 的 FileInfo 和 DirectoryInfo 对 象 。 


618 第 20 章 “文件 输入 输出 和 对 象 序列 化 


为 了 演示 Directory 类 型 的 一 些 功 能 ， 最 后 一 个 辅助 函数 显示 了 所 有 映射 到 当前 计算 机 的 驱动 器 
( 通过 Directory.GetLogicalDrivers() )， 然 后 使 用 Directory.Delete() 静 态 方 法 移 除 前 面 建立 的 
\MyFolder 和 \MyFolder2\Data 子 目录 : 

static void FunWithDirectoryType() 


// 列 出 当前 电脑 的 所 有 驱动 器 

string[] drives = Directory.GetLogicalDrives(); 

Console.Writeline("Here are your drives:"); 

foreach (string s in drives) 
Console.WritelLine("--> {0} ", s); 


// 删除 前 面 建 立 的 目录 
Console.WritelLine("Press Enter to delete directories"); 


Console.ReadLine(); 
try 


Directory.Delete(@"C:\MyFolder"); 


// 第 二 个 参数 指定 你 是 否 希 望 删除 某 个 子 目 录 
Directory.Delete(@"C:\MyFolder2", true); 


} 
catch (IOException e) 


Console.WritelLine(e.Message); 


源 代 码 ”DirectoryApp 项 目的 源 代 码 位 于 Chapter 20 子 目录 下 。 


20.5 ”使 用 DriveInfo 类 类 型 


System.I0 命 名 空间 提供 了 一 个 叫做 DriveInfo 的 类 。 和 Directory.GetLogicalDrives() 相 似 ， 
DriveInfo.GetDrives() 静 态 方法 能 获取 计算 机 上 驱动 器 的 名 字 。 然 而 和 Directory.GetLogicalDrives() 
不 同 ，DriveInfo 提 供 了 许多 其 他 的 细节 ( 比如 驱动 器 类 型 、 可 用 空间 、 卷 标 等 )。 请 看 下 面 定义 在 新 
的 控制 台 应 用 程序 DriveInfoApp 中 的 Program 类 (不 要 忘记 导 人 System.I0 ): 


class Program 
static void Main(string[] args) 
Console.WritelLine("***** Fun with DriveInfo *****\n"); 


// 得 到 所 有 驱动 器 的 信息 

DriveInfo[] myDrives = DriveInfo.GetDrives(); 
// 输出 驱动 器 统计 信息 

foreach(DriveInfo d in myDrives) 


Console.WriteLine("Name: {0}", d.Name); 
Console.WritelLine("Type: {0}", d.DriveType); 


// 检查 驱动 器 是 否 已 经 准备 好 
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if(d.IsReady) 

{ 
Console.WritelLine("Free space: {0}", d.TotalFreeSpace); 
Console.WriteLine("Format: {0}", d.DriveFormat); 
Console.WriteLine("Label: {0}", d.VolumeLabel); 


Console.WriteLine(); 


Console.ReadLine(); 


} 
下 面 显示 了 可 能 的 输出 结果 : 





冰冰 炒 于 半 Fun with DriveInfoO ***** 


Name: C:\ 

Type: Fixed 

Free space: 587376394240 
Format: NTFS 

Label: Mongo Drive 


Name: D:\ 

Type: CDRom 

Name: E:\ 

Type: CDRom 

Name: F:\ 

Type: CDRom 

Name: H:\ 

Type: Fixed 

Free space: 477467508736 
Format: FAT32 
Label: My Passport 





至 此 ， 我 们 已 经 研究 了 Directory、DirectoryInfo 和 DriveInfo 类 的 一 些 重要 的 行为 属性 。 下 一 步 
学 习 如 何 创 建 、 打 开 、 关 闭 和 删除 填充 到 指定 目录 中 的 文件 。 


源 代 码 ”DriveInfoApp 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 


20.6 使 用 FileInfo 类 


从 DirectoryApp 例 子 中 可 以 看 到 ,FileInfo 类 能 让 我 们 获得 硬盘 上 现 有 文件 的 详细 信息 ( 创建 时 间 、 
大 小 、 文 件 特性 等 )， 并 帮助 我 们 创建 、 复 制 、 移 动 和 删除 文件 。 除 了 从 FileSystemInfo 继 承 的 一 些 功 
能 外 ， 表 20-4 列 出 了 一 些 FileInfo 类 独 有 的 核心 成 员 。 
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表 20-4 ”FileInfo 核 心 成 员 


成 员 作 用 
AppendText() 创建 一 个 StreamWriter 类 型 ( 后 面 会 讨论 ) ， 它 用 来 向 文件 追加 文本 
CopyTo() 将 现 有 文件 复制 到 新 文件 
Create() 创建 一 个 新 文件 并 且 返 回 一 个 Filestream 类 型 ( 后 面 会 讨论 ) ， 通 过 它 来 和 新 创建 的 文件 进行 
交互 
CreateText() 创建 一 个 写 入 新 文本 文件 的 StreamWriter 对 象 
Delete() 删除 FileInfo 实 例 绑 定 的 文件 
Directory 获取 父 目录 的 实例 
DirectoryName 获取 父 目录 的 完整 路 径 
Length 获取 当前 文件 的 大 小 
MoveTo() 将 指定 文件 移 到 新 位 置 ， 并 提供 指定 新 文件 名 的 选项 
Name 获取 文件 名 
Open() 用 各 种 读 / 写 访问 权限 和 共享 特权 打开 文件 
OpenRead() 创建 只 读 FileStream 对 象 
OpenText() 创建 从 现 有 文本 文件 中 读 取 数 据 的 StreamReader ( 后 面 会 讨论 ) 
OpenWrite() 创建 只 写 FileStream 类 型 





注意 ,大 部 分 FileInfo 类 的 成 员 返回 一 个 IO 相关 的 特定 对 象 ( Filestream 和 StreamWriter 等 )， 让 
我 们 以 不 同 格式 从 关联 文件 读 或 向 关联 文件 写 数 据 。 下 面 会 谈 到 这 些 类 型 ， 不 过 现在 先 来 研究 使 用 
FileInfo 类 类 型 来 获取 一 个 文件 句柄 的 各 种 方法 。 


20.6.1 FileInfo.Create() 方 法 
第 一 种 建立 文件 句柄 的 方法 是 使 用 FileInfo.Create() 方 法 : 


static void Main(string[] args) 


{ 
// 在 C 盘 新 建 一 个 文件 
FileInfo f = new FileInfo(@"C:\Test.dat"); 
FileStream fs = f.Create(); 


// 使 用 FileStream 对 象 


// 关闭 文件 流 
fs.Close(); 


需要 注意 的 是 ，FileInfo.Create() 方 法 返回 一 个 Filestream 对 象 ，Filestream 能 对 基层 的 文件 进 
行 同步 /异步 的 读 / 写 操作 。 需要 知道 的 是 , FileInfo.Create() 返 回 的 FileStream 对 象 给 所 有 的 用 户 授 予 
完全 读 写 操作 权限 。 

还 要 注意 ， 在 使 用 了 当前 FileStream 对 象 之 后 ， 要 确保 关闭 句柄 来 释放 流 的 底层 非 托管 资源 。 由 
于 FileStream 实 现 了 IDisposable， 所 以 我 们 可 以 使 用 C# 的 using 域 来 让 编译 器 生成 释放 催 辑 ( 详 见 
第 8 章 ) 。 
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static void Main(string[] args) 


// 最 好 为 1/O 类 型 定义 Using 域 
FileInfo f = new FileInfo(@"C:\Test.dat"); 
using (FileStream fs = f.Create()) 


// 使 用 FileStream 对 象 


} 


20.6.2 ”FileInfo.0pen() 方 法 


我 们 能 使 用 FileInfo.0pen() 方 法 来 打开 现 有 文件 ， 同 时 也 能 使 用 它 来 创建 新 文件 ， 它 比 
FileInfo.Create() 多 了 很 多 细节 , 因为 0pen() 通 常 有 好 几 个 参数 , 可 以 限定 所 操作 的 文件 的 整体 结构 。 
一 旦 调用 0pen() 完 成 后 ， 它 返回 一 个 FileSstream 对 象 ， 请 看 下 面 代 码 : 


static void Main(string[] args) 


// 通过 FileInfo.0pen() 创 建新 文件 

FileInfo f2 = new FileInfo(@"C:\Test2.dat"); 

using(FileStream fs2 = f2.0pen(FileMode.OpenOrCreate, 
FileAccess.ReadWrite, FileShare.None)) 


// 使 用 FileStream 对 象 


} 


上 面 的 重 载 0pen() 方 法 需要 3 个 参数 。 第 一 个 参数 指定 IO 请 求 的 基本 方式 ( 比如 说 新 建文 件 、 
开 现 有 文件 和 追加 文件 等 )， 它 的 值 由 FileMode 枚 举 指 定 ( 详情 参见 表 20-5 ): 


public enum FileMode 


3 





CreateNew, 

Create, 

Open, 

OpenOrCreate, 

Truncate, 

Append 

表 20-5 ”FileMode 枚 举 的 成 员 

成 员 作 用 
CreateNew 通知 操作 系统 新 建文 件 。 如 果 存 在 ， 就 会 抛 出 IOException 
Create 通知 操作 系统 新 建文 件 。 如 果 存 在 ， 就 会 被 覆盖 
Open 打开 既 有 文件 。 如 果 文 件 不 存在 ， 就 会 抛 出 FileNotFoundException 
OpenOrCreate 如 果 文 件 存 在 ， 则 打开 ， 否 则 新 建文 件 
Truncate 打开 文件 并 截断 文件 为 0 字 节 大 小 
Append 打开 文件 ， 移 动 到 文件 尾部 ， 开 始 写 操作 〈 这 个 标识 只 能 和 只 写 流 一 起 使 用 )。 如 果 文 件 


不 存在 ， 则 新 建文 件 
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第 二 个 参数 的 值 由 FileAccess 枚 举 定义 ， 用 来 决定 基层 流 的 读 写 行 为 : 
public enum FileAccess 


Read, 
Write, 
ReadWrite 


最 后 ， 第 三 个 参数 FileShare 指 定 文件 在 其 他 文件 处 理 程序 中 的 共享 方式 。 下 面 是 一 些 主要 成 员 : 
public enum FileShare 

Delete, 

Inheritable, 

None, 

Read, 

ReadWrite, 

Write 


} 


20.6.3 ”FileInfo.0penRead() 和 FileInfo.0penWrite() 方 法 


FileInfo.0pen() 方 法 能 让 我 们 用 非常 灵活 的 方式 获取 文件 句柄 ，FileInfo 类 同样 提供 了 openRead() 
和 0penWrite() 成 员 。 读 者 可 能 也 想到 了 ,这 些 方法 不 需要 提供 各 种 枚 举 值 ， 就 能 返回 一 个 正确 配置 的 
只 读 或 只 写 的 Filestream 类 型 。 和 FileInfo.Create() 、FileInfo.0pen() 方 法 一 样 ，0penRead() 和 
OpenWrite() 也 都 返回 一 个 Filestream 对 象 ( 假定 你 的 C 盘 上 有 名 为 Test3.dat 和 Test4.dat 的 文件 ): 


static void Main(string[] args) 


// 得 到 一 个 只 读 的 FileStream 对 象 
FileInfo f3 = new FileInfo(@"C:\Test3.dat"); 
using(FileStream readOnlyStream = f3.0penRead()) 


// 使 用 FileStream 对 象 


// 得 到 一 个 只 写 的 FileStream 对 象 

FileInfo f4 = new FileInfo(@"C:\Test4.dat"); 

using(FileStream writeOnlyStream = f4.0penWrite()) 
// 使 用 FileStream 对 象 ……… 


} 


20.6.4 FileInfo.0penText() 方 法 


FileInfo 类 型 另外 一 个 “Open” 成 员 是 0penText()。 和 Create() 、0pen() 、0penRead() 、0penwWrite() 
方法 不 同 ，0penText() 方 法 返回 的 是 一 个 StreamReader 类 型 ( 而 不 是 FileStream 类 型 ) 的 实例 。 假 定 你 
的 C 盘 中 有 名 为 boot.ini 的 文件 ， 可 以 用 以 下 方法 访问 其 中 的 内 容 : 

static void Main(string[] args) 


// 得 到 一 个 StreamReader 对 象 
FileInfo f5 = new FileInfo(@"C:\boot.ini"); 
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using(StreamReader sreader = f5.0penText()) 
// 使 用 StreamReader 对 象 …… 


} 
马上 就 会 看 到 ，StreamReader 类 型 提供 了 从 基层 文件 读 取 字 符 数 据 的 方法 。 


20.6.5 ”FileInfo.CreateText() 和 FileInfo.AppendText() 方 法 


最 后 需要 指出 的 两 个 方法 是 CreateText() 和 AppendText()， 它 们 都 返回 一 个 StreamWriter 对 象 ， 代 
但 如 下 : 


static void Main(string[] args) 


FileInfo f6 = new FileInfo(@"C:\Test6.txt"); 
using(StreamWriter swriter = f6.CreateText()) 


// 使 用 StreamWriter 对 象 


FileInfo f7 = new FileInfo(@"C:\FinalTest.txt"); 
using(StreamWriter swriterAppend = f7.AppendText()) 


// 使 用 StreamWriter 对 象 


} 
读者 可 能 猿 到 了 ，StreamWriter 类 型 提供 向 基层 文件 写 人 字符 数据 的 方法 。 


20.7 使 用 File 类 型 


File 类 型 的 静态 成 员 提供 了 和 FileInfo 类 型 差不多 的 功能 。 与 FileInfo 类 似 ，File 类 提供 了 
AppendText() 、Create() 、CTeateText() 、0pen() 、0penRead() 、0penWrite() 和 0penText() 方 法 。 其 实 ， 
在 大 多 数 情况 下 ，File 和 FileInfo 类 型 能 互 换 使 用 。 例 如 ， 前 面 每 一 个 FileSstream 示 例 都 可 以 用 File 
类 型 来 简化 : 

static void Main(string[] args) 


// 通过 File.Create() 获 取 FileStream 对 象 
using(FileStream fs = File.Create(@"C:\Test.dat")) 
{} 


// 通过 File.0pen() 获 取 FileStream 对 象 
using(FileStream fs2 = File.Open(@"C:\Test2.dat", 
FileMode.OpenOrCreate, 
FileAccess.ReadWrite, FileShare.None)) 


{} 


// 得 到 一 个 只 读 权 限 的 FileStream 对 象 
using(FileStream readOnlyStream = File.OpenRead(@"Test3.dat")) 
{} 


// 得 到 一 个 只 写 权限 的 FileStream 对 象 
using(FileStream writeOnlyStream = File.OpenWrite(@"Test4.dat")) 


{} 


624 第 20 章 “文件 输入 输出 和 对 象 序列 化 


// 得 到 一 个 StreamReader 对 象 


using(StreamReader sreader = File.OpenText(@"C:\boot.ini")) 


{} 
// 得 到 一 些 StreamWriter 对 象 


using(StreamWriter swriter = File.CreateText(@"C:\Test6.txt")) 
{} 


using(StreamWriter swriterAppend = File.AppendText(@"C:\FinalTest.txt")) 
人 


File 类 型 提供 了 一 些 独 有 的 成 员 ， 表 20-6 列 举 了 其 中 的 一 些 成 员 ， 它 们 可 以 极 大 地 简化 读 写 文本 


表 20-6 ”File 类 型 的 方法 


有 
其 他 File 成 员 
数据 的 过 程 。 
方 法 

ReadAllBytes() 打开 指定 文件 ， 
ReadAllLines() 打开 指定 文件 ， 
ReadAllText() 打开 指定 文件 ， 
WriteAllBytes() 打开 指定 文件 ， 
WriteAllLines() 打开 指定 文件 ， 
WriteAllText() 打开 指定 文件 ， 


作 用 
以 字 节 数组 形式 返回 二 进 制 数据 ， 然 后 关闭 文件 
以 字符 串 数 组 形式 返回 字符 数据 ， 然 后 关闭 文件 
以 System.String 形 式 返 回 字 符 数 据 ， 然 后 关闭 文件 
写 人 字 节 数组 ， 然 后 关闭 文件 
写 人 字符 串 数 组 ， 然 后 关闭 文件 
写 人 字符 数据 ， 然 后 关闭 文件 


使 用 File 类 型 的 这 些 新 方法 ， 只 用 几 行 代码 就 可 以 批量 读 写 数 据 。 更 好 的 是 ， 每 一 个 成 员 都 自动 
关闭 基层 文件 句柄 。 例如 ,下面 的 控制 台 程序 SimpleFileIO 能 轻松 地 将 字符 串 数据 保存 到 C 盘 的 新 文件 
里 ， 并 将 其 读 人 内存 中 《本 例假 设 已 经 导 人 System.I0 ): 


class Program 


static void Main(string[] args) 


Console.WritelLine("***** Simple I/O with the File Type *****\n"); 


string[] myTasks = { 
"Fix bathroom sink", "Call Dave", 
"Call Mom and Dad", "Play Xbox 360"}; 


// 向 C 盘 的 文件 写 入 所 有 数据 


File.WriteAllLines(@"C:\tasks.txt", myTasks); 


// 重新 读 取 然后 输出 


foreach (string task in File.ReadAllLines(@"C:\tasks.txt")) 


Console.WritelLine("TODO: {0}", task); 


Console.ReadLine(); 
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很 明显 ， 如 果 你 希望 快速 获取 文件 句柄 的 话 ， 使 用 File 类 型 能 节省 很 多 代码 。 然 而 使 用 前 面 提 到 
的 FileInfo 对 象 的 好 处 是 能 从 FilesystemInfo 抽 象 基 类 定义 的 成 员 中 获取 文件 属性 。 





源 代 码 ”SimpleFileIO 项 目的 源 代 码 位 于 Chapter 20 子 目录 下 。 


20.8 ” Stream 抽象 类 


至 此 ， 我 们 知道 了 许多 获取 FileSstream、StreamReader 和 StreamWriter 对 象 的 方法 ,但 是 还 没 
有 使 用 这 些 对 象 从 文件 读 取 数据 或 者 向 文件 写 和 数据。 为 了 理解 怎样 去 做 ， 首 先 需 要 了 解 “ 流 ”的 
概念 。 在 IO 操作 中 , 流 代表 了 在 源 文件 和 目标 文件 之 间 传 输 的 一 定量 的 数据 ,无 论 使 用 什么 设备 ( 文 
件 、 网 络 连 接 和 打印 机 等 ) 存储 或 者 显示 字 节 ,“ 流 ”都 能 提供 一 种 通用 的 方式 来 和 字 节 队列 进行 
交 瑶 as 

抽象 类 System.I0.Stream 定 义 了 许多 成 员 来 提供 对 存储 媒介 ( 比如 基层 的 文件 或 内 存 地 址 ) 实现 
同步 或 异步 交互 的 支持 。 


说 明 “ 流 ” 的 概念 不 仅仅 局 限于 文件 输入 /输出 。.NET 类 库 提 供 了 “ 流 ” 来 访问 网 络 、 内 存 地 址 和 其 
他 一 些 与 流 相 关 的 抽象 设备 。 


Stream 派 生 类 型 把 数据 表现 为 原始 的 字 节 流 , 因 此 ,使 用 原始 的 Stream 类 型 有 点 模糊 ,一 些 从 Stream 
派生 的 类 型 支持 寻 址 ( 指 获取 和 调整 当前 在 流 中 位 置 的 过 程 )。 要 理解 stream 类 提供 的 功能 , 可 以 先 看 
看 表 20-7 列 举 的 一 些 主要 成 员 。 


表 20-7 抽象 5stream 成 员 


成 员 作 用 

CanRead、CanWrite 和 CanSeek 检测 当前 流 是 否 支持 读 、 寻 址 和 写 

Close() 关闭 当前 流 并 释放 与 之 关联 的 所 有 资源 ( 如 套 接 字 和 文件 句柄 ) 。 在 内 部 ， 这 
个 方法 是 Dispose() 方 法 的 别名 ， 因 此 “关闭 流 ” 从 功能 上 说 等 价 于 “释放 流 ” 

Flush() 使 用 当前 的 缓冲 状态 更 新 基层 的 数据 源 或 储存 库 。 如 果 流 不 实现 缓冲 ， 这 个 方 
法 什么 都 不 做 

Length 返回 流 的 长 度 ， 以 字 节 来 表示 

Position 检测 在 当前 流 中 的 位 置 

Read() 和 ReadByte() 从 当前 流 读 取 字 节 序列 (或 一 个 字 节 )， 并 将 此 流 中 的 位 置 偏 移 读 取 的 字 节 数 

Seek() 设置 当前 流 中 的 位 置 

SetLength() 设置 当前 流 的 长 度 

Write() 和 WriteByte() 向 当前 流 中 写 入 字 节 序列 ( 或 一 个 字 节 )， 并 将 此 流 中 的 当前 位 置 偏 移 写 人 的 


字 节 数 
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使 用 FileStream 


Filestream 类 以 合适 的 方式 为 基于 文件 的 流 提供 了 抽象 stream 成 员 的 实现 。 这 是 一 个 相当 原始 的 
流 ， 它 只 能 读 取 或 写 人 一 个 字 节 或 者 字 节 数组 。 其 实 ， 我 们 通常 不 需要 直接 和 FileStream 类 型 的 成 员 
交互 ， 而 是 使 用 各 种 Stream 包 装 类 ， 它 们 能 更 方便 地 处 理 文本 数据 和 .NET 类 型 。 为 了 说 明 ， 让 我 们 体 
验 一 下 Filestream 类 型 的 同步 读 写 能 力 。 

新 建 一 个 名 为 FileStreamApp 的 控制 台 应 用 程序 ， 并 将 System.I0 和 System.Text 导 和 到 初始 的 C# 代 
码 文 件 中 。 目 标 是 把 一 段 简单 的 文字 信息 写 人 一 个 新 建 的 文件 nyMessage.dat。 然 而 ， 因 为 FileStream 

只 能 处 理 原 始 字 节 ， 我 们 必须 把 System.String 编 码 成 相应 的 字 节 数组 。 幸 好 System.Text 命 名 空间 定 
义 了 一 个 Encoding 类 型 ， 它 提供 了 一 些 成 员 , 来 实现 在 字符 串 和 字 节 数组 之 间 的 编码 /解码 操作 ( 请 查 
看 .NET Framework 4.5 SDK 文 档 ， 了 解 Encoding 类 型 的 完整 细节 )。 

编码 完成 后 ， 使 用 Filestream.Write() 方 法 把 字 节 数组 保存 到 文件 内 。 如 果 要 把 这 些 字 节 读 回 内 
存 ， 还 需要 ( 通过 Position 属 性 ) 重 置 流 内 部 的 位 置 ， 然 后 调用 ReadByte() 方 法 。 最 后 ， 可 以 在 控制 
台 上 显示 这 些 原始 字 节 或 者 解码 过 的 字符 串 。 下 面 是 完整 的 Main() 方 法 : 

// 不 要 忘记 导入 System.Text 和 System.I0 命 名 空间 


static void Main(string[] args) 


{ 


Console.WritelLine("***** Fun with FileStreams *****\n"); 


// 获取 一 个 FileStream 对 象 
using(FileStream fStream = File.Open(@"C:\myMessage.dat", 
FileMode.Create)) 


{ 
// 把 字符 囊 编码 成 字 节 数组 
string msg = "Hello!"; 
byte[] msgAsByteArray = Encoding.Default.GetBytes(msg); 


// 把 byte[] 写 入 文件 
fstream.Write(msgAsByteArray, 0, msgAsByteArray.Length); 


// 重 置 流 内 部 的 位 置 
fStream.Position = 0; 


// 从 文件 读 取 字 节 并 显示 在 控制 台 

Console.Write("Your message as an array of bytes: "); 
byte[ ] bytesFromFile = new byte[msgAsByteArray.Length]; 
for (int i = 0; i < msgAsByteArray.Length; i++) 


bytesFromFile[i] = (byte)fStream.ReadByte(); 


Console.Write(bytesFromFile[i]); 


// 显示 解码 后 的 字符 囊 
Console.Write("\nDecoded Message: "); 
Console.Writeline(Encoding.Default.GetString(bytesFromFile)); 


} 
Console.ReadLine(); 


然而 ， 这 个 例子 在 演示 把 数据 填充 进 文件 的 同时 ， 也 体现 出 了 直接 使 用 Filestream 类 型 的 缺点 : 
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需要 操作 原始 字 节 。 其 他 从 Stream 派 生 的 类 型 也 差不多 。 比 如 , 如 果 想 向 一 段 内 存 写 人 字 节 队列 的 话 ， 
可 以 使 用 MemoryStream。 同样 , 如 果 想 向 网 络 连接 压 入 字 节 数组 的 话 , 可 以 使 用 NetworkStream 类 型 (在 
System.Net.Sockets 命 名 空间 中 )。 

前 面 提 到 过 , System.I0 命 名 空间 提供 了 一 些 读 取 器 和 编写 器 类 型 来 封装 从 Stream 派 生 的 类 型 的 一 
些 细节 。 





源 代码 ”FileStreamApp 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 
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当 需 要 读 写 基于 字符 的 数据 ( 比如 字符 串 ) 的 时 候 ，StreamWriter 和 StreamReader 类 就 非常 有 用 
了 。 它 们 都 默认 使 用 Unicode 字 符 ， 当 然 我 们 也 可 以 提供 一 个 正确 配置 的 System.Text.Encoding 对 象 引 
用 来 改变 默认 配置 。 为 了 使 例子 更 简单 ， 假 设 默 认 的 Unicode 编 码 能 满足 我 们 的 需求 。 

StreamReader 和 相关 的 StringReader 类 型 ( 本 章 后 面 会 讨论 ) 一 样 ， 它 们 都 从 TextReader 抽 象 类 型 
派生 。TextReader 基 类 为 这 些 派 生 类 型 提供 了 一 套 非常 有 限 的 功能 ， 特 别 是 读 取 字 符 流 。 

StreamWriter 类 型 ( 和 后 面 会 讨论 的 StringWriter 一 样 ) 从 TextWriter 抽 象 基 类 派生 。 这 个 类 定义 
了 一 些 成 员 ， 使 得 派生 的 类 型 能 向 某 个 字符 流 写 人 文本 数据 。 

为 了 帮助 读者 理解 streamWriter 和 StringWriter 类 主要 的 功能 ， 表 20-8 列 举 了 一 些 TextWriter 抽 象 
基 类 的 核心 成 员 。 


表 20-8 TextWriter 核 心 成 员 


成 员 作 用 
个 成 员 在 功能 上 等 同 于 调用 Dispose() 方 法 ) 
Flush() 清理 当前 编写 器 的 所 有 缓冲 区 ， 使 所 有 缓冲 数据 写 入 基础 设备 ， 但 是 不 关闭 编写 器 
NewLine 代表 派生 的 编写 器 类 的 行 结束 符 字符 串 。 默 认 行 结束 符 字符 串 是 回 车 符 后 接 一 个 换行 符 〈\r\n ) 
Mrite() 这 个 重 载 的 方法 将 一 行 写 人 文本 流 ， 不 跟 行 结束 符 


WriteLine() 这 个 重 载 的 方法 将 一 行 写 人 文本 流 ， 后 跟 行 结束 符 


说 明 TextWriter 类 的 最 后 两 个 成 员 可 能 对 读者 来 说 很 熟悉 。 前 面 说 过 ，System.Console 类 型 就 有 
Write() 和 WriteLine() 成 员 来 向 标准 输出 设备 写 入 文本 数据 。 其 实 ，Console.In 属 性 包装 了 一 
个 TextWriter，Console.0ut 属 性 包装 了 一 个 TextReader，, 


派生 的 StreamWriter 类 提供 了 对 Write() 、Close() 和 Flush() 方 法 的 有 效 实 现 ， 而 且 还 定义 了 
AutoFlush 属 性 。 如 果 把 这 个 属性 设置 为 true 的 话 ，StreamWriter 会 在 每 次 执行 一 个 写 操作 后 ， 立 即 写 
和 数据 并 清理 缓冲 区 。 设 置 AutoFlush 为 false 能 获得 更 好 的 性 能 , 这 样 的 话 , 使 用 StreamWriter 完 成 写 
操作 后 需要 调用 Close() 。 
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20.9.1 ” 写 文本 文件 


现在 举 一 个 使 用 streamWriter 类 型 的 例子 ,创建 一 个 新 的 控制 台 应 用 程序 StreamWriterReaderApp 
并 且 导 入 System.I0 命 名 空间 。 下 面 的 Main() 方 法 使 用 File.CreateText() 方 法 新 建 一 个 reminders.txt 文 
件 。 使 用 返回 的 StreamWriter 对 象 向 新 建 的 文件 增加 一 些 文本 数据 ， 代 码 如 下 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with StreamWriter / StreamReadeI *****\n"); 


// 得 到 一 个 StreamWriter 对 象 并 写 入 字符 囊 数 据 
using(StreamWriter writer = File.CreateText("reminders.txt")) 


writer.WritelLine("Don't forget Mother's Day this year..."); 
writer.WriteLine("Don't forget Father's Day this year..."); 
writer.WritelLine("Don't forget these numbers:"); 
for(int i = 0; i < 10; i++) 

writer.Write(i + " "); 


// 插入 一 个 新 行 
writer.Write(writer.NewLine); 


Console.WriteLine("Created file and wrote some thoughts..."); 
Console.ReadLine(); 


运行 程序 来 检查 新 建文 件 的 内 容 ( 如 图 20-3 所 示 )。 因为 在 调用 CreateText() 时 没有 指定 完整 路 径 ， 
所 以 将 会 在 当前 应 用 程序 的 bin\Debug 文 件 夹 下 找到 这 个 新 文件 。 


reminders.bt 二 X Program.cs v 
bon't forget Mother's Day this year... 李 
Don't forget Father's Day this year... 2 
Don 't forget these numbers: 司 
8123456789 三 









| 
(00% ~ < brennan ' | 


图 20-3 *.txt 文 件 的 内 容 





20.9.2” 读 文本 文件 


现在 需要 理解 怎样 使 用 相应 的 StreamReader 类 型 通过 编程 从 文件 读 取 数据 。 前 面 说 过 ， 这 个 类 从 
TextReader 派 生 ， 表 20-9 列 举 了 一 些 它 的 功能 。 
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表 20-9 TextReader 主 要 成 员 











成 ” 员 作 用 

Peek() 返回 下 一 个 可 用 字符 ， 而 不 更 改 读 取 器 位 置 。 返 回 -1 表示 已 经 到 了 流 的 尾部 
Read() 从 输入 流 中 读 取 数据 

ReadBlock() 从 当前 流 中 读 取 最 大 计数 字符 ， 并 从 索引 开始 将 该 数据 写 入 缓冲 区 
ReadLine() 从 当前 流 中 读 取 一 行 字符 ， 并 将 数据 作为 字符 串 返 回 ( 返回 空 字符 串 代 表 EOF ) 
ReadToEnd() 读 取 从 当前 位 置 到 流 结尾 的 所 有 字符 ， 并 将 它们 作为 一 个 字符 串 返回 


如 果 扩 展 当 前 的 MyStreamWriterReader 类 来 使 用 StreamReader， 可 以 从 reminders.txt 读 取 文 本 数据 ， 
代码 如 下 : 
static void Main(string[] args) 
Console.WritelLine("***** Fun with StreamWriter / StreamReader *****\n"); 
// 现在 开始 从 文件 读数 据 
Console.WriteLine("Here are your thoughts:\n"); 


using(StreamReader sr = File.OpenText("reminders.txt")) 


string input = null; 
while ((input = sr.ReadLine()) != null) 


Console.WriteLine (input); 


Console.ReadLine(); 


= 一 


运行 程序 后 ， 会 发 现 reminders.txt 里 的 字符 数据 显示 到 了 控制 台 。 
20.9.3 ”直接 创建 StreamWriter/StreamReader 类 型 


可 能 读者 还 有 一 点 困惑 , 那 就 是 使 用 System.I0 的 这 些 类 型 可 以 有 很 多 种 方法 实现 相同 的 结果 。 比 
如 ,我 们 可 以 使 用 File 或 者 FileInfo 类 型 的 CreateText() 方 法 来 获取 StreamWriter。 其 实 ,， 还 有 一 个 方 
法 来 使 用 streamWriter 和 StreamReader: 直接 创建 它们 。 例 如 ， 现 在 的 应 用 程序 可 以 进行 如 下 修改 : 


static void Main(string[] args) 
Console.Writeline("***** Fun with StreamWriter / StreamReader *****\n"); 
// 得 到 一 个 StreamWriter， 然 后 写字 符 事 数据 
using(StreamWriter writer = new StreamWriter("reminders.txt")) 
} ee 
// 从 文件 读 取 数据 


using(StreamReader sr = new StreamReader("reminders.txt")) 
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使 用 这 么 多 看 上 去 差不多 的 方法 实现 文件 1/O 操 作 虽 说 让 我 们 有 点 困惑 ,但 是 这 样 的 确 增加 了 很 多 
灵活 性 。 我 们 已 经 看 到 了 怎样 使 用 streamWriter 和 StreamReader 类 从 指定 文件 写 和 信 、 读 取 人 信息。 下面 
再 来 研究 stringWriter 和 StringReader 类 型 的 作用 。 


源 代码 ”StreamWriterReaderApp 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 


20.10 使 用 StringWriter 和 StringReader 类 型 


使 用 stringWriter 和 StringReader 类 型 我 们 可 以 将 文本 信息 当做 内 存 中 的 字符 一 样 来 处 理 。 当 
想 为 基层 缓冲 区 添加 基于 字符 的 信息 的 时 候 ， 它 们 就 非常 有 用 。 在 下 面 的 控制 台 应 用 程序 String 
ReaderWriterApp 中 ， 我 们 向 一 个 StringWriter 对 象 ( 而 不 是 在 本 地 硬盘 上 的 一 个 文件 ) 写 和 一段 字符 
串 信 息 : 


static void Main(string[] args) 
Console.WritelLine("***** Fun with StringWriter / StringReader *****\n"); 


// 创建 一 个 StringWriter 并 把 字符 数据 写 入 内 存 


using(StringWriter strWriter = new StringWriter()) 


strWriter.WriteLine("Don't forget Mother's Day this year..."); 


// 获取 内 容 副 本 (存储 在 字符 囊 中 ) 并 向 控制 台 输 出 
Console.WriteLine("Contents of StringWriter:\n{0}", strWriter); 


Console.ReadLine(); 


因为 stringWriter 和 StreamWriter 都 从 一 个 基 类 ( TextWriter ) 派生 ， 它 们 的 写 操作 逻辑 代码 或 多 
或 少 有 点 相同 。 但 需要 知道 ，StringNriter 还 有 一 个 特点 ， 那 就 是 它 能 通过 GetStringBuilder() 方 法 来 
获取 一 个 System.Text.StringBuilder 对 象 : 

using (StringWriter strWriter = new StringWriter()) 


strWriter.WritelLine("Don't forget Mother's Day this year..."); 
Console.WriteLine("Contents of StringWriter:\n{0}", strWriter); 


// 得 到 内 部 的 StringBuilder 

StringBuilder sb = strWriter.GetStringBuilder(); 
sb.Insert(0, "Hey!! "); 

Console.WritelLine("-> {0}", sb.ToString()); 
sb.Remove(0, "Hey!! ".Length); 
Console.WritelLine("-> {0}", sb.ToString()); 


可 使 用 相应 的 StringReader 类 型 从 字符 数据 流 中 读 取 信息 ， 可 以 看 到 ， 实 现 方 法 和 相关 的 
StreamReader 类 型 差不多 。 其 实 ，StringReader 类 型 只 不 过 是 通过 重 写 派生 的 成 员 来 从 一 段 字符 数据 而 
不 是 从 一 个 文件 中 读 取信 息 ， 代 码 如 下 : 


using (StringWriter strWriter = new StringWriter()) 
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strWriter.WritelLine("Don't forget Mother's Day this year..."); 
Console.WriteLine("Contents of StringWriter:\n{0}", strWriter); 


// 从 StringWriter 读 取 数 据 
using (StringReader strReader = new StringReader(strWriter.ToString())) 


string input = null; 
while ((input = strReader.ReadLine()) != null) 


Console.WriteLine(input); 





源 代 码 StringReaderWriterApp 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 





20.11 使 用 BinaryWriter 和 BinaryReader 


最 后 研究 的 读 取 器 /编写 器 组 是 BinaryReader 和 BinaryWriter， 它 们 都 从 System.0bject 直 接 派生 。 
这 些 类 型 可 以 让 我 们 从 基层 流 中 以 简洁 的 二 进 制 格式 读 取 或 写 人 离散 数据 类 型 。BinaryWriter 类 型 定 
义 了 一 个 多 次 重 载 的 Write() 方 法 ， 用 于 把 数据 类 型 写 人 基层 的 流 。 除 了 Write() 方 法 ，BinaryWriter 
还 提供 了 另外 一 些 成 员 让 我 们 能 获取 或 设置 从 Stream 派 生 的 类 型 ,并且 提 供 了 随机 数据 访问 的 支持 ( 如 
表 20-10 所 示 )。 


表 20-10 ”BinaryWriter 核 心 成 员 





成 ” 员 作 用 

BasestTeam 这 个 只 读 属 性 提供 了 BinaryWriter 对 象 使 用 的 基层 流 的 访问 
Close() 这 个 方法 关闭 二 进 制 流 

Flush() 这 个 方法 刷新 二 进 制 流 

Seek() 这 个 方法 设置 当前 流 的 位 置 

Write() 这 个 方法 将 值 写 入 当前 流 


BinaryReader 类 补充 了 BinaryWriter 的 功能 ， 表 20-11 列 出 了 其 中 的 一 些 成 员 。 


表 20-11 BinaryReader 核 心 成 员 





成 员 作 用 
BaseStream 这 个 只 读 属性 提供 了 对 BinaryReader 对 象 使 用 的 基层 流 的 访问 
Close() 这 个 方法 关闭 二 进 制 阅读 器 
PeekChar() 这 个 方法 返回 下 一 个 可 用 的 字符 ， 并 且 不 改变 指向 当前 字 节 或 字符 的 指针 位 置 
Read() 读 取 给 定 的 字 节 或 字符 ， 并 把 它们 存 人 数组 
ReadXXXX() BinaryReader 类 定义 了 许多 Read() 方 法 来 从 流 中 获取 下 一 个 类 型 ( ReadBoolean() 、ReadByte() 


和 ReadInt32() 等 ) 
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下 面 的 控制 台 应 用 程序 BinaryWriterReader 新 建 了 一 个 *.dat 文 件 并 且 写 人 了 一 些 数据 类 型 ; 
static void Main(string[] args) 
Console.WriteLine("***** Fun with Binary Writers / Readers *****\n"); 


// 为 文件 打开 一 个 二 进 制 编写 器 

FileInfo f = new FileInfo("BinFile.dat"); 
using(BinaryWriter bw = new BinaryWriter(f.OpenWrite())) 
{ 


// 输出 BaseStream 的 类 型 (这 里 是 System.I0.FileStTeam) 
Console.WriteLine("Base stream is: {0}", bw.BaseStream); 


// 在 文件 中 存储 一 些 数据 
double aDouble = 1234.67; 
int anInt = 34567; 

string aString = "A, B, C"; 


// 写 数据 
bw.Write(aDouble); 
bw.Write(anInt); 
bw.Write(aString); 


Console.WritelLine("Done!"); 
Console.ReadLine(); 


注意 ， 从 FileInfo.0penWrite() 返 回 的 FileStream 对 象 被 传 到 BinaryWriter 类 型 的 构造 函数 中 。 使 
用 这 项 技术 ， 就 能 很 方便 地 在 写 人 数据 前 引入 一 个 流 。 需 要 理解 的 是 ，BinaryWriter 构 造 函 数 能 接受 
任何 派生 自 Stream 类 型 的 参数 ( 比如 FileSstream、MemoryStream 或 BufferedStream )。 因 此 ， 如 果 希 望 
向 内 存 中 写 二 进 制 信息 的 话 ， 只 需 提 供 一 个 有 效 的 MemoryStream 对 象 即 可 。 

BinaryReader 类 型 提供 了 很 多 选项 来 从 BinFile.dat 文 件 中 读 取 数据 。 在 这 里 ,我 们 通过 调用 与 读 相 
关 的 成 员 来 检测 流 中 的 数据 : 


static void Main(string[] args) 


FileInfo f = new FileInfo("BinFile.dat"); 


“7/ 从 流 中 读 取 二 进 制 数据 
using(BinaryReader br = new BinaryReader(f.OpenRead())) 
{ 


Console.WritelLine(br.ReadDouble()); 
Console.WriteLine(br.ReadInt32() ); 
Console.WritelLine(br.ReadString()); 


Console.ReadLine(); 





源 代 码 ”BinaryWriterReader 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 


20.12 ”以 编程 方式 “观察 ”文件 
现在 知道 了 各 种 读 取 器 和 编写 器 的 用 法 ,下 面 看 看 FileSystemWatchezr 类 的 作用 。 当 我 们 想 通过 编 
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程 监控 ( 或 者 观察 ) 系统 上 的 文件 的 时 候 , 这 个 类 就 非常 有 用 。 特别 是 , 我 们 能 通过 System.IO.Notify- 
ert Rrentenatte re (大 多 数 成 员 都 能 通过 字面 了 解 其 含 
， 详 细 信 息 请 参考 .NET Framework 4.5 SDK 文 档 ): 


public enum NotifyFilters 


Attributes, CreationTime, 
DirectoryName, FileName, 
LastAccess, LastWrite, 
Security, Size 


使 用 FileSystemWatcher 类 型 的 第 一 步 是 设置 Path 属 性 ， 以 指定 需要 监控 的 文件 所 在 文件 夹 的 名 字 
(或 者 位 置 )， 还 有 就 是 定义 需要 监控 文件 的 扩展 名 的 Filter 属 性 。 

至 此 ， 我 们 可 以 选择 使 用 FileSystemEventHandler 委 托 关联 的 事件 来 实现 Changed 、Created 和 
Deleted 事 件 的 处 理 方 法 。 这 个 委托 可 以 调用 任何 符合 下 列 模式 的 方法 : 


// FileSystemEventHandler 委 托 必须 指向 符合 下 列 签名 的 方法 
void MyNotificationHandler(object source, FileSystemEventArgs e) 


同样 ，Renamed 事 件 也 可 以 通过 RenamedEventHandler 委 托 类 型 来 处 理 ， 调 用 的 方法 必须 符合 下 列 
签名 : 


// RenamedEventHandler 委 托 必 须 指 向 符合 下 列 签名 的 方法 
void MyRenamedHandler(object source, RenamedEventArgs e) 


尽管 可 以 使 用 传统 的 委托 和 事件 语法 来 处 理 各 个 事件 , 但 我 们 还 可 以 使 用 Lambda 表 达 式 语法 (本 
项 目的 可 下 载 代 码 就 使 用 了 Lambda 语 法 ， 感 兴趣 的 话 可 以 研究 研究 )。 

接 下 来 我 们 来 看 看 观察 文件 的 过 程 ， 假 设 已 经 在 C 盘 新 建 了 一 个 名 为 MyFolder 的 目录 ， 其 中 包含 
了 各 种 *.txt 文 件 ( 什么 名 字 都 可 以 )。 下 面 这 个 控制 台 应 用 程序 MyDirectoryWatcher 将 会 监控 这 些 
MyFolder 下 的 *.txt 文 件 ， 并 显示 出 文件 的 建立 、 删 除 、 修 改 和 重 命名 事件 的 消息 : 


static void Main(string[] args) 
Console.WritelLine("***** The Amazing File Watcher App *****\n"); 


// 确定 指向 要 观察 的 目录 的 路 径 
FileSystemWatcher watcher = new FileSystemWatcher(); 
try 


watcher.Path = @"C:\MyFolder"; 
catch(ArgumentException ex) 


Console.WritelLine(ex.Message); 
return; 


} 

// 设置 需要 “留意 ”的 事情 

watcher.NotifyFilter = NotifyFilters.LastAccess 
| NotifyFilters.LastWrite 
| NotifyFilters.FileName 
| NotifyFilters.DirectoryName; 


// 只 观察 文本 文件 
Watcher .Filter = "*.txt"; 
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// 增加 事件 处 理 程序 

watcher.Changed += new FileSystemEventHandler(OnChanged); 
watcher.Created += new FileSystemEventHandler(OnChanged) ; 
watcher.Deleted += new FileSystemEventHandler(OnChanged); 
watcher.Renamed += new RenamedEventHandler(OnRenamed); 


// 开始 观察 目录 
watcher.EnableRaisingEvents = true; 


// 等 竺 用户 退出 程序 
Console.WriteLine(@"Press 'q' to quit app."); 
while(Console.Read()!='q ); 


这 两 个 事件 处 理 程序 输出 了 当前 文件 的 修改 : 


static void OnChanged(object source, FileSystemEventArgs e) 


// 指定 当 文 件 改变 、 创 建 或 者 删除 的 时 候 需要 做 的 事情 
Console.WriteLine("File: {0} {1}!", e.Fullpath, e.ChangeType); 


static void OnRenamed(object source, RenamedEventArgs e) 


// 指定 当 文件 重 命名 的 时 候 需 要 做 的 事情 
Console.WriteLine("File: {0} renamed to {1}", e.0ldFullpath, e.Fullpath); 


为 了 测试 该 程序 ， 运 行 应 用 程序 并 且 打 开 Windows 资 源 管理 器 。 试 着 重 命名 文件 ， 新 建 一 个 *.txt 
文件 ， 删 除 一 个 *.txt 文 件 等 ， 我 们 就 会 看 到 这 个 控制 台 应 用 程序 输出 了 各 种 关于 MyFolder 文 件 夹 内 文 
本 文件 当前 状态 的 信息 : 





***** The Amazing File Watcher App ***** 

Press 'q' to quit app. 

File: C:\MyFolder\New Text Document.txt Created! 
File: C:\MyFolder\New Text Document.txt renamed to 
C:\MyFolder\Hello.txt 

File: C:\MyFolder\Hello.txt Changed! 

File: C:\MyFolder\Hello.txt Changed! 

File: C:\MyFolder\Hello.txt Deleted! 





源 代码 ”MyDirectoryWatcher 项 目的 源 代 码 位 于 Chapter 20 子 目录 下 。 


这 就 是 本 章 对 于 .NET 平 台 下 基础 /O 操 作 的 介绍 。 你 肯定 会 在 很 多 应 用 程序 中 使 用 这 些 技术 ， 而 
且 你 可 能 还 会 发 现 对 象 序 列 化 服务 可 以 显著 地 简化 对 大 量 数据 的 持久 化 。 


20.13 ”对 象 序列 化 


术语 序列 化 ( serialization ) 描述 了 持久 化 〈 可 能 还 包括 传输 ) 一 个 对 象 的 状态 到 流 ( 如 文件 流 和 
内 存 流 ) 的 过 程 。 被 持久 化 的 数据 次 序 包 括 所 有 以 后 需要 用 来 重建 ( 即 反 序列 化 ) 对 象 状 态 所 必需 的 
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信息 。 使 用 这 种 技术 ， 用 最 小 花费 来 保存 海量 的 (各 种 格式 的 ) 数据 就 变 得 轻而易举 了 。 实 际 上 , 在 
很 多 情况 下 ,使 用 序列 化 服务 保存 应 用 程序 数据 ， 相 对 直接 使 用 System.I0 命 名 空间 的 读 取 带 /编写 带 ， 
减少 了 很 多 的 麻烦 。 

举例 来 说 ， 设 想 你 建立 了 一 个 基于 GUI 的 桌面 应 用 程序 ， 并 希望 提供 一 种 方法 给 最 终 用 户 保存 他 
们 偏好 ( 窗口 颜色 和 字号 等 ) 的 界面 。 为 此 , 你 可 能 定义 了 一 个 名 为 UserPrefs 的 类 来 封装 20 个 字段 数 
据 。 如 果 使 用 System.I0.BinaryWriter 类 型 ， 需 要 人 工 保存 UserPrefs 对 象 的 每 个 字段 成 员 。 同 样 ， 当 
想 从 文件 把 这 些 数 据 导 入 内 存 的 时 候 ， 需 要 使 用 System.I0.BinaryReader 并 且 (再 一 次 ) 人 工地 读 人 
每 个 值 以 重新 生成 一 个 新 的 UserPrefs 对 象 。 

虽然 这 是 可 以 实现 的 ， 但 若 为 UserpPrefs 类 标识 [Serializable] 特 性 将 可 以 轻易 地 节省 大 量 的 时 间 。 

[Serializable] 


public class Userprefs 


public string WindowColor; 
public int FontSize; 


这 时 , 对 象 全 部 的 状态 可 以 通过 下 面 几 行 代码 来 持久 化 。 暂时 不 用 担心 细节 , 考虑 下 面 的 Main() 方 法 : 
static void Main(string[] args) 
UserPrefs userData= new UserPrefs(); 


userData.WindowColor = "Yellow"; 
userData.FontSize = 50; 


// BinaryFormatter 以 二 进 制 格 式 持 久 化 状态 数据 
// 需要 导入 System.Runtime.Serialization.Formatters.Binary 以 便 访 问 BinaryFormatter 
BinaryFormatter binFormat = new BinaryFormatter(); 


// 现在 将 对 象 保存 到 一 个 本 地 文件 中 
using(Stream fStream = new FileStream("user.dat", 
FileMode.Create, FileAccess.Write, FileShare.None)) 


binFormat.Serialize(fStream, userData); 


Console.ReadLine(); 


虽然 使 用 .NET 对 象 序列 化 保存 对 象 非常 简单 , 但 幕后 的 调用 过 程 却 非常 复杂 。 例如 ， 当 一 个 对 象 
被 持久 化 到 流 时 ， 所 有 的 相关 数据 ( 基 类 、 包 含 的 对 象 等 ) 也 会 被 自动 序列 化 ， 因 此 ， 假 如 你 想 持 和 久 
化 一 个 派生 类 ， 那 么 继承 链 ( 即 基 类 ， 基 类 的 基 类 ) 上 的 所 有 数据 都 会 被 包括 进来 ， 后 面 你 会 看 到 ， 
一 组 相关 的 对 象 使 用 对 象 图 来 表现 。 

.NET 序 列 化 服务 也 允许 用 多 种 格式 来 保存 一 个 对 象 图 。 先 前 的 示例 代码 使 用 了 BinaryFormatter 
类 型 , 所 以 UserPrefs 对 象 的 状态 被 保存 为 紧凑 的 二 进 制 格式 。 你 也 可 以 使 用 其 他 类 型 将 对 象 图 保存 为 
简单 对 象 访问 协议 (SOAP ) 或 XML 格式 。 当 希望 确保 你 的 持久 化 对 象 跨越 操作 系统 、 语 言 和 结构 进 
行 传递 时 ， 这 些 格式 是 很 有 用 的 。 








中 学 习 这 些 内 容 。 
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最 后 ， 要 知道 对 象 图 可 以 持久 化 为 任意 的 System.I0.Stream 派 生 类 型 。 在 先前 的 示例 中 ， 通 过 
FileStream 类 型 将 Userprefs 对 象 持久 化 到 一 个 本 地 文件 。 但 是 ， 如 果 你 想 保 存 对 象 到 内 存 中 ， 可 以 使 
用 MemoryStream 类 型 。 关 键 是 数据 的 顺序 要 正确 地 代表 图 中 对 象 的 状态 。 


对 象 图 的 作用 


前 面 提 到 过 ， 当 对 象 被 序列 化 时 ，CLR 将 处 理 所 有 相关 的 对 象 ， 一 组 关联 对 象 被 总 称 为 一 个 对 象 
图 。 对 象 图 提供 一 种 很 简明 的 方式 来 记载 一 组 对 象 如 何 相 互 引用 对 方 。 注 意 ， 对 象 图 没有 指名 面向 对 
象 关 系 中 的 “is-a” 或 “has-a” 关 系 。 相 反 ， 它 们 用 箭头 来 表示 “需要 ”和 “依赖 ”的 关系 。 

在 对 象 图 中 的 每 个 对 象 被 赋予 一 个 独 有 的 数值 类 型 的 值 。 谨 记 : 这 个 数 可 任意 地 赋 给 对 象 图 中 的 
成 员 ， 对 外 部 世界 没有 真正 意义 。 一 旦 所 有 的 对 象 都 赋予 了 数值 ， 对 象 图 就 可 以 记录 每 个 对 象 的 整个 
依赖 关系 。 

举 一 个 简单 的 例子 , 比如 建立 一 组 类 模拟 一 些 汽 车 。 有 一 个 基 类 名 称 是 Car, 它 配 有 (“has-a”) 
Radio， 另 外 一 个 名 为 JamesBondCar 的 类 扩展 Car 基 类 。 图 20-4 显 示 了 一 个 模拟 这 些 关 系 的 可 能 的 对 
象 图 。 


Car Radio 


JamesBondCar 


1 


图 20-4 简单 的 对 象 图 


读 取 对 象 图 时 ， 可 以 使 用 短语 依赖 于 ( depend on ) 或 引用 (refer to ) 来 表示 连接 箭头 。 因 而 ,在 
图 20-4 里 可 以 看 到 car 类 引用 了 Radio 类 ( 有 “has-a” 关 系 )。JamesBondCar 类 引用 了 Car 类 (是 “is-a” 
的 关系 )， 也 引用 了 Radio 类 ( 因为 它 继承 了 这 个 受 保护 的 成 员 变 量 )。 

当然 ，CLR 不 会 在 内 存 中 画图 来 表示 相关 对 象 。 图 20-4 中 记载 的 关系 会 用 类 似 下 面 这 样 的 、 更 具 
有 数学 含义 的 公式 来 描述 : 

[Car 3, ref 2], [Radio 2], [JamesBondCar 1, ref 3, ref 2] 

如 果 解 析 这 个 公式 ， 会 再 次 看 到 对 象 3 (Car 类 ) 依赖 于 对 象 2 ( Radio 类 )， 对 象 2 (Radio 类 ) 像 一 
个 孤僻 的 人 ,不 依赖 任何 人 。 最 后 ， 对 象 1 ( JamesBondCar 类 ) 依赖 于 对 象 3 和 对 象 2。 在 各 种 情况 下 ， 
序列 化 或 反 序列 化 JamesBondCar 类 的 实例 时 ， 对 象 图 确认 Radio 类 型 和 Car 类 型 也 参与 了 这 个 过 程 。 

序列 化 过 程 的 美妙 之 处 在 于 表示 各 个 对 象 之 间 相 互 关 系 的 图 形 是 在 幕后 自动 建立 的 。 本 章 后 面 将 
会 看 到 ， 如 果 和 希望 更 多 地 介入 到 某 个 对 象 图 的 构建 ,通过 使 用 特性 和 接口 来 自 定义 序列 化 过 程 也 是 可 
以 做 到 的 。 
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说 明 ”严格 说 来 ，XmlSerializer 类 型 (本章 后 面 会 介绍 ) 不 使 用 对 象 图 来 持久 化 状态 ， 然 而 ， 这 个 
类 型 会 以 可 预知 的 方式 序列 化 和 反 序 列 化 相关 对 象 。 
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为 了 让 一 个 对 象 支持 :NET 序列 化 服务 ， 用 户 需 要 做 的 只 是 为 每 一 个 关联 的 类 《或 结构 ) 加 上 
[Serializable] 特 性 ， 真 的 就 是 这 样 简单 。 如 果 你 觉得 给 定 的 类 型 有 一 些 成 员 数据 不 能 (或 可 能 不 ) 
参与 到 序列 化 配置 中 , 可 以 在 这 些 域 前 加 上 [Nonserialized] 特 性 。 如 果 在 可 被 序列 化 的 类 中 有 成 员 变 
量 不 需要 保存 ( 比如 ， 固 定 的 值 、 随 机 值 、 瞬 态 数 据 等 ) 并 且 和 希望 减 小 持久 化 图 的 大 小 ， 这 样 做 是 很 
有 用 的 。 


20.14.1 ”定义 可 序列 化 的 类 型 

创建 一 个 新 的 控制 台 应 用 程序 SimpleSerialize, 其 中 的 Radio 类 被 标记 为 [Serializable], 除了 一 个 
成 员 变 量 ( radioID ) 例外 ， 它 被 标记 为 [NonSerialized] ， 因 此 radioID 类 将 不 会 被 持久 化 到 指定 的 数 
据 流 中 : 


[Serializable] 
public class Radio 


public bool hasTweeters; 
public bool hasSubWoofers; 
public double[] stationpresets; 


[NonSerialized] 
public string radioID = "XF-552RR6"; 


接 下 来 , 添加 男 外 两 个 类 类 型 来 表示 JamesBondCar 和 Car 基 类 。JamesBondCar 类 和 Car 基 类 也 标记 为 
[Serializable]， 并 且 定 义 了 下 列 字 段 数据 : 


[Serializable] 
public class Car 


public Radio theRadio = new Radio(); 
public bool isHatchBack; 
} 


[Serializable] 
public class JamesBondCar : Car 


public bool canFly; 
public bool canSubmerge; 


注意 ，[Serializable] 特 性 不 能 被 继承 。 因 此 ， 如 果 从 被 标记 为 [Serializable] 的 类 派生 一 个 类 ， 
子 类 也 必须 被 标记 为 [Serializable] ， 否 则 它 不 能 被 持久 化 。 实 际 上 ， 对 象 图 中 的 所 有 对 象 必须 标 上 
[Serializable] 特 性 。 如 果 试 图 使 用 BinaryFormatter 或 者 SoapFormatter 序 列 化 一 个 非 序 列 化 的 对 象 ， 
在 运行 时 将 会 收 到 一 个 SerializationException (序列 化 异常 ) 的 提示 。 
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20.14.2 ”公共 字段 、 私 有 字段 和 公共 属性 


注意 , 为 了 简化 范例 ， 上 面 用 到 每 一 个 类 中 的 字段 数据 都 被 定义 为 公共 的 。 当 然 ， 从 面向 对 象 的 
观点 看 ， 用 公共 属性 公开 私有 字段 数据 更 受 欢迎 。 同 样 ， 为 了 简化 的 需要 ， 上 面 的 示例 也 没有 定义 构 
造 函 数 ， 因 此 所 有 未 被 赋值 的 字段 数据 将 接收 期 望 的 默认 值 。 

除了 面向 对 象 的 设计 原则 之 外 , 读者 可 能 想 知道 不 同 的 格式 化 方法 指望 类 型 的 字段 数据 要 如 何 定 
义 , 才能 被 序列 化 为 流 。 答 案 是 , 这 取决 于 具体 情况 。 如 果 使 用 BinaryFormatter 或 50apFormatter 持 久 
化 一 个 对 象 ， 完 全 没有 区 别 。 这 些 类 型 被 编程 为 序列 化 一 个 类 型 的 所 有 可 序列 化 的 字段 ， 不 管 它 是 公 
共 字 段 、 私 有 字段 还 是 通过 公共 属性 公开 的 私有 字段 。 回 想 一 下 ， 如 果 有 一 些 不 想 被 持久 化 到 对 象 图 
中 的 数据 点 ， 可 以 有 选择 地 把 公共 或 私有 字段 标记 为 [NonSerialized] ， 像 对 Radio 类 型 中 的 字符 串 域 
所 做 的 那样 。 

如 果 使 用 xmlSerializer 类 型 ， 情 况 就 大 不 同 。 这 些 类 型 只 有 字段 数据 的 公共 块 或 拥有 公共 属 
性 的 私有 数据 可 以 被 序列 化 。 不 是 通过 属性 公开 的 私有 数据 将 被 忽略 , 例如 下 面 可 序列 化 的 Person 
类 型 : 

[serializable] 


public class Person 


// 公共 字段 
public bool isAlive = true; 


// 私有 字段 


private int personAge = 21; 


// 公共 属性 /私有 数据 
private string fName = string.Empty; 
public string FirstName 


get { return fName; } 
set { fName = value; } 
} 
} 


如 果 是 由 BinaryFormatter 或 SoapFormatter 进 行 处 理 , 我 们 就 会 发 现 isAlive、personAge 以 及 fName 
都 保存 到 了 所 选 的 流 中 。 然 而 ，XmlSerializer 不 会 保存 personAge 的 值 ， 因 为 这 段 私 有 数据 没有 封装 
为 类 型 属性 。 如 果 你 希望 使 用 XmlSerializer 来 持久 化 用 户 年 龄 ,就 需要 把 字段 定义 为 公共 的 或 使 用 公 
共 属 性 来 封装 私有 字段 。 


20.15 选择 序列 化 格式 化 程序 


一 旦 将 类 型 配置 为 参与 .NET 序列 化 ， 接 下 来 就 是 选择 当 持久 化 对 象 图 时 使 用 哪 种 格式 (二进制 、 
SOAP 或 XML )， 有 以 下 3 种 选择 : 

口 BinaryFormatter; 

DQ SoapFormatter; 

口 xmlSerializer. 
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BinaryFormatter 类 型 使 用 紧凑 的 二 进 制 格式 将 对 象 图 序列 化 为 一 个 流 ， 这 个 类 型 在 System. 
Runtime.Serialization.Formatters.Binary 命 名 空间 中 定义 , 后 者 是 mscorlib.dll 的 一 部 分 。 因 此 , 为 了 
获得 对 这 个 类 型 的 访问 ， 需 要 指定 下 面 的 C# using 指 邻 : 


// 获取 对 mscorlib.dll 中 的 BinaryFormatter 的 访问 
using System.Runtime.Serialization.Formatters.Binary; 


SoapFormatter 类 型 将 对 象 图 表示 为 一 个 SOAP 消 息 ( 传递 消息 到 Web 服 务 或 从 Web 服 务 传递 消息 的 
标准 XML 格式 )。 该 类 型 定义 在 System.Runtime Serialization.Formatters.Soap 命 名 空间 中 ， 该 命名 
空间 被 定义 在 一 个 程序 集 内 。 因 此 ， 要 格式 化 对 象 图 为 一 个 SOAP 消 息 ， 必 须 使 用 Visual Studio 的 Add 
Reference 对 话 框 设 定 引用 指向 System.Runtime.Serialization.Formatters.Soap.dll 并 指定 下 列 的 C# using 
指令 : 


// 必须 引用 System.Runtime.Serialization.Formatters.Soap.dll 
using System.Runtime.Serialization.Formatters.Soap; 


最 后 ， 如 果 和 希望 将 对 象 图 持久 化 为 一 个 XML 文档 ， 需 要 用 到 Xmlserializer 类 型 。 要 使 用 这 个 类 
型 ， 需 要 指定 使 用 System.Xm1.Serialization 命 名 空间 ， 并 设置 对 程序 集 System.Xml.dll 的 引用 。 幸 好 
所 有 的 Visual Studio 项 目 模板 自动 引用 了 System.Xml.dll， 因 此 只 需要 使 用 下 列 命名 空间 : 


// 定义 在 System.Xml.dll 
using System.Xm1l.Serialization; 


20.15.1 IFormatter 和 IRemotingFormatting 接 口 


不 管 选 择 哪 种 格式 化 程序 来 序列 化 对 象 , 都 要 知道 它们 直接 派生 于 System.0bject, 因此 并 不 从 一 
个 以 序列 化 为 中 心 的 基 类 共享 一 组 公共 的 成 员 。 但 是 , BinaryFormatter 和 SoapFormatter 类 型 通过 实现 
IFormatter 和 IRemotingFormattter 接 口 ( XmlSerializer 两 者 都 不 实现 ) 都 支持 公共 的 成 员 。 

System.Runtime.Serialization.IFormatter 定 义 了 核心 的 Serialize() 和 Deserialize() 方 法 ， 
Serialize() 和 Deserialize() 方 法 将 做 复杂 的 工作 完成 对 象 图 和 指定 流 之 间 的 转换 。 除 了 这 些 成 员 ， 
IFormatter 还 定义 了 一 些 在 后 台 使 用 的 实现 类 型 的 属性 : 


public interface IFormatter 


SerializationBinder Binder { get; set; } 
StreamingContext Context { get; set; } 
ISurrogateSelector SurrogateSelector { get; set; } 
object Deserialize(Stream serializationStream); 

void Serialize(Stream serializationStream, object graph); 


System.Runtime.Remoting.Messaging.IRemotingFormatter 接 口 ( 被 .NET 远 程 处 理 层 内 部 控制 ) 重 
载 了 Serialize() 和 Deserialize() 成 员 使 风格 更 适合 于 分 布 式 持久 化 。 注 意 IRemotingFormatter 派 生 于 
更 基本 的 IFormatter 接 口 : 


public interface IRemotingFormatter : IFormatter 


object Deserialize(Stream serializationStream, HeaderHandler handler); 
void Serialize(Stream serializationStream, object graph, Header[] headers); 
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尽管 在 大 多 数 序列 化 工作 时 不 需要 直接 与 这 些 接口 发 生 交 互 ， 回 想 一 下 ， 基 于 接口 的 多 态 性 允许 
使 用 一 个 IFormatter 引 用 来 保持 一 个 BinaryFormatter 或 SoapFormatter 的 实例 。 因 此 ， 如 果 希 望 建 立 一 
个 方法 使 用 这 两 个 类 中 的 一 个 来 序列 化 一 个 对 象 图 ， 可 以 编写 下 列 语句 : 

static void SerializeObjectGraph(IFormatter itfFormat， 


Stream destStream, object graph) 


itfFormat.Serialize(destStream, graph); 


20.15.2 在 格式 化 程序 中 的 类 型 保 真 


在 3 种 格式 化 程序 中 ， 最 明显 的 不 同 是 对 象 图 被 持久 化 为 不 同 的 流 (二 进 制 、SOAP 或 XML ) 的 
方式 。 读 者 一 定 要 意识 到 其 中 更 细微 的 差别 ， 特 别 是 格式 化 程序 如 何 应 对 类 型 保 真 ( type fidelity )。 
当 使 用 BinaryFormatter 类 型 时 ， 不 仅仅 是 将 对 象 图 中 对 象 的 字段 数据 进行 持久 化 ， 而 且 也 持久 化 每 
个 类 型 的 完全 限定 名 称 和 定义 程序 集 的 完整 名 称 ( 名称、 版 本 、 公 钥 标记 和 区 域 性 )。 这 些 数据 使 
BinaryFormatter 在 希望 用 值 (例如 以 一 个 完整 的 副本 ) 跨越 .NET 应 用 程序 机 器 边界 传递 对 象 时 成 为 
理想 的 选择 。 

SoapFormatter 通 过 使 用 XML 命名 空间 来 持久 化 原始 程序 集 的 跟踪 。 例 如 , 本 章 之 前 的 Person 类 型 。 
如 果 类 型 使 用 SOAP 消 息 进行 持久 化 ,我 们 就 会 发 现 person 的 开始 元 素 使 用 生成 的 xmlns 进 行 限定 。 考 
虑 如 下 片段 的 定义 ， 特 别 注意 al XML 命名 空间 : 


<al:Person id="ref-1" xmlns:a1= 
"http://schemas.microsoft.com/clr/nsassem/SimpleSerialize/MyApp%2C%20 
Version%3D1.0.0.0%2C%20Culture%3Dneutral%2C%20PublicKeyToken%3Dnull"> 
<isAlive>true</isAlive> 
<personAge>21</personAge> 
<fName id="ref-3">Mel</fName> 

</al:Person> 


男 一 方面 ，XmlSerializer 不 会 试图 保存 完全 的 类 型 保 真 , 因此 也 不 记录 类 型 完全 限定 名 称 或 起 源 
的 程序 集 。 因 此 可 能 乍 一 看 好 像 有 些 限 制 ， 但 XML 序 列 化 用 于 标准 的 .NET Web 服 务 ， 可 被 任何 平台 
(不 仅仅 是 .NET ) 中 的 客户 端 调用 。 这 意味 着 没有 必要 序列 化 完整 的 .NET 类 型 元 数据 。 下 面 是 Person 
类 型 可 能 的 XML 表示 方法 : 


<?xm] version="1.0"?> 
<Person xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema"> 
<isAlive>true</isAlive> 
<PersonAge>21</PersonAge> 
<FirstName>Frank</FirstName> 
</Person> 


如 果 和 希望 持久 化 的 对 象 图 可 以 被 任意 操作 系统 ( Windows、Mac OS X 和 各 种 Linux 类 系统 )、 应 用 
程序 框架 ( .NET、Java EE、COM 等 ) 或 编程 语言 使 用 ， 就 不 要 保持 完整 的 类 型 保 真 ， 因 为 不 能 假设 
所 有 可 能 的 接收 方 都 能 理解 .NET 专 有 的 数据 类 型 。 基 于 此 ， 当 希望 尽 可 能 延伸 持久 化 对 象 图 的 使 用 范 
围 时 ，SoapFormatter 和 XmlSerializer 是 理想 选择 。 
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20.16 使 用 BinaryFormatter 序列 化 对 象 


为 说 明 持久 化 一 个 ]amesBondCar 的 实例 到 一 个 物理 文件 中 是 多 么 简单 ， 我 们 使 用 BinaryFormatter 二 进 
制 类 型 。 再 次 注意 BinaryFormatter 类 型 的 两 个 关键 方法 : Serialize() 和 Deserialize()。 

口 Serialize(): 将 一 个 对 象 图 按 字 节 的 顺序 持久 化 到 一 个 指定 的 流 。 

口 Deserialize(): 将 一 个 持久 化 的 字 节 顺序 转化 为 一 个 对 象 图 。 

假设 已 经 建立 了 JamesBondCar 的 一 个 实例 ,修改 了 一 些 状态 数据 ， 并 想 将 间谍 汽车 "持久 化 到 一 个 
#.dat 文 件 中 。 第 一 个 任务 是 建立 k.dat 文 件 本 身 。 这 可 以 通过 建立 一 个 System.I0.FileStream 类 型 的 实例 
来 完成 。 此 刻 , 仅仅 建立 一 个 BinaryFormatter 的 实例 并 传 进 Filestream 和 对 象 图 进行 持久 化 。 考虑 下 面 
的 Main() 方 法 : 


// 确保 使 用 了 SystemRuntime.Serialization.Formatters.Binary 
// 和 System.I0 命 名 空间 
static void Main(string[] args) 


Console.Writeline("***** Fun with Object Serialization *****\n"); 


// 建立 一 个 ]amesBondCar 并 设 定 状态 

JamesBondCar jbc = new JamesBondCar(); 

jbc.canFly = true; 

jbc.canSubmerge = false; 

jbc.theRadio. stationpresets = new double[]{89.3, 105.1, 97.1}; 
jbc.theRadio.hasTweeters = true; 


// 将 car 以 二 进 制 格式 保存 到 指定 文件 中 
SaveAsBinaryFormat(jbc, "CarData.dat"); 
Console.ReadLine(); 


SaveAsBinaryFormat() 方 法 按 如 下 所 示 实 现 : 


static void SaveAsBinaryFormat(object objGraph, string fileName) 


{ 
// 将 对 象 以 二 进 制 保 存 到 一 个 名 为 CarData.dat 的 文件 


BinaryFormatter binFormat = new BinaryFormatter(); 


using(Stream fStream = new FileStream(fileName, 
FileMode.Create, FileAccess.Write, FileShare.None)) 


binFormat.Serialize(fStream, objGraph); 


Console.WritelLine("=> Saved car in binary format!"); 


可 见 , BinaryFormatter.Serialize() 方 法 是 一 个 负责 生成 对 象 图 并 将 字 节 顺序 移动 到 流 的 派生 类 
型 的 成 员 。 在 这 个 例子 中 ， 流 碰巧 是 一 个 物理 文件 。 然 而 ， 也 可 以 序列 化 对 象 类 型 为 任意 流 的 派生 类 
型 ， 例 如 放置 到 内 存 、 网 络 流 中 。 

在 运行 程序 之 后 ， 我 们 就 可 以 转 到 当前 项 目 \bin\Debug 文 件 夹 查看 表示 JamesBondCar 实 例 的 
CarData.dat 文 件 的 内 容 了 。 图 20-5 显 示 了 在 Visual Studio 中 打开 的 这 个 文件 。 





Oz 前 面 的 JamesBondCar 是 “007 中 邦 德 的 车 ”的 意思 。 一 一 译 者 注 


642 第 20 章 文件 输入 输出 和 对 象 序列 化 


CarData.dat 二 X Program.cs 


00000000 ho 91 00 00 00 FF FF FF FF 01 00 00 00 00 00 80 .i 
00000010 00 OC 02 00 00 00 46 53 693 6D ?0 6C 65 53 65 72 ,.,.,.,. FSimpleSer 
00000020 69 61 6C 69 7A 65 2C 20 56 65 ?2 73 69 6F 6E 3D ialize, Version= 
00000030 31 2E 30 2E 30 2E 30 2C 20 43 75 6C ?74 ?5 72 65 1.0.0.0, Culture 
00000040 3D 6E 65 75 74 ?2 61 6C 2C 20 50 75 62 6C 69 63 =neutral, Public 
00000050 4B 65 ?9 54 6F 6B 65 6E 3D 6E ?75 6C 6C 05 01 00 KeyToken=null... 






00000060 00 860 1C 53 69 6D ?0 6C 65 53 65 72 69 61 6C 69 ...SimpleSeriali 
00000070 7A 6&5 2E 4A 61 6D 65 73 42 6F 6E 64 43 61 72 04 ze.JamesBondCar. 
00000080 00 00 00 06 63 61 6E 46 6C 79 0B 63 61 6E 53 ?5 ....canFly.canSu 


00000090 62 6D 65 72 67 65 08 74 868 65 52 61 64 69 6F 8B bnerge .theRadio - 
000000a0 6869 73 48 61 74 63 68 42 61 63 6B 00 00 04 00 01 isHatchBack..... 
000000b0 01 15 53 69 6D 70 6C 65 S53 65 ?2 69 61 6C 69 7& ..SimpleSerializ 
000000c0 6865 2E S2 61 64 69 6F 02 00 00 00 01 02 00 00 00 e.Radio......... 


000000d0 01 00 09 03 00 00 00 00 05 03 00 00 00 15 53 69 .is Si 
000000s0 68D 70 6C 65 53 65 72 69 61 6C 69 78 65 2E 52 61 mpleSerialize.Ra 
000000f0 64 69 6F 03 00 00 00 OB 68 61 ?3 54 ?7 65 65 ?4 dio...,, hasTweet 


00000100 65 72 73 0D 68 61 73 53 ?75 62 57 6F 6F 66 65 72 ers.hasSubWoofer 
00000110 ?3 OE ?3 74 61 74 63 6F 6EE 50 ?2 65 ?3 65 74 73 Ss.stationPresets 
00000120 00 00 07 01 01 06 02 00 00 00 01 00 09 04 00 00 ................ 
00000130 000F 04 00 00 00 03 00 00 00 06 33 33 33 33 33 .,..,....,.. 33333 
00000140 53 5Sé 40 66 66 66 66 66 46 SA 40 66 66 66 656 66 SVG@ftffffFZ@ffffE 
D0000150 46 58 40 0B FX@. 


图 20-5 ”使 用 BinaryFormatter 对 JamesBondCar 进 行 序列 化 


使 用 BinaryFormatter 反 序列 化 对 象 


现在 假定 你 在 考虑 从 二 进 制 文件 中 读 取 被 持久 化 的 JamesBondCar 并 将 其 恢复 到 一 个 对 象 变量 中 。 
一 旦 以 编程 方式 打开 CarData.dat ( 通过 File.0penRead() 方 法 ) 文件 ， 只 需要 调用 BinaryFormatter 的 
Deserialize() 方 法 。 要 知道 ，Deserialize() 返 回 一 个 基本 的 System.0bject 类 型 ， 所 以 需要 强制 施加 
外 部 转换 ， 如 下 面 显示 的 : 


static void LoadFromBinaryFile(string fileName) 


{ 


BinaryFormatter binFormat = new BinaryFormatter(); 


// 从 二 进 制 文件 中 读 取 JamesBondCar 对 象 
using(Stream fStream = File.0penRead(fileName)) 


JamesBondCar carFromDisk = 
(JamesBondCar)binFormat.Deserialize(fStream); 
Console.WritelLine("Can this car fly? : {0}", carFromDisk.canFly); 


} 
3 
注意 ， 如 果 我 们 调用 Deserialize(), 需要 传人 表示 持久 的 对 象 图 位 置 的 Stream 的 派生 类 型 。 在 把 
对 象 转换 回 正确 类 型 之 后 ,我 们 就 可 以 发 现状 态 数据 是 我 们 保存 对 象 时 的 那个 状态 点 。 


20.17 ”使 用 SoapFormatter 序列 化 对 象 


下 一 个 格式 化 程序 的 选择 是 SoapFormatter 类 型 。SoapFormatter 类 型 将 把 对 象 图 持久 化 为 一 个 
SOAP 消 息 。 简 而 言 之 ，SOAP 定 义 了 一 个 标准 的 过 程 ， 在 这 个 过 程 中 可 以 用 与 平台 和 操作 系统 无 关 的 
方式 调用 方法 。 

假定 你 引用 了 System.Runtime.Serialization.Formatters.Soap.dll 程 序 集 ， 并 使 用 了 System.Runtime. 
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Serialization.Formatters.Soap 命 名 空间 ， 只 需 将 出 现 的 每 个 BinaryFormatter 替 换 为 SoapFormatter 就 可 以 持 
久 化 并 接收 JamesBondCar 为 一 个 SOAP 消 息 。 参 考 下 面 Program 类 的 新 方法 ， 它 将 一 个 对 象 序列 化 为 一 
个 SOAP 格 式 的 本 地 文件 : 


// 确保 使 用 了 System.Runtime.Serialization.Formatters.Soap 并 引用 了 
// System.Runtime.Serialization.Formatters.Soap.dll 
static void SaveAsSoapFormat (object objGraph, string fileName) 
{ 
// 将 对 象 以 SOAP 格 式 保存 到 CarData.soap 文 件 中 
SoapFormatter soapFormat = new SoapFormatter(); 


using(Stream fStream = new FileStream(fileName, 
FileMode.Create, FileAccess.Write, FileShare.None)) 


soapFormat. Serialize(fStream, objGraph); 


Console.WritelLine("=> Saved car in SOAP format!"); 


} 


和 之 前 一 样 ， 仅 仅 使 用 Serialize() 和 Deserialize() 方 法 将 对 象 图 移入 和 移出 流 。 如 果 从 Main() 
调用 这 方法 ， 并 运行 程序 ， 将 打开 一 个 产生 结果 的 *.soap 文 件 。 可 以 定位 到 标记 了 当前 JamesBondCar 
的 状态 值 的 XML 元 素 上 ， 也 可 以 通过 #ref 标 记 定 位 到 对 象 图 中 对 象 间 的 关系 上 ， 如 图 20-6 所 示 。 


CarData.soap PH Xx CS Ba 
<SOAP-ENV: Envelope xmlns:xsi="http://www.w3.org/2901/XMLSchema-instance”xmlns:xsd="| 字 
<SOAP-ENV:Body> 2 
Dical:JamesBondCar id="ref-1" xmlns:al="http://schemas.microsoft.com/clr/nsassem/Simpl: 站 

<canFfly>true</canFly> | 于 
i <canSubmerge>false</canSubmerge> | 
| <theRadio href="#ref-3"/> | 素 
| | <isHatchBack>false</isHatchBack> | 
</al: JamesBondCar> | 
Cxai;Radio id="ref-3" xmins:al="http://schemas .microsoft.com/clr/nsassem/SimpleSerial.” 
<hasTweeters>true</hasTweeters> 
<hasSubWoofers>false</hasSubWoofers> 
<stationPpresets href="#ref-4"/> 
</ail:Radio> 
CI<SOAP-ENC:Array id="ref-4" SOAP-ENC:arrayType="xsd:double[3]"> 
<item>89.3</item> 
<item>1085 .1</item> 
<item>97.1</item> 


[100% ~ + [enn ) : Se ， 


图 20-6 ”使 用 SoapFormatter 对 JamesBondCar 进 行 序列 化 


20.18 ”使 用 XmlSerializer 序列 化 对 象 


除了 SOAP 和 二 进 制 格 式 化 程序 外 ，System.Xml.dll 程 序 集 提供 了 第 三 种 格式 化 程序 . System.Xml. 
Serialization.XmlSerializer。 与 XML 数据 被 包含 在 一 个 SOAP 消 息 中 相反 ， 该 方式 可 以 被 用 来 将 给 
定 对 象 的 公共 状态 持久 化 为 一 个 纯 XML。 使 用 这 种 类 型 与 使 用 SoapFormatter 或 BinaryFormatter 类 型 
有 一 点 不 同 。 参 考 下 面 的 代码 ， 假 定 使 用 了 System.Xml.Serialization 命 名 空间 : 
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static void SaveAsXmlFormat(object objGraph, string fileName) 
{ 


// 将 对 象 以 XML 格 式 保存 到 CarData.xml 文 件 中 
XmlSerializer xmlFormat = new XmlSerializer(typeof(JamesBondCar)); 


using(Stream fStream = new FileStream(fileName, 
FileMode.Create, FileAccess.Write, FileShare.None)) 


xmlFormat.Serialize(fStream, objGraph); 


Console.WriteLine("=> Saved car in XML format!"); 


关键 的 不 同 点 是 XmlSerializer 类 型 需要 你 指定 类 型 信息 表示 要 序列 化 的 类 。 如 果 查 看 新 生成 的 
XML 文 件 ( 假设 你 调用 了 Main() 中 的 新 方法 )， 可 以 看 到 如 下 所 示 的 XML 数据 : 


<«?xm] version="1.0"?> 
<JamesBondCar xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 
<theRadio> 
<hasTweeters>true</hasTweeters> 
<hasSubWoofers>false</hasSubWoofers> 
<stationPpresets> 
<double>89.3</double> 
<double>105.1</double> 
<double>97.1</doubley> 
</SstationPresets> 
<radioID>XF-552RR6</radioID> 
‘</theRadio> 
<isHatchBack>false</isHatchBack> 
<canFly>true</canFly> 
<canSubmerge>false</canSubmerge> 
</JamesBondCar> 


说 明 XmlSerializer 要 求 对 象 图 中 的 所 有 序列 化 类 型 支持 默认 的 构造 函数 ( 所 以 如 果 定 义 自 定义 的 
构造 函数 ， 一 定 记得 要 把 它 加 回来 )。 如 果 没 有 , 将 在 运行 时 收 到 InvalidOperationException。 


控制 生成 的 XML 数据 


如 果 读 者 有 使 用 XML 技术 的 背景 ， 就 知道 确认 XML 文档 中 的 元 素 符合 一 套 建 立 数据 有 效 性 的 
规则 往往 是 很 关键 的 。 要 理解 有 效 的 XML 文档 并 不 意味 着 XML 元 素 都 符合 句法 (比如 ， 所 有 打开 
的 元 素 都 必须 有 结束 元 素 )。 准 确 地 说 ， 有 效 的 文档 符合 事先 达成 共识 的 格式 化 规则 ( 例如 ，x 字 段 
必须 被 表示 成 一 个 特性 而 不 是 一 个 子 元 素 )， 这 个 标准 通常 由 XML 架构 或 文档 类 型 定义 (DTD ) 文 
件 定义 。 

默认 情况 下 ，XxmlSerializer 将 所 有 公有 字段 /属性 序列 化 为 XML 元素 而 不 是 XML 特性。 如果 希望 
控制 XmlSerializer 如 何 生成 XML 文档 ， 可 以 用 取 自 System.Xm1.Serialization 命 名 空间 的 任意 数量 的 
附加 特性 来 修饰 你 的 类 型 。 表 20-12 记 录 了 部 分 ( 而 不 是 全 部 ) .NET 特 性 ， 这 些 特 性 影响 XML 数据 被 
编码 为 一 个 流 的 方式 。 


20.19 序列 化 对 象 集合 645 


表 20-12 ”System.Xml.Serialization 命 名 空间 中 的 部 分 特性 





特 性 作 用 

[XmlAttribute] 可 以 在 类 的 公共 字段 上 使 用 这 个 .NET 特 性 ， 它 告诉 XmlSerializer 将 数据 作为 XML 
特性 (不 是 子 元 素 ) 进行 序列 化 

[XmlElement] 字段 或 属性 将 作为 XML 元 素 被 序列 化 
[XmlEnum] 枚 举 成 员 的 元 素 名 称 220 
[XmlRoot] 该 特性 控制 根 元 素 如 何 被 构造 ( 命名 空间 和 元 素 名 称 ) 
[XmlText] 属性 或 字段 将 被 序列 化 为 XML 文本 ( 即 根 元 素 中 开始 标签 和 结束 标签 之 间 的 内 容 ) 
[XmlType] XML 类 型 的 名 称 和 命名 空间 





下 面 是 一 个 简单 的 例子 ， 首 先 考虑 JamesBondCar 的 字段 数据 当前 如 何 被 序列 化 为 XML : 


<?xm] version="1.0" encoding="utf-8"?> 
<JamesBondCar xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0org/2001/XMLSchema"> 


<canFly>true</canFly> 
<canSubmerge>false</canSubmerge> 
</JamesBondCar> 


如 果 希 望 指定 一 个 自 定义 的 XML 命 名 空间 限定 修饰 JamesBondCar， 还 要 将 canFly 和 canSubmerge 值 
编码 为 XML 特 性 ， 也 可 以 依照 下 面 这 样 来 修改 JamesBondCar 的 C# 定 义 : 
[Serializable, XmlRoot(Namespace = "http://www.MyCompany.com")] 


public class JamesBondCar : Car 


[XmlAttribute] 

public bool canFly; 
[XmlAttribute] 

public bool canSubmerge; 


这 样 将 生成 下 面 的 XML 文 档 ( 注意 打开 的 <JamesBondCar> 元 素 ): 


<?xml version="1.0"""?> 
<JamesBondCar xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0org/2001/XMLSchema" 
canFly="true” canSubmerge="false" 
xmlns="http://www.MyCompany .com"> 


</JamesBondCar> 
当然 ， 有 大 量 其 他 的 特性 可 被 用 来 控制 xmlSerializer 生 成 最 终 的 XML 文 档 的 方式 。 如 果 你 希望 
了 解 所 有 的 选项 ， 请 在 .NET Framework 4.5 SDK 文 档 中 查找 system.Xml.Serialization 命 名 空间 。 
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现在 已 经 看 到 了 如 何 将 一 个 对 象 持久 化 为 一 个 流 ， 下 面 检 验 如 何 保存 一 组 对 象 。 读者 可 能 注意 到 
了 ，IFormatter 搁 口中 的 Serialize() 方 法 不 提供 指定 任意 数量 对 象 的 方法 ( 只 能 是 一 个 System. 
0bject )。 相 关 的 是 ，Deserialize() 方 法 的 返回 值 同 样 也 是 一 个 System.0bject ( 同样 的 限制 也 适用 于 


XmlSerializer ) : 


646 第 20 章 文件 输入 输出 和 对 象 序列 化 
public interface IFormatter 


object Deserialize(Stream serializationStream); 
void Serialize(Stream serializationStream, object graph); 


回想 一 下 ，System.0bject 实 际 上 表现 了 一 个 完整 的 对 象 图 。 基 于 此 ， 如 果 你 传递 进来 一 个 被 标记 
为 [Serializable] 的 对 象 并 且 还 包含 了 其 他 [Serializable] 对 象 , 整个 对 象 集 可 以 立刻 被 持久 化 。 幸运 
的 是 ， 大 多 数 在 System.Collections 和 System.Collections.Generic 命 名 空间 内 的 类 型 已 经 被 标记 为 
[Serializable]。 因 此 ， 如 果 你 希望 对 一 组 对 象 进行 持久 化 ， 只 需要 添加 这 组 对 象 到 容器 ( 比如 普通 
数组 、ArrayList 或 List<T> ) 中 并 序列 化 对 象 为 你 选择 的 流 就 可 以 了 。 

假设 已 经 用 一 个 双 参 数 构 造 函 数 更 新 了 JamesBondCar 类 ， 因 此 可 以 设置 一 些 状态 数据 ( 注意 已 按 
照 xmlSerializer 的 要 求 把 默认 的 构造 函数 加 了 回去 ): 


[Serializable, 
XmlRoot(Namespace = "http://www.MyCompany.com")] 
public class JamesBondCar : Car 


public JamesBondCar(bool skyWorthy, bool seaWorthy) 
{ 


canFly = skyWorthy; 
canSubmerge = seaWorthy; 


// XmlSerializer 需 要 一 个 默认 的 构造 函数 
public JamesBondCar(){} 
六 
有 了 这 些 ， 就 可 以 按照 以 下 方式 持久 化 任何 数目 的 JamesBondCars: 


static void SaveListOfCars() 


// 现在 持久 化 一 个 ]amesBondCar 的 List<T> 
List<]JamesBondCar> myCars = new List<JamesBondCar>(); 
myCars.Add(new JamesBondCar(true, true)); 
myCars.Add(new JamesBondCar(true, false)); 
myCars.Add(new JamesBondCar(false, true)); 
myCars.Add(new JamesBondCar(false, false)); 


using(Stream fStream = new FileStream("CarCollection.xml", 
FileMode.Create, FileAccess.Write, FileShare.None)) 


XmlSerializer xmlFormat = new XmlSerializer(typeof(List<JamesBondCar>)); 
xmlFormat.Serialize(fStream, myCars); 


Console.WritelLine("=> Saved list of cars!"); 


重复 一 下 ， 因 为 使 用 了 Xmlserializer ， 所 以 需要 为 每 个 子 对 象 在 根 对 象 (本 例 是 List<james- 
BondCar> ) 中 指定 类 型 信息 。 如 果 使 用 了 BinaryFormatter 或 SoapFormatter 类 型 ， 逻 辑 可 能 更 简单 ， 举 
例 来 说 : 


static void SavelistOfCarsAsBinary() 


// 将 ArrayList 对 象 (myCars) 保 存 为 二 进 制 
List<JamesBondCar> myCars = new List<JamesBondCar>(); 
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BinaryFormatter binFormat = new BinaryFormatter(); 
using(Stream fStream = new FileStream("AllMyCars.dat", 
FileMode.Create, FileAccess.Write, FileShare.None)) 


binFormat.Serialize(fStream, myCars); 


Console.WritelLine("=> Saved list of cars in binary!"); 


源 代码 ”SimpleSerialize 应 用 程序 的 源 代码 位 于 Chapter 20 子 目录 下 。 


20.20 自 定 义 Soap/Binary 序列 化 过 程 


大 多 数 情 况 下 ， 由 .NET 平 台 提供 的 默认 序列 化 方案 都 可 以 满足 需要 ， 只 需要 应 用 [Serializable] 
特性 并 将 对 象 图 传送 给 选择 的 格式 化 程序 即 可 。 但 是 在 一 些 情况 下 ， 你 也 许 希 望 在 序列 化 过 程 中 更 多 
地 干预 构造 和 处 理 目 录 树 的 过 程 。 比 如 ， 可 能 你 有 一 个 商业 规则 ， 规 定 所 有 的 字段 数据 都 必须 被 持久 
化 为 大 写 格 式 , 或 者 可 能 你 希望 添加 额外 的 一 些 数据 位 到 流 中 ， 而 该 流 不 映射 到 正在 被 持久 化 的 对 象 
的 字段 上 ( 时间 惟 、 唯 一 标识 符 或 其 他 )。 

当 和 希望 更 多 地 参与 对 象 序列 化 过 程 时 , System.Runtime.Serialization 命 名 空间 提供 了 以 下 几 个 类 
型 。 表 20-13 列 出 了 核心 类 型 。 


表 20-13 System.Runtime.Serialization 命 名 空间 核心 类 型 





类 型 作 用 
ISerializable 在 [Serializable] 类 型 上 实现 这 个 接口 来 控制 序列 化 和 反 序 列 化 
ObjectIDGenerator 该 类 型 为 对 象 图 中 的 成 员 生成 唯一 标识 符 
[OnDeserialized] 允许 指定 的 方法 在 对 象 被 反 序列 化 后 立即 被 调用 
[OnDeserializing] 允许 指定 的 方法 在 对 象 被 反 序 列 化 之 前 被 调用 
[Onserialized] 允许 指定 的 方法 在 对 象 被 序列 化 后 立即 被 调用 
[Onserializing] 允许 指定 的 方法 在 对 象 被 序列 化 之 前 被 调用 
[OptionalField] 允许 在 类 型 中 定义 一 个 可 能 在 指定 流 中 丢失 的 字段 
[SerializationInfo] 本 质 上 ， 这 个 类 是 一 个 “属性 包 ”， 持 有 在 序列 化 过 程 中 表示 对 和 象 状 态 的 名 称 / 值 对 


20.20.1 深入 了 解 对 象 序列 化 


在 检验 可 以 用 来 自 定义 序列 化 过 程 的 不 同方 法 之 前 ， 有 必要 深入 了 解 在 后 台 发 生 了 什么 。 当 
BinaryFormatter 序 列 化 一 个 对 象 图 时 ， 它 负责 传送 下 面 的 信息 到 指定 的 流 。 

口 在 对 象 图 中 对 象 的 完全 限定 名 ( 如 MyApp.JamesBondCar )。 

口 定义 对 象 图 的 程序 集 名 称 ( 如 MyApp.exe )。 

口 serializationInfo 类 的 一 个 实例 ， 包 含 了 所 有 由 对 象 图 成 员 保 存 的 所 有 描述 性 数据 。 
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在 反 序 列 化 过 程 中 ，BinaryFormatter 使 用 相同 的 信息 建立 对 象 的 一 模 一 样 的 副本 , 使 用 从 基层 流 
中 提取 的 信息 ，SoapFormatter 使 用 的 过 程 也 和 序列 化 相似 。 


说 明 回想 一 下 : XmlSerializer 不 能 持久 化 一 个 类 型 的 完全 限定 名 称 或 定义 的 程序 集 的 名 称 以 保证 对 
象 状态 尽 可 能 轻巧 。 这 些 类 型 仅仅 与 持久 化 公开 的 字段 数据 相关 。 


除了 因为 要 将 需要 的 数据 移 人 或 移出 流 ， 格 式 化 程序 也 采用 下 面 的 基本 办 法 来 分 析 对 象 图 中 的 
成 员 。 
口 做 一 个 检测 来 确定 对 象 是 否 被 标记 了 [Serializable] 特 性 。 如 果 对 象 没 有 标记 ， 则 抛 出 
SerializationException。 
口 如 果 对 象 被 标记 了 [Serializable], 做 一 个 检测 来 确定 对 象 是 否 实现 了 ISerializable 接 口 ， 如 
果 是 ，Get0bjectData() 方 法 会 在 对 象 上 调用 。 
口 如 果 对 象 没有 实现 ISerializable ， 使 用 默认 的 序列 化 过 程 ， 序 列 化 所 有 没有 被 标记 为 
[NonSerialized] 的 字段 。 
除了 确定 类 型 是 否 支 持 ISerializable 外 ,格式 化 程序 也 负责 发 现 类 型 是 否 支 持 被 [0nSeriali- 
zing] 、[OnSerialized] 、[OnDeserializing] 或 [OnDeserialized] 等 特性 修饰 的 成 员 。 我 们 稍 后 将 学 习 
这 些 特性 的 作用 ， 首 先 看 看 ISerializable 的 作用 。 


20.20.2 ”使 用 ISerializable 自 定义 序列 化 


被 标记 了 [Serializable] 的 对 象 拥有 了 实现 ISerializable 接 口 的 选项 。 这 样 可 以 更 为 深入 地 “ 涉 
足 ” 序 列 化 过 程 并 可 以 执行 任何 前 数据 和 后 数据 格式 化 。 


说 了 明 从 .NET 2.0 发 布 之 后 ， 自 定义 序列 化 的 过 程 推荐 使 用 序列 化 特性 ( 后 面 会 介绍 )。 然 而 ， 如 果 
要 维护 婚 有 系统 的 话 ， 了 解 ISerializable 也 很 重要 。 


这 个 接口 十 分 简单 ， 因 为 它 只 定义 了 一 个 简单 的 方法 Get0bjectData(): 


// 当 项 望 逆转 序列 化 过 程 时 ， 就 实现 ISerializable 
public interface ISerializable 


void GetObjectData(SerializationInfo info, 
StreamingContext context); 


Get0bjectData() 方 法 在 序列 化 过 程 期 间 被 给 定 的 格式 化 程序 自动 调用 。 该 方法 的 实现 用 一 系列 名 
称 / 值 对 填充 了 输入 的 SerializationInfo 参 数 ， 这 些 名 称 / 值 对 ( 通常 ) 映射 到 将 被 持久 化 对 象 的 字段 
数据 上 。 除 了 一 小 组 允许 类 型 获取 和 设置 类 型 名 称 的 属性 、 定 义 的 程序 集 和 成 员 计数 外 ， 
SerializationInfo 还 定义 了 多 种 不 同 的 重 载 的 AddValue() 方 法 。 这 里 是 部 分 代码 : 


public sealed class SerializationInfo 


public SerializationInfo(Type type, IFormatterConverter converter); 
public string AssemblyName { get; set; } 
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public string FullTypeName { get; set; } 

public int MemberCount { get; } 

public void AddValue(string name, short value); 
public void AddValue(string name, ushort value); 
public void AddValue(string name, int value); 


沪 
实现 ISerializable 接 口 的 类 型 也 必须 定义 一 个 带 有 下 面 签 名 的 特殊 构造 函数 : 


// 你 必须 提供 一 个 自 定 义 的 、 带 有 这 个 签名 的 构造 函数 ， 以 允许 运行 库 引 擎 设置 对 象 的 状态 
[Serializable] 
class SomeClass : ISerializable 





protected SomeClass (SerializationInfo si, StreamingContext ctx) {...} 


} 

注意 构造 区 数 的 可 见 性 被 设置 为 受 保护 的 ， 这 是 允许 的 ， 因 为 格式 化 程序 可 以 访问 这 个 成 员 而 不 
管 它 是 否 可 见 。 这 个 特殊 的 构造 函数 特意 被 标记 为 受 保护 的 ( 私有 )， 以 确保 不 熟悉 对 象 技术 的 新 用 
户 不 能 用 这 种 方式 建立 对 象 。 如 你 所 见 ， 构 造 函 数 的 第 一 个 参数 是 一 个 SerializationInfo 类 型 ( 参考 
前 文 ) 的 实例 。 

这 个 特殊 的 构造 也 数 的 第 二 个 参数 是 streamingContext 类 型 , 它 包 含 了 序列 化 流 的 源 的 有 关 信 息 。 
这 个 类 型 信息 量 最 大 的 成 员 是 State 属 性 ， 它 表示 StreamingContextStates 枚 举 中 的 值 。 该 枚 举 的 值 表 
示 当 前 流 的 基本 构成 。 

事实 上 ， 除 非 去 实现 一 些 低级 的 自 定义 远程 服务 ， 否 则 很 少 需 要 直接 处 理 这 个 枚 举 值 。 下 面 是 
StreamingContextStates 枚 举 可 能 的 名 字 ( 细节 请 参考 .NET Framework 4.5 SDK 文 档 ): 


public enum StreamingContextStates 


CrossProcess, 
CrossMachine, 
File, 
Persistence, 
Remoting, 
Other, 
Clone, 
CrossAppDomain, 
All 

} 


为 说 明 使 用 ISerializable 自 定义 序列 化 的 过 程 ， 假 设 创建 了 新 控制 台 应 用 程序 CustomSeria- 
lization， 它 定义 了 一 个 类 类 型 其 中 包含 两 个 字符 串 类 型 的 数据 。 此 外 ， 假 定 你 必须 确定 要 被 序列 化 
为 流 的 字符 串 对 象 全 是 大 写字 母 并 且 从 流 中 反 序列 化 为 小 写字 母 。 为 满足 这 个 规则 ， 可 以 像 下 面 这 样 
实现 ISerializable ( 一 定 要 导 和 人 System.Runtime.Serialization 命 名 空间 ): 


[serializable] 
class StringData : ISerializable 


private string dataItemOne = "First data block"; 
private string dataItemTwo= "More data"; 


public StringData(){} 
protected StringData(SerializationInfo si, StreamingContext ctx) 
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// 从 流 中 得 到 合并 的 成 员 变 量 
dataItemOne = si.GetString("First Item").ToLower(); 
dataItemTwo = si.GetString("dataIltemTwo").ToLower(); 


} 


void ISerializable.GetObjectData(SerializationInfo info, StreamingContext ctx) 


{ 
// 用 格式 化 数据 填充 SerializationInfo 对 象 
info.AddValue("First Item", dataIltemOne.ToUpper()); 
info.AddValue("dataItemTwo", dataItemTwo.ToUpper()); 


} 
. 


注意 ， 当 在 Get0bjectData() 方 法 里 填充 SerializationInfo 类 型 时 , 不 需要 为 数据 点 取 与 类 型 内 部 
成 员 变 量 一 样 的 名 字 。 如 果 需 要 从 持久 化 格式 中 更 进一步 地 解 看 类 型 的 数据 , 显而易见 这 是 很 有 用 的 。 
可 是 ， 要 知道 你 需要 使 用 和 分 配 在 GetobjectData() 中 的 相同 的 名 称 从 私有 构造 函数 中 得 到 值 。 

为 测试 自 定义 序列 化 ， 假 定 已 经 使 用 soapFormatter 持 久 化 了 一 个 MystringData 的 实例 ( 因此 更 新 
程序 集 引 用 并 相应 地 导入 命名 空间 ): 


static void Main(string[] args) 


{ 


Console.WriteLine("***** Fun with Custom Serialization *****"); 


// 这 个 类 型 实现 了 ISerializable 
StringData myData = new StringData(); 


// 以 SOAP 格 式 保存 到 本 地 文件 中 

SoapFormatter soapFormat = new SoapFormatter(); 

using(Stream fStream = new FileStream("MyData.soap", 
FileMode.Create, FileAccess.Write, FileShare.None)) 


soapFormat. Serialize(fStream, myData); 


Console.ReadLine(); 


} 
当 查 看 得 到 的 *.soap 文 件 时 ， 注 意 到 字符 串 字段 已 经 真正 地 被 持久 化 为 大 写字 母 了 。 


<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:clr="http://schemas.microsoft.com/soap/encoding/clr/1.0" 
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> 
<SOAP-ENV:Body> 


<al:StringData id="ref-1" ...> 
<First Item id="ref-3">FIRST DATA BLOCK</First Item> 
<dataItemTwo id="ref-4">MORE DATA</dataItemTwoy> 
</al:StringData> 
</SOAP-ENV:Body> 


</SOAP-ENV:Envelope> 


20.20.3 ”使 用 特性 定制 序列 化 
尽管 实现 ISerializable 接 口 来 定制 序列 化 过 程 还 是 可 能 的 ， 但 是 自 .NET 2.0 发 布 以 来 ， 定 制 序列 
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化 过 程 的 首选 方式 是 定义 一 些 具 有 新 的 序列 化 相关 特性 的 方法 〈 这 些 特性 如 [Onserializing]、 
[onserialized] 、[OnDeserializing] 或 [OnDeserialized] )。 使 用 这 些 特性 ， 减 少 了 实现 ISerializable 
的 麻烦 ， 因 为 不 需要 手动 与 输入 的 SerializationInfo 参 数 交 互 , 而 是 在 格式 化 程序 操作 该 类 型 时 直接 
修改 状态 数据 。 


说 明 这 些 序列 化 特性 定义 在 System.Runtime.Serialization 命 名 空间 中 。 


当 应 用 这 些 特性 时 ， 必 须 定义 方法 接收 一 个 StreamingContext 参 数 并 返回 空 〈( 否则， 将 收 到 一 个 
运行 时 异常 )。 注 意 ， 不 需要 说 明 每 一 个 与 序列 化 有 关 的 特性 ， 并 且 可 以 仅仅 只 处 理 你 感 兴趣 而 截取 
的 序列 化 阶段 。 举 例 来 说 ， 这 里 有 一 个 新 的 [Serializable] 类 型 ， 与 StringData 有 相同 的 需求 ， 这 次 
使 用 [onserializing] 和 [onDeserialized] 特 性 来 解决 : 


[Serializable] 
class MoreData 


private string dataItemOne = "First data block"; 
private string dataItemTwo= "More data"; 


[Onserializing] 
private void OnSerializing(StreamingContext context) 


{ 
// 在 序列 化 过 程 中 就 得 到 调用 
dataItemOne = dataItemOne.ToUpper(); 
dataItemTwo = dataItemTwo.ToUpper(); 


[onDeserialized] 
private void OnDeserialized(StreamingContext context) 


// 一 旦 反 序 列 化 过 程 结束 ， 就 得 到 调用 
dataItemOne = dataItemOne.ToLower(); 
dataItemTwo = dataItemTwo.ToLower(); 


} 
如 果 序 列 化 这 个 新 类 型 ， 将 再 次 发 现 数据 被 持久 化 为 大 写字 母 并 被 反 序 列 化 为 小 写字 母 。 


源 代 码 CustomSerialization 项 目的 源 代码 位 于 Chapter 20 子 目录 下 。 


这 些 示 例 给 我 们 介绍 了 有 关 对 象 序列 化 服务 ， 包 括 以 各 种 方式 定制 过 程 的 核心 细节 。 我 们 已 经 看 
到 , 序列 化 和 反 序 列 化 过 程 使 得 持久 化 大 量 数据 变 得 很 简单 ， 并且 结 合 System.I0 命 名 空间 中 的 各 种 读 
取 / 写 入 类 一 起 使 用 也 更 简单 。 


20.21 小 结 


本 章 一 开始 介绍 了 如 何 使 用 Directory(Info) 和 File(Info) 类 型 。 通 过 学 习 ， 我 们 知道 了 怎么 通过 
这 些 类 型 操作 硬盘 上 的 物理 文件 或 目录 。 接 着 我 们 研究 了 许多 从 Stream 抽 象 类 派生 的 类 型 。 因 为 从 
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Stream 派 生 的 类 型 操作 的 是 原始 字 节 流 ， 所 以 system.I0 命 名 空间 提供 了 很 多 读 取 器 /编写 器 类 型 (如 
StreamWriter、StringWriter 和 BinaryWriter ) 来 简化 这 个 读 写 过 程 。 同 样 ， 我 们 也 了 解 了 DriveType 
提供 的 功能 , 并 且 学 习 了 如 何 使 用 FilesystemWatcher 类 型 来 监控 文件 以 及 如 何 使 用 异步 方式 和 流 进行 
交互 。 

本 章 还 介绍 了 对 象 序列 化 服务 的 主题 。 可 见 ，.NET 平 台 使 用 一 个 对 象 图 恰当 地 说 明了 要 持久 化 到 
流 中 的 完整 的 相关 对 象 组 。 只 要 对 象 图 中 的 每 个 成 员 标 记 了 [Serializable] 特 性 ， 数 据 就 可 以 通过 你 
选择 的 格式 (二进制 或 SOAP ) 来 进行 持久 化 。 

本 章 还 介绍 了 使 用 两 种 可 能 的 方法 定制 序列 化 过 程 。 首 先 介绍 了 如 何 实现 ISerializable 接 口 (并 
支持 一 个 特殊 的 私有 构造 函数 )， 从 而 更 深入 地 干预 如 何 让 格式 化 程序 持久 化 所 提供 的 数据 。 接 下 来 ， 
介绍 了 一 组 .NET 新 特性 ， 它 们 简化 了 自 定义 序列 化 的 过 程 。 只 需 在 带 StreamingContext 参 数 的 成 员 上 
应 用 [OnSerializing] 、[OnSerialized] 、[OnDeserializing] 或 [onDeserialized] 特 性 ， 格 式 化 程序 就 
会 相应 地 调用 它们 。 





ADONET 之 一 








| .NET 平 台 定 义 了 许多 命名 空间 ， 统 称 为 ADO.NET。 本 章 首先 
总 体 介 绍 ADO.NET 的 作用 ， 然 后 会 重点 讨论 ADO.NET 的 数据 提供 程序 。.NET 平 台 支持 
许多 数据 提供 程序 ， 每 一 个 都 为 与 特定 数据 库 管理 系统 ( 微软 SQL Server、Oracle、MySQL 等 ) 进行 
通信 做 了 优化 。 
理解 了 各 个 数据 提供 程序 的 常用 功能 后 ， 我 们 会 介绍 数据 提供 程序 工厂 模式 。 使 用 System.Data. 
Common 命 名 空间 下 的 一 些 类 型 ( 和 相关 的 App.config 文 件 ) 后 ， 只 需要 构建 单个 代码 库 就 能 实现 动态 选 
择 和 设置 基本 的 数据 提供 程序 ， 整 个 应 用 程序 代码 无 需 重 新 编译 和 部 署 。 
可 能 最 重要 的 是 , 本 章 会 构建 一 个 自 定义 的 数据 访问 库 程序 集 ( AutoLotDAL.dll )， 它 会 封装 在 自 
定义 数据 库 AutoLot 上 进行 的 各 种 操作 。 这 个 库 会 在 第 23 章 和 第 24 章 中 进行 扩展 ， 并 且 会 在 本 书后 面 
几 章 中 广泛 使 用 。 最 后 我 们 会 研究 数据 库 事务 。 


21.1 ADO.NET 的 宏观 定义 


如 果 你 曾 使 用 过 微软 先前 的 一 些 基 于 COM 的 数据 访问 模型 ( Active Data Object，ADO ) 的 话 ， 你 
会 发 现 ADO.NET 已 经 和 ADO 没 有 什么 关系 了 ， 而 且 ADO.NET 已 经 超越 了 A、D 、O 这 3 个 字母 的 概念 
虽然 不 可 否认 ， 这 两 个 体系 之 间 还 是 有 些 联系 的 ( 比如 说 连接 对 象 和 命令 对 象 的 概念 )， 但 一 些 ADO 
中 常见 的 类 型 ( 比如 Recordset ) 在 ADO.NET 中 已 经 没有 了 。 此 外 , ADO.NET 还 新 增 了 许多 在 传统 ADO 
中 找 不 到 直接 对 应 的 新 类 型 ( 比如 数据 适配器 )。 

传统 ADO 主 要 针对 紧密 连接 的 客户 端 / 服 务 器 端 系统 ， 而 ADO.NET 考 虑 到 了 断 开 连接 式 应 用 并 且 
引进 了 Dataset。 它 代表 任意 数量 的 关联 表 ， 其 中 每 个 表 都 包含 了 行 和 列 的 集合 的 本 地 副本 。 使 用 
DataSet 的 话 ， 在 断 开 数 据 库 连 接 的 情况 下 调用 程序 集 ( 如 Web 页 面 或 者 桌面 可 执行 程序 ) 处 理 和 更 新 
它 的 内 容 ， 然 后 使 用 关联 的 数据 适配器 把 修改 后 的 数据 提交 回 数据 库 。 

从 编程 的 角度 来 看 ，ADO.NET 大 部 分 由 System.Data.dll 核 心 程序 集 来 表示 。 在 这 个 二 进 制程 序 集 
中 ， 我 们 可 以 找到 许多 命名 空间 ( 如 图 21-1 所 示 )， 其 中 很 多 都 表示 某 个 ADO.NET 数 据 提 供 程序 ( 稍 
后 会 介绍 )。 
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Object Browser + X Start page 
Browse: ,NET Framework 4.5 vi | | 从 - 





<Search> i a = 
上 nt System.Core ^ 
Stem. ota 
b {} Microsoft.SailServer.Server 
{} System.Data 
{) System.Data.Common 
{} System.Data.Odbc 
{} System.Data.OleDb 
{} Systermn.Data,Sql 
{} System,.DataSqiClient 
{} System,Data.SqlTypes 
(} System.Xml 
> wa System,Data.DataSetExtensions 


b> sw System.Data.Entity Assembly System.Data 
by wa System.Data.Entity.Design Member of .NET Framework 4.5 i 


bp sa System.Data.Ling CAProgram Files {x85)\Reference Assemblies\Microsott A 
y wm System.Data.OracleClient Framework\, NETFramework\vs,5\System.Data.dil 

| b> System.Data.Services 

| 上 wa System.Data.Services,Client 
上 wa System.Data.Services,Design tribute(1. 0, 3300 0) 


DN System.Datn.SqiXml ”System.Reflection.AssembiyCompanyAttribute("Microsoft 
1 Corporation") Es 


图 21-1 System.Data.dl] 是 核心 ADO.NET 程 序 集 


其 实 , 大 多 数 Visual Studio 项 目 模板 会 自动 引用 这 个 核心 数据 访问 库 。 要 知道 , 还 有 一 些 ADO.NET 
相关 的 程序 集 不 在 System.Data.dll 中 ， 我 们 需要 通过 Add Reference 对 话 框 来 手动 引入 到 当前 项 目 中 。 


和 -AE 


了 


Attributes: 
[System.Runtime.InteropServices.ComCompatibleVersionAt 


ADO.NET 的 三 面 


从 概念 上 来 说 ，ADO.NET 类 库 有 三 种 完全 不 同 的 方式 来 实现 数据 访问 : 连接 式 、 断 开 式 和 通过 
Entity 框 架 。 当 使 用 连接 式 的 时 候 (本 章 的 主题 )， 你 的 代码 需要 显 式 连接 或 者 断 开 基层 数据 源 。 用 这 
种 方式 使 用 ADO.NET 时 ， 通 常会 用 到 连接 对 象 、 命 令 对 象 和 数据 读 取 器 对 象 来 实现 这 样 的 数据 交互 。 

男 一 方面 ， 断 开 式 数据 访问 详细 介绍 见 第 22 章 ) 允许 通过 一 组 DataTable 对 象 ( 保存 在 DataSet 
中 ) 来 获取 外 部 数据 的 一 个 客户 端 副 本 。 当 你 通过 相关 的 数据 适配器 对 象 来 获取 DataSet 的 时 候 , 数据 
连接 会 自动 打开 或 关闭 。 你 可 能 也 猜 到 了 ， 这 样 能 快速 释放 连接 以 便 其 他 调用 者 使 用 ， 也 极 大 增加 了 
系统 的 可 伸缩 性 。 

一 旦 获取 了 一 个 DataSset 后 , 就 能 在 不 需要 花费 网 络 流量 的 情况 下 随意 修改 内 容 。 同 样 ， 如 果 你 想 
把 修改 后 的 结果 重新 提交 回 数据 库 ， 需 要 再 次 使 用 数据 适配器 对 象 ( 关联 一 组 SQL 语句 ) 来 更 新 数据 
源 ， 此 时 连接 会 为 数据 库 更 新 重新 打开 并 在 结束 操作 后 会 立即 被 关闭 。 

最 终 在 第 23 章 ， 我 们 将 介绍 一 个 数据 访问 API， 叫 做 Entity Framework ( 简称 EF ) 。 借 助 EF 可 以 用 
封装 了 大 量 数据 库 底层 细节 的 客户 端 对 象 与 关系 型 数据 库 交 互 。 同 样 , EF 编程 模型 还 可 以 使 用 LINQ to 
Entity 语 法 ， 用 强 类 型 的 LINQ 查 询 与 关系 型 数据 库 交 互 。 
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21.2 ADO.NET 数据 提供 程序 


ADO.NET 没 有 提供 单一 对 象 集 来 和 多 个 数据 库 管 理 系 统 ( DBMS ) 进行 通信 ,而 是 提供 了 多 种 数 
据 提 供 程序 ， 每 种 为 某 个 DBMS 进 行 优化 。 这 种 方法 的 好 处 是 ， 一 来 能 以 编程 方式 利用 DBMS 独 有 的 
一 些 特 性 ， 二 来 能 直接 和 基层 的 DBMS 引 擎 进 行 连接 而 不 需要 为 不 同 的 DBMS 做 中 间 的 映射 层 。 

简单 来 说 , 数据 提供 程序 是 一 组 定义 在 用 于 和 特定 的 数据 源 类 型 进行 通信 的 命名 空间 内 的 一 组 类 
型 。 不 管 你 用 的 是 哪 种 数据 提供 程序 ， 它 们 都 有 一 系列 类 来 提供 核心 功能 ， 表 21-1 列 举 了 一 些 核心 公 
共 对 象 、 它 们 的 基 类 ( 都 定义 在 System.Data.Common 命 名 空间 内 ) 和 它们 实现 的 以 数据 为 中 心 的 接口 
( 都 定义 在 System.Data 命 名 空间 内 )。 


表 21-1 ADO.NET 数 据 提 供 程序 的 一 些 核心 对 象 





对 象 基 类 实现 的 接口 作 用 
Connection DbConnection IDbConnection 连接 和 断 开 数据 源 ， 提 供 了 相关 事务 
对 象 的 访问 
Command DbCommand IDbCommand 代表 SQL 查询 语句 或 者 存储 过 程 名 ， 同 
样 提供 了 相关 数据 读 取 器 对 象 的 访问 
DataReader DbDataReader IDataReader 和 IDataRecord 提供 只 读 只 向 前 形式 的 数据 访问 
DataAdapter DbDataAdapter IDataAdapter 和 IDbDataAdapter 在 数据 库 和 调用 者 之 间 传 递 DataSet , 内 


置 4 个 命令 对 象 来 实现 数据 的 查询 、 插 
人 人、 修改 和 删除 操作 


Parameter DbParameter IDataparameter 和 IDbDataparameter 在 参数 化 查询 中 表示 参数 
Transaction DbTransaction IDbTransaction 实现 数据 库 事务 


尽管 这 些 类 的 命名 对 于 不 同 的 数据 提供 程序 不 尽 相 同 ( 比如 SqlConnection 和 0racleConnection、 
0dbcConnection 和 MySqlConnection )， 但 是 它们 都 从 相同 的 基 类 ( 就 连接 对 象 而 言 ， 是 DbConnection ) 
继承 并 且 实 现 相 同 的 接口 ( 如 IDbConnection )。 这 样 的 话 ， 一 旦 你 掌握 了 一 种 数据 提供 程序 的 用 法 ， 
学 习 其 他 的 数据 提供 程序 就 非常 简单 了 。 


说 了 明 在 ADO.NET 下 谈 到 “连接 对 象 ” 时 ， 大 多 指 从 DbConnection 派 生 的 类 型 没有 直接 叫 
“Connection” 的 类 。 对 于 “命令 对 象 ” “数据 适配器 对 象 ” 等 也 一 样 。 按 照 命 名 惯例 ， 特 定 
数据 提供 程序 中 类 的 命名 都 以 相关 的 DBMS 名 字 作 为 前 组 (如 SqlConnection、0OracleConnec- 
tion 和 SqlDataReader ) 。 


图 21-2 演 示 了 ADO.NET 数 据 提供 程序 的 大 致 情况 。 注 意 ， 图 中 的 客户 程序 集 代 表 任 何 .NET 应 用 
程序 : 控制 台 程序 、WindowsForms 程 序 、WPF 程 序 、ASPNET 网 页 、WCEF 服 务 、NET 类 库 等 。 
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图 21-2 ADO.NET 数 据 提 供 程序 提供 了 对 特定 DBMS 的 访问 
肯定 还 有 许多 数据 提供 程序 的 类 在 图 21-2 中 没有 显示 ,但 是 所 有 的 数据 提供 程序 都 有 这 些 核心 类 。 
21.2.1 微软 提供 的 ADO.NET 数 据 提 供 程 序 


微软 的 .NET 提 供 了 Oracle 、SQL Server 和 OLE DB/ODBC 系 列 等 众多 的 数据 提供 程序 。 表 21-2 列 举 
了 每 一 个 ADO.NET 数 据 提供 程序 的 命名 空间 和 包含 它们 的 程序 集 。 


表 21-2 ”微软 ADO.NET 数 据 提 供 程 序 


数据 提供 程序 命名 空间 程 序 集 
OLE DB System.Data.01eDb System.Data.d]1 
Microsoft SQL Server System.Data.SqlClient System.Data.dll 
Microsoft SQL Server Mobile System.Data.SqlServerCe System.Data.SqlServerCe.dll 
ODBC System.Data.0dbc System.Data.d]1 


说 明 没有 特定 的 数据 提供 程序 直接 映射 到 Jet 引 擎 ( 比如 微软 Access 数 据 库 )。 如 果 要 和 Access 数 据 
文件 交互 ， 可 以 使 用 OLE DB 数据 提供 程序 或 者 ODBC 数 据 提供 程序 。 


由 定义 在 System.Data.01eDb 命 名 空间 下 的 类 组 成 的 OLE DB 数据 提供 程序 能 让 你 访问 所 有 支持 基 
于 传统 COM 的 OLE DB 协议 的 数据 库 。 使 用 这 个 数据 提供 程序 ， 能 非常 简单 地 改变 连接 字符 串 中 的 
“Provider”， 并 能 和 各 种 OLE DB 数据 库 进行 通信 。 

需要 知道 的 是 ， 其 实 OLE DB 数据 提供 程序 在 后 台 调用 各 种 COM 对 象 来 实现 数据 交互 ， 这 可 能 会 
影响 程序 的 性 能 。 基 本 上 当 某 个 DBMS 没 有 对 应 的 .NET 数 据 提供 程序 时 ， 我 们 才 会 用 OLE DB 数据 提 
供 程序 。 然 而 ， 其 实 称 职 的 DBMS 都 应 该 有 自 定义 的 ADO.NET 数 据 提供 程序 提供 下 载 ，System.Data. 
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01eDb 应 该 被 认为 是 遗留 命名 空间 ， 它 在 .NET 4.5 的 世界 中 用 处 很 少 ( .NET 2.0 下 出 现 的 数据 提供 程序 
工厂 模型 可 能 还 会 让 它 有 点 用 ， 这 会 在 稍 后 讨论 )。 


说 明 ”有 一 种 情况 必须 要 使 用 System.Data.0leDb， 那 就 是 如 果 我 们 需要 和 微软 SQL Server 6.5 或 更 低 
的 版 本 交互 的 话 。System.Data.SqlClient 命 名 空间 只 可 以 和 微软 SQL Server 7.0 或 更 高 的 版 本 
进行 通信 。 


微软 SQL Server 数 据 提供 程序 提供 了 对 SQL Server 数 据 存储 的 直接 访问 〈 而 且 仅 仅 是 7.0 版 本 以 及 
更 高 版 本 的 SQL Server )。System.Data.SqlClient 命 名 空间 包含 SQL Server 数 据 提供 程序 的 一 些 类 ， 并 
且 提 供 了 和 OLE DB 数据 提供 程序 差不多 的 一 些 功能 ， 但 是 主要 的 区 别 是 它 绕 开 OLE DB 层 进 行 访问 ， 
带 来 的 效率 显而易见 。 同 样 ，SQL Server 数 据 提供 程序 也 能 很 好 利用 DBMS 的 一 些 特 性 。 

微软 支持 的 其 他 提供 程序 ( System.Data.0dbc 和 System.Data.SqlClientCe ) 提供 了 对 ODBC 连 接 以 
及 SQL Server 移 动 版 本 的 交互 性 DBMS (通常 用 于 诸如 Windows Mobile 之 类 的 手持 设备 ) 的 访问 。 通 
常 只 有 当 需 要 与 没有 自 定义 .NET 数 据 提供 程序 的 DBMS 通 信 时 ， 定 义 在 System.Data.0dbc 命 名 空间 中 
的 ODBC 类 型 才 有 用 ， 因 为 ODBC 是 对 很 多 数据 存储 提供 访问 的 通用 模型 。 


21.2.2 关于 System.Data.OracleClient.dll 


.NET 平 台 的 较 早 版 本 包含 System.Data.OracleClient.dll 程 序 集 。 顾 名 思 义 ， 它 是 用 来 与 Oracle 数 据 
库 通信 的 数据 提供 程序 。 但 在 .NET 4.0 中 ， 该 程序 集 被 标记 为 过 时 的 ， 并 且 最 终 将 被 弃 用 。 

乍 看 上 去 ， 你 可 能 会 担心 ADO.NET 正 在 慢 慢 将 所 有 注意 力 集 中 到 微软 的 数据 存储 上 来 ， 但 其 实 
并 不 是 这 样 。Oracle 自 己 提 供 了 一 个 自 定 义 的 .NET 程 序 集 , 它 与 微软 提供 的 数据 提供 程序 遵循 了 同 
样 的 数据 规范 。 如 果 要 获得 该 NET 程序 集 ， 可 以 访问 Oracle 网 站 的 下 载 区 : 


www.oracle.com/technology/tech/windows/odpnet/index.html 


21.2.3 选择 第 三 方 的 数据 提供 程序 


除了 微软 自 带 的 数据 提供 程序 (和 Oracle 的 自 定义 NET 类 库 ) 以 外 ， 还 有 很 多 针对 各 种 开源 和 商业 
数据 库 的 第 三 方 数 据 提供 程序 .虽然 我 们 更 希望 直接 从 数据 库 提 供 商 这 里 获得 ADO.NET 的 数据 提供 程 
序 ， 但 是 也 应 该 知道 这 个 网 站 (请 注意 这 个 URL 可 能 会 改变 ): 

http://www.sqlsummit.com/DataProv.htm 

这 个 网 站 列 出 了 每 一 个 已 知 的 ADO.NET 数 据 提供 程序 以 及 更 多 信息 和 下 载 的 链接 ,在 这 里 我 们 能 
找到 许多 ADO.NET 提 供 程 序 ， 包 括 SQLite、IBMDB2、MySQL 、PostgreSQL 和 Sybase 等 。 

由 于 ADO.NET 数 据 提供 程序 数量 众多 ， 本 章 中 的 示例 会 使 用 微软 SQL Server 数 据 提供 程序 
( System.Data.SqlClient.dll ) 。 回 忆 一 下 ， 这 个 提供 程序 允许 我 们 和 微软 SQL Server 7.0 及 更 高 的 版 本 进 
行 交 互 , 包括 SQL Server Express 版 。 如 果 希 望 使 用 ADO.NET 和 其 他 DBMS 交 互 , 那么 在 理解 了 后 面 介 
绍 的 内 容 后 ， 应 该 就 没什么 问题 了 。 
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21.3 ”其 他 的 ADO.NET 命名 空间 


除了 定义 特定 数据 提供 程序 类 型 的 一 些 .NET 命 名 空间 外 ，.NET 基 础 类 库 同样 还 包含 了 一 些 男 外 
的 与 ADO.NET 相 关 的 命名 空间 ， 如 表 21-3 所 示 ( 同样 ， 第 23 章 会 介绍 与 Entity 框 架 相 关 的 程序 集 和 命 
名 空间 )。 

表 21-3 ”其 他 的 ADO.NET 相 关 的 命名 空间 

















命名 空间 作 用 
Microsoft.SqlServer.Server 这 个 命名 空间 提供 的 类 型 促进 CLR 和 SQL Server 2005 及 后 续 版 本 的 集成 服务 
System.Data 这 个 命名 空间 定义 了 各 种 数据 提供 程序 所 用 的 主要 类 型 ,包括 公共 接口 和 断 开 
连接 层 的 许多 类 型 ( 如 DataSet 和 DataTable 等 ) 
System.Data.Common 这 个 命名 空间 包含 了 各 种 数据 提供 程序 共享 的 类 型 ， 也 包括 公共 抽象 基 类 
System.Data. Sql 这 个 命名 空间 能 使 你 发 现 安装 在 当前 本 地 网 络 的 SQL Server 的 实例 
System.Data.SqlTypes 这 个 命名 空间 包含 微软 SQL Server 中 使 用 的 本 机 数据 类 型 。 尽管 你 可 能 不 会 直 


接 使 用 相应 的 CLR 数 据 类 型 ， 但 是 可 以 优化 SqlTypes 来 和 SQL Server 交 互 ( 例 
如 ， 如 果 SQLServer 数 据 库 包含 整数 值 ， 你 可 以 使 用 int 或 5qlTypes.SplInt32 
来 表示 它 ) 
由 于 篇 幅 限 制 ， 本 章 不 会 研究 每 个 ADO.NET 命 名 空间 中 的 每 个 类 型 。 然 而 ， 非 常 有 必要 理解 
System.Data 命 名 空间 下 的 一 些 类 型 。 


21.4 System.Data 命名 空间 的 类 型 


在 ADO.NET 各 种 命名 空间 中 ， 就 属 System.Data 最 常用 了 。 如 果 不 在 数据 访问 应 用 程序 里 指定 
System.Data 命 名 空间 ， 基 本 上 不 能 建立 任何 ADO.NET 应 用 程序 。 这 个 命名 空间 包含 了 所 有 ADO.NET 
数据 提供 程序 的 一 些 不 和 基层 数据 库 相关 的 公共 类 型 。 除 了 许多 数据 库 方面 的 异常 类 型 (如 
NoNullAllowedException、RowNotInTableException 和 MissingPrimaryKeyException 等 ) 外 ，System.Data 
还 包含 了 各 种 数据 库 的 基本 类 型 ( 如 表 、 行 、 列 和 约束 等 )， 同 样 它 还 包含 了 所 有 数据 提供 程序 对 象 
所 实现 的 一 些 公共 接口 。 表 21-4 列 举 了 其 中 的 一 些 核心 类 型 。 


表 21-4 System.Data 命 名 空间 的 核心 成 员 








类 型 作 用 
Constraint 表示 某 个 DataColumn 对 象 的 约束 
DataColumn 表示 某 个 DataTable 对 象 中 的 一 列 
DataRelation 表示 两 个 DataTable 对 象 之 间 的 父子 关系 
DataRow 表示 某 个 DataTable 对 象 中 的 一 行 
DataSet 由 多 个 相关 DataTable 对 象 组 成 的 内 存 中 的 数据 缓存 
DataTable 表示 内 存 数据 的 一 个 表 


DataTableReader 使 你 能 像 fire-hose 游 标 〈 只 读 向 前 ) 那样 获取 DataTable 


21.4 System.Data 命名 空间 的 类 型 ”659 





( 续 ) 
类 型 作 用 
DataView 表示 用 于 排序 、 筛 选 、 搜 索 、 编 辑 和 导航 的 DataTable 的 自 定义 视图 
IDataAdapter 定义 了 数据 适配器 对 象 的 主要 行为 
IDataparameter 定义 了 参数 对 象 的 主要 行为 
IDataReader 定义 了 数据 读 取 器 对 象 的 主要 行为 
IDbCommand 定义 了 命令 对 象 的 主要 行为 
IDbDataAdapter 对 IDataAdapter 的 一 个 扩展 ， 增 加 了 数据 适配器 对 象 的 一 些 功 能 
IDbTransaction 定义 了 事务 对 象 的 主要 行为 


System.Data 中 的 绝 大 多 数 类 都 在 进行 ADO.NET 断 开 连 接 层 编 程 时 使 用 。 在 下 一 章 中 ， 我 们 会 进 
而 了 解 DataSet 以 及 相关 类 型 ( 如 DataTable、DataRelation 和 DataRow 等 ) 的 细节 ， 并 且 了 解 如 何 使 用 
它们 (以 及 相关 数据 适配器 ) 来 表示 和 操作 远程 数据 的 客户 端 副本 。 

而 接 下 来 的 任务 是 进一步 了 解 System.Data 的 一 些 主要 接口 , 这 样 能 更 好 地 理解 数据 提供 程序 的 一 
些 常 用 功能 。 整 个 章节 都 会 贯穿 介绍 它们 的 细节 ， 先 来 看 一 下 每 一 个 接口 类 型 的 主要 行为 。 


21.4.1 IDbConnection 接 口 的 作用 


首先 是 由 数据 提供 程序 的 连接 对 象 实现 的 IDbConnection 类 型 , 这 个 接口 定义 了 一 系列 用 于 配置 
某 个 数据 库 连 接 的 一 些 成 员 。 通 过 它 ， 你 还 能 获取 一 个 数据 提供 程序 的 事务 对 象 。 下 面 是 这 个 接口 
的 定义 : 


说 明 


public interface IDbConnection : IDisposable 


string ConnectionString { get; set; } 
int ConnectionTimeout { get; } 

string Database { get; } 
ConnectionState State { get; } 


IDbTransaction BeginTransaction(); 

IDbTransaction BeginTransaction(IsolationLevel i]l); 
void ChangeDatabase(string databaseName); 

void Close(); 

IDbCommand CreateCommand(); 

void Open(); 


和 .NET 基 础 类 库 中 的 其 他 类 型 相似 , 调用 Close() 方 法 从 功能 上 说 和 直接 调用 Dispose() 方 法 或 
间接 使 用 C# using 作 用 域 一 样 ( 见 第 13 章 )。 


21.4.2 ”IDbTransaction 接 口 的 作用 
我 们 发 现 IDbConnection 接 口 定义 的 已 重 载 的 BeginTransaction() 方 法 提供 了 一 个 数据 提供 程序 的 
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事务 对 象 。 使 用 IDbTransaction 接 口 定义 的 成 员 ， 你 能 够 以 编程 方式 在 事务 会 话 和 基层 的 数据 存储 之 
间 进 行 交 互 : 
public interface IDbTransaction : IDisposable 


IDbConnection Connection { get; } 
IsolationLevel IsolationLevel { get; } 


void Commit(); 
void Rollback(); 


21.4.3 ”IDbCommand 接 口 的 作用 


接 下 来 看 一 下 由 数据 提供 程序 的 命令 对 象 实现 的 IDbCommand 接 口 。 和 其 他 数据 访问 对 象 模型 一 样 ， 
命令 对 象 让 你 能 通过 编程 方式 处 理 SQL 语 句 、 存 储 过 程 和 参数 化 查询 。 另 外 ， 命 令 对 象 提供 了 已 重 载 
的 ExecuteReader() 方 法 来 访问 数据 提供 程序 的 数据 读 取 器 对 象 : 


public interface IDbCommand : IDisposable 

{ 
string CommandText { get; set; } 
int CommandTimeout { get; set; } 
CommandType CommandType { get; set; } 
IDbConnection Connection { get; set; } 
IDataparameterCollection Parameters { get; } 
IDbTransaction Transaction { get; set; } 
UpdateRowSource UpdatedRowSource { get; set; } 


void Cancel(); 

IDbDatapParameter CreateParameter(); 

int ExecuteNonQuery(); 

IDataReader ExecuteReader(); 

IDataReader ExecuteReader(CommandBehavior behavior); 
object ExecuteScalar(); 

void Prepare(); 


21.4.4 ”IDbDatapParameter 和 和 IDataParameter 接 口 的 作用 


注意 ，IDbCommand 的 参数 的 Parameters 属 性 返回 的 是 实现 IDataparameterCollection 的 强 类 型 化 的 
合 。 这 个 接口 提供 了 实现 IDbDataParameter 相 关 类 型 的 访问 〈 比如 参数 对 象 ): 


public interface IDbDatapParameter : IDataParameteT 


byte Precision { get; set; } 
byte Scale { get; set; } 
int Size { get; set; } 

} 


IDbDataParameter 接 口 扩展 了 IDatapParameter 接 口 来 实现 下 列 行为 : 


public interface IDataparameter 


DbType DbType { get; set; } 
ParameterDirection Direction { get; set; } 
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bool IsNullable { get; } 
string ParameterName { get; set; } 
string SourceColumn { get; set; } 
DataRowVersion SourceVersion { get; set; } 
object Value { get; set; } 

} 


我 们 知道 ，IDbDataParameter 和 IDataParameter 接 口 的 功能 是 让 我 们 能 通过 ADO.NET 的 参数 对 象 
来 表示 SQL 命令 和 存储 过 程 中 的 参数 ， 而 不 是 把 这 些 参 数 硬 编码 在 字符 串 字面 量 内 。 


21.4.5 ”IDbDataAdapter 和 IDataAdapter 接 口 的 作用 


数据 适配器 用 来 从 特定 的 数据 库 获 取 和 返回 Dataset。 基 于 此 ，IDbDataAdapter 接 口 定义 了 如 下 的 
属性 来 保存 实现 相关 的 选择 、 插 入 、 更 新 、 删 除 操作 的 SQL 语 句 : 


public interface IDbDataAdapter : IDataAdapter 


IDbCommand DeleteCommand { get; set; 
IDbCommand InsertCommand { get; set; 
IDbCommand SelectCommand { get; set; 
IDbCommand UpdateCommand { get; set; 


除了 这 4 个 属性 以 外 ，ADO.NET 数 据 适 配器 也 同样 实现 定义 在 父 接口 IDataAdapter 中 的 一 些 功 能 。 它 
定义 了 数据 适配器 类 型 的 一 些 主要 功能 : 使 用 Fil1() 和 Update() 方 法 在 调用 者 和 基层 数据 库 之 间 传 递 
DataSet。 同样 , 也 能 使 用 IDataAdapter 接 口 的 TableMappings 属 性 来 实现 数据 库 列 的 映射 , 使 列 名 更 加 友好 : 


public interface IDataAdapter 


MissingMappingAction MissingMappingAction { get; set; } 
MissingSchemaAction MissingSchemaAction { get; set; } 
ITableMappingCollection TableMappings { get; } 


int Fill(DataSet dataSet); 
DataTable[] FillSschema(DataSet dataSet, SchemaType schemaType); 
IDataparameter[] GetFillParameters(); 
int Update(DataSet dataSet); 
} 


21.4.6 IDataReader 和 IDataRecord 接 口 的 作用 


下 一 个 重要 的 接口 是 IDataReader， 它 定义 了 数据 读 取 器 对 象 的 一 些 常 用 行为 。 当 你 从 ADO.NET 
的 数据 提供 程序 获得 一 个 数据 读 取 器 相关 类 型 后 ， 就 能 使 用 它 以 只 读 向 前 的 形式 循环 提取 数据 : 
public interface IDataReader : IDisposable, IDataRecord 


int Depth { get; } 
bool IsClosed { get; } 
int RecordsAffected { get; } 


void Close(); 

DataTable GetSchemaTable(); 
bool NextResult(); 

bool Read(); 
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最 后 我 们 看 到 ，IDataReader 扩 展 了 IDataRecord， 后 者 定义 了 一 些 成 员 让 你 能 直接 从 流 中 获得 强 
类 型 化 的 数据 , 而 不 是 从 数据 读 取 器 的 重 载 索引 器 获得 普通 的 System.0bject 对 象 后 再 去 进行 强制 类 型 
转换 。 下 面 列 举 了 IDataRecord 定 义 的 部 分 GetXXX() 方 法 (完整 列表 请 参见 .NET Framework 4.5 SDK ): 


public interface IDataRecord 


int FieldCount { get; } 
object this[ string name ] { get; } 
object this[ int i ] { get; 
bool GetBoolean(int i); 

byte GetByte(int i); 

char GetChar(int i); 
DateTime GetDateTime(int i); 
decimal GetDecimal(int i); 
float GetFloat(int i); 

short GetInt16(int i); 

int GetInt32(int i); 

long GetInt64(int i); 


”bool IsDBNull(int i); 


说 明 IDataReader.IsDBNull() 方 法 可 以 用 于 在 从 数据 读 取 器 获取 值 之 前 以 编程 方式 查看 菜 个 字段 是 
否 被 设置 为 null ( 来 避免 触发 运行 时 异常 )。 回 忆 一 下 ，C# 支 持 可 空 数据 类 型 ( 见 第 4 章 )， 与 
可 空 数 据 列 交互 时 它 会 很 有 用 。 


21.5 ”使 用 接口 的 抽象 数据 提供 程序 


到 这 里 我 想 你 应 该 更 了 解 .NET 数 据 提供 程序 的 一 些 常 用 功能 了 。 前 面 说 过 ， 虽 然 各 种 数据 提供 程序 
的 实现 类 型 名 字 上 不 尽 相 同 ， 但 是 我 们 能 通过 一 种 优雅 的 形式 来 对 付 这 些 相似 的 对 象 ， 即 基于 接口 的 多 
态 。 因 此 ， 如 果 你 定义 一 个 使 用 IDbConnection 参 数 的 方法 ， 就 能 传递 任何 ADO.NET 连 接 对 象 ,如 下 所 示 : 


public static void 0penConnection(IDbConnection cn) 


{ 
// 为 调用 者 打开 传递 进来 的 连接 对 象 
cn.0pen(); 


说 明 接口 不 是 必需 的 ， 使 用 抽象 基 类 ( 如 DbConnection ) 作为 参数 或 返回 值 ， 也 会 得 到 相同 效果 。 


对 于 返回 值 可 以 同样 处 理 。 例 如 , 下 面 的 C# 控 制 台 应 用 程序 MyConnectionFactory 实 现 了 让 调用 者 
通过 使 用 一 个 自 定 义 的 枚 举 来 获得 需要 的 连接 对 象 ， 为 了 诊断 ,我们 会 通过 反射 服务 来 输出 底层 连接 
对 象 ， 然 后 输入 以 下 代码 : 


using System; 


// 需要 这 些 来 获取 公共 接口 的 定义 以 及 各 种 用 于 测试 的 连接 对 象 
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using System.Data; 

using System.Data.SqlClient; 
using System.Data.0dbc; 
using System.Data.01eDb; 


namespace MyConnectionFactory 


// 可 能 的 提供 程序 列表 
enum DataProvider 
{ SqlServer, OleDb, Odbc, None } 


class Program 
static void Main(string[] args) 
Console.Writeline("**** Very Simple Connection Factory *****\n"); 


// 获取 某 个 连接 
IDbConnection myCn = GetConnection(Dataprovider.SqlServer); 
Console.WritelLine("Your connection is a {0}", myCn.GetType().Name); 


// 打开、 使 用 和 关闭 连接 


Console.ReadLine(); 


} 
// 这 个 方法 根据 DataProvider 枚 举 值 返回 某 个 连接 对 象 


static IDbConnection GetConnection(DataProvider dp) 


IDbConnection conn = null; 
switch (dp) 


case Dataprovider.SqlServer: 
conn = new SqlConnection(); 
break; 

case Dataprovider.0leDb: 
conn = new OleDbConnection(); 
break; 

case DatapProvider.0dbc: 
conn = new OdbcConnection(); 
break; 


return conn; 


} 
} 


通过 使 用 System.Data 下 的 这 些 接口 (或 System.Data.Common 抽 象 基 类 ), 能 够 构建 一 个 灵活 的 代码 
库 ， 或 许可 以 不 用 加 班 了 。 可 能 你 现在 在 做 一 个 针对 SQL Server 的 应 用 程序 ， 但 是 公司 接 下 来 要 转向 
其 他 数据 库 平台 了 ， 怎么 办 呢 ? 如 果 你 的 程序 是 使 用 System.Data.SqlClient 进 行 硬 编码 的 ， 并 且 后 台 
数据 库 管理 系统 改变 的 话 ， 你 就 不 得 不 重新 修改 、 编 译 、 部 署 程序 集 。 


使 用 应 用 程序 配置 文件 增加 灵活 性 
为 进一步 增加 ADO.NET 应 用 程序 的 灵活 性 , 可 以 建立 一 个 客户 端 *.config 文 件 并 且 在 cappSettings> 
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元 素 下 使 用 一 对 自 定义 的 键 字 / 值 的 组 合 。 在 第 14 章 中 提 到 过 ， 我 们 能 通过 System.Configuration 命 名 
空间 内 的 一 些 类 来 以 编程 方式 获取 这 些 自 定义 数据 。 例 如 ,假设 你 已 经 在 配置 文件 内 指定 了 一 个 数据 
提供 程序 值 : 


<configuration> 
<appSettings> 
《!-- 这 个 键 值 映射 到 枚 举 值 中 的 某 个 值 --> 
<add key="provider" value="SqlServer"/> 
</appSettings> 
</configuration> 


这 样 ， 我 们 就 可 以 更 新 Main() ， 以 编程 方式 获得 底层 的 数据 提供 程序 。 为 此 ， 我 们 必须 构建 一 个 
连接 对 象 工 厂 , 以 便 在 不 重新 编译 代码 库 的 情况 下 ( 只 改变 *.config 文 件 ) 改 变 提供 程序 。 下面 是 Main() 
的 相关 更 新 : 


static void Main(string[] args) 
Console.WriteLine("**** Very Simple Connection Factory *****\n"); 


// 读 取 提 供 程序 键 
string dataprovString = ConfigurationManager.AppSettings["provider"]; 


// 把 字符 串 转 换 为 枚 举 
DataProvider dp = Dataprovider.None; 
if(Enum.IsDefined(typeof(Dataprovider), dataprovString)) 

dp = (DatapProvider)Enum.Parse(typeof(DataProvider)，dataProvString) ; 
else 

Console.WritelLine("Sorry, no provider exists!"); 


// 获取 某 个 连接 
IDbConnection myCn = GetConnection(dp); 
if(myCn != null) 
Console.WriteLine("Your connection is a {0}", myCn.GetType().Name); 


// 打开 、 使 用 和 关闭 连接 


Console.ReadLine(); 


说 明 要 使 用 ConfigurationManager 类 型 ， 请 确保 你 已 经 引用 了 System.Configuration.dll 程 序 集 并 且 导 
入 了 System.Configuration 命 名 空间 。 


至 此 , 我 们 已 经 编写 了 一 些 ADO.NET 代 码 以 允许 动态 指定 底层 连接 。 然而 , 一 个 很 明显 的 问题 是 ， 
这 个 抽象 只 能 在 MyConnectionFactory.exe 应 用 程序 中 使 用 。 如 果 我 们 重新 把 这 个 示例 转换 成 .NET 代 码 
类 库 ( 例如 MyConnectionFactory.dll ) , 就 可 以 构建 许多 客户 端 来 使 用 这 个 抽象 层 来 获取 各 种 连接 对 象 。 

然而 , 获取 连接 对 象 只 是 使 用 ADO.NET 的 一 个 方面 。 要 做 一 个 有 用 的 数据 提供 程序 工厂 库 , 我 们 
还 必须 处 理 命令 对 象 、 数 据 读 取 器 、 数 据 适 配器 、 事 务 对 象 以 及 其 他 数据 相关 的 类 型 。 虽 然 构 建 这 样 
一 个 代码 类 库 不 会 很 难 ， 但 是 的 确 需要 很 多 代码 以 及 相当 多 的 时 间 。 

幸好 .NET 2.0 发 布 之 后 ，Redmond 的 那些 好 人 已 经 在 .NET 基 础 类 库 中 直接 构建 了 这 个 功能 。 我 们 
稍 后 会 研究 这 个 正式 的 API， 但 是 首先 需要 创建 本 章 以 及 之 后 的 很 多 章节 都 会 使 用 的 自 定义 数据 库 。 
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源 代码 ”MyConnectionFactory 项 目的 源 代码 位 于 Chapter 21 子 目录 下 。 


21.6 创建 AutoLot 数据 库 


在 本 章 中 , 我 们 会 对 一 个 叫 AutoLot 的 简单 SQL Server 测 试 数据 库 执 行 查询 。 为 了 继续 探讨 本 书 中 
使 用 的 汽车 主题 ， 这 个 数据 库 会 包含 三 个 相关 表 ( Inventory、0rders 和 Customers ) ， 它 们 包含 表示 
虚拟 汽车 销售 公司 订单 的 各 种 数据 。 

在 这 里 我 们 假设 你 已 经 有 微软 SQL Server ( 7.0 或 更 高 版 本 ) 或 微软 SQL Server Express Edition。 如 
果 还 没有 ， 可 以 在 这 里 下 载 : 

www.microsoft.com/sqlserver/en/us/editions/2012-editions/express.aspx 

这 个 轻 量 级 的 数据 库 服务 器 完全 能 满足 我 们 的 需要 ， 一 是 因为 免费 ， 二 是 因为 它们 提供 了 GUI 前 
端 (SQL Server Management Tool ) 来 创建 和 管理 数据 库 ， 三 是 因为 它 可 以 和 Visual Studio/Visual C# 
Express 版 本 进行 整合 。 

为 了 说 明 上 面 的 问题 ， 本 节余 下 的 内 容 会 介绍 使 用 Visual Studio 构 建 AutoLot 数 据 库 。 如 果 使 用 
Visual C# Express， 也 可 以 通过 使 用 Database Explorer 窗 口 (可 以 从 View 一 OtherWindows 菜 单项 进行 加 
载 ) 执行 这 里 提 到 的 相似 操作 。 


说 明 ”要 知道 AutoLot 数 据 库 会 在 本 书 余 下 部 分 中 一 直 用 到 。 


21.6.1 创建 Inventory 表 


现在 就 来 构建 测试 数据 库 。 首 先 启动 Visual Studio, 通过 IDE 的 View 菜 单打 开 Server Explorer 窗 口 。 
接着 ， 右 击 Data Connection 节 点 并 有 上 且 选择 Create New SQL Server Database 菜 单项 ( 如 图 21-3 所 示 ) 。 


太一 | 过 各 芝 | 如 
5 ET 
bp 回 Servers 人 
> 图 SharePoint Conr 


Refresh 


Add Connection... 


Create New SQL Server Database... R 





图 21-3 ”使 用 Visual Studio 创 建新 的 SQL Server 数 据 库 


在 出 现 的 对 话 框 内 , 你 需要 在 Server name 文 本 框 中 输入 一 个 值 , 表示 数据 库 要 在 那 台 机 器 上 创建 。 
如 果 你 的 机 器 上 已 经 安装 了 SQL Server 完 整 版 本 , 输入 (local) 表 示 要 在 本 机 上 创建 数据 库 。 但 使 用 微软 
SQL Express 的 话 ， 需 要 输入 (local)\SQLEXPRESS。 

将 新 数据 库 命 名 为 AutoLot ( 选择 Windows Authentication， 如 图 21-4 所 示 )。 
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Enter information to connect to a SQL Server, then specify the 
name of a database to create. 

Server name: 

(loca)\SQLEXPRESS 


Log on to the server 


©®) Use Windows Authentication 
-) Use SQL Server Authentication 


Save my password 


New database name: 
AutoLot 











图 21-4 使 用 Visual pe Server Express 数 据 库 


至 此 , AutoLot 数 据 库 没 有 任何 数据 库 对 象 ( 如 表 和 存储 过 程 等 ) 。 要 插入 新 表 , 只 需要 右 击 Tables 
节点 并 且 选 择 Add New Table 项 ( 如 图 21-5 所 示 )。 


5: SERVER EXPLORER Uist nn 仆仆 全 知人 全 生生 村 
BRx<| 党 和 宇 上 | 吕 
日 “条 Data Connections 

4 好 manuandrew-pc\sqlexpress.AutoLot.dbo 


》 盯 Database Diagrams 


友 
瑚 Views Add New Table 


New Query 
Refresh 
pF Properties 
a Assemblies 


R 


b 
b 
D 
p 
p 
上 
Dp 
Serv 
S| 


虽 
图 SR Connections 





图 21-5 ”添加 Inventory 表 
使 用 表 编 辑 器 ， 添 加 4 个 数据 列 ( CarID 、Make 、Color 以 及 petName )， 类 型 均 为 varchar(50)。 确 保 
CarID 列 被 设置 为 主键 ( 通过 右 击 CarID 行 并 且 选 择 Set Primary Key )。 此 外 ,除了 carID 之 外 所 有 列 都 可 
以 设置 为 空 值 。 图 21-6 显 示 了 最 后 的 表 设 置 ( 不 需要 修改 Column Properties 编 辑 器 中 的 任何 项 , 但 要 注 
意 每 列 的 数据 类 型 )。 
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“dboInventory: Tabl...sqlexpress.AutoLot) XX ; > 
Column Name Data Type Allow Nulls 
8 carD int 国 
Make varchar(50) 加 
Color varchar(50) a 
PetName nchar(10) | 


[ Column properties | 








图 21-6 ”设计 Inventory 表 


创建 了 新 的 表 架 构 之 后 ,通过 Ctrl+S 或 File Save 来 保存 工作 。 此 时 ， 系 统 会 要 求 你 为 新 表 命名 。 在 
本 例 中 ， 我 们 将 表 命 名 为 Inventory。 完 成 后 应 该 可 以 在 Server Explorer 的 Tables 节 点 下 看 到 Inventory 表 。 


21.6.2 ”为 Inventory 表 添加 测试 记录 


要 为 第 一 个 表格 添加 记录 , 右 击 Inventory 表 图 标 , 选择 Show Table Data。 随便 输入 一 个 新 的 汽车 (为 
了 更 有 趣 ， 请 确保 让 一 些 汽车 有 相同 的 颜色 和 品牌 )。 图 21-7 显 示 了 可 能 的 库存 列表 。 


Inventory: Query(m..sqlexpress.AutoLot) 让 X Program.cs 有 
| | canp Make Color petName 
32 Vw Black Zippy 

83 Ford Rust Rusty 
| 872 Saab Black Mel 
| » 888 Yugo Yellow Clunker 
oo BMW Black Bimmer 
1011 BM Green Hank 
2911 BMW pink pinky 
: 米 NULL NULL NULL NULL 
M 4 4 of7 > Pi 区 


图 21-7 填充 Inventory 表 


668 第 21 章 ADO.NET 之 一 : 连接 层 


21.6.3 ”编写 GetPetName() 存 储 过 程 


在 本 章 后 面 , 我 们 会 研究 如 何 使 用 ADO.NET 来 调用 存储 过 程 。 你 可 能 已 经 知道 , 存储 过 程 一 般 保 
存在 某 个 数据 库 中 ， 并且 通常 对 表 数 据 进 行 操作 然后 返回 值 。 我 们 会 增加 一 个 存储 过 程 ， 根 据 提供 的 
CarID 来 返回 某 个 汽车 的 昵称 。 只 需要 在 Server Explorer 中 右 击 AutoLot 数 据 库 的 Stored Procedures 节 点 ， 
然后 选择 Add New Stored Procedure 就 可 以 完成 了 。 在 编辑 器 中 输入 下 面 的 代码 : 

CREATE PROCEDURE GetPetName 


@carID int， 
@petName char(10) output 
AS 


SELECT @petName = PetName from Inventory where CarID = @carID 

保存 过 程 之 后 , 它 会 根据 CREATE PROCEDURE 语 名 自动 命名 为 GetPetName( 注意 第 一 次 保存 时 , Visual 
Studio 会 自动 将 SQL 脚本 改 为 ALTER PROCEDURE )。 然 后 ， 我 们 就 可 以 在 Server Explorer 中 看 到 新 的 
存储 过 程 了 ( 如 图 21-8 所 示 )。 


: SERVER EXPLORER D:D oo 辣 汉 
人 | 常生 是 | 区 
品名 Data Connections 
4 旬 manuandrew-pc\sqlexpress,AutoLot.dbo 
咱 Database Diagrams 
4 曙 Tables 
b Inventory 
>” 上 Views 
4 盯 Stored Procedures 
. EE 
想 @cadD 
tm @petName 
上 咱 Functions 
朵 Synonyms 
里 Types 
Assemblies 


上 
上 
上 
Serv 
| Sha 


by 加 
> 图 i Connections 





图 21-8 ”GetPetName 存 储 过 程 


说 明 存储 过 程 不 是 都 需要 像 这 里 一 样 使 用 输出 参数 来 返回 数据 ， 不 过 ， 这 样 做 就 为 本 章 后 面 提 到 
的 SqlParameter 的 Direction 属 性 做 了 铺垫 。 
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21.6.4 ”创建 Customers 和 0rders 表 


AutoLot 数 据 库 还 会 有 另外 两 个 表 : Customers 表 和 0rders 表 。Customers 表 会 保存 顾客 列表 ， 其 中 
包括 3 列 (应 该 被 设置 为 主键 的 CustID, 还 有 FirstName 和 LastName )。 按 照 与 创建 Inventory 表 相同 的 步 
又 来 创建 如 下 结构 的 Customer 表 ( 如 图 21-9 所 示 )。 


dboTablez Table(..sqlexpress.AutoLot)” + X dbo.GetpetName: St..qlexpress.AutoLot) _ s 
Column Name Data Type Allow Nuills 
FirstName varchar(50) 贸 
LastName varchar(50) 凡 ] 


Column Properties | 





Data Type int 


Default Value or Binding | 
4 Table Designer 四 本 _ 本 EE _ whl 
(Generap 


图 21-9 ”设计 Customers 表 


在 为 表 命 名 并 保存 之 后 ， 增 加 一 些 顾客 记录 ( 如 图 21-10 所 示 )。 


Customers: Queryl...qlexpress.AutoLot)} + X OQbject Browser ee 
| | custD FirstName LastName 
[s g TT 
| 2 Matt Walton 
| 3 Steve Hagen 
| 4 pat Walton 
wk NULL NULL NULL 
1 of4 > pl | 03 


图 21-10 填充 Customers 表 
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最 后 一 个 表 0rders 会 用 于 表示 某 个 顾客 感 兴趣 的 汽车 ， 它 把 0rderID 值 映射 到 CarID/CustID 值 。 图 
21-11 显 示 了 最 后 表 的 结构 ( 再 次 注意 ，0rderID 是 主键 )。 


dbo.Table3: Table(sqlexpress, 六 utoLotj” 避 基 





Column Name Data Type Allow Nults 
De OrderlD int 
CustID int 四 
CariD int 加 


Column properties 














| Name) OrderiD | 
[Genent 和 i 











图 21-11 设计 0rders 表 


现在 ,为 0rders 表 添加 数据 。 假设 0rderID 值 从 1000 开 始 ， 为 每 一 个 CustID 值 选择 唯一 的 CarID ( 如 
图 21-12 所 示 )。 











“Orders: Query(manu...qlexpress.AutoLot) HX 一 
ordeg cup ca 
| 1000 1 1000 
| 1001 2 32 
1002 3 888 
1003 4 2911 
bw NULL NULL | 
| 
id 415 ofS|> pi | | 





图 21-12 填充 0rders 表 
我 们 可 以 看 到 ，Dave Brenner ( CustID=1 ) 对 黑色 的 BMW ( CarID=1000 ) 感 兴 趣 ， 而 Pat Walton 
( CustID=4 ) 关注 粉红 色 的 BMW ( CarID=2911 )。 
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21.6.5 可视化 创建 表 关系 


最 后 一 个 任务 就 是 在 Customers 、0rders 以 及 Inventory 表 之 间 创 建 关 系 。 使 用 Visual Studio 来 这 人 么 
做 很 简单 , 因为 我 们 只 需 在 设计 时 插入 新 数据 库 图 。 这 可 以 通过 下 面 的 方法 实现 : 使 用 Server Explorer， 
右 击 AutoLot 数 据 库 的 Database Diagram 节 点 ， 选 择 Add New Diagram 菜 单项 。 然 后 ， 请 确保 在 单 击 弹 


| 


| Iinventory 
| | 


] [ul][ 














图 21-13 ”选择 表 


要 创建 表 之 间 的 关系 , 首先 单 击 Inventory 表 的 CarID 键 ,然后 (保持 按 住 鼠标 按钮 ) 拖 放 到 Orders 
表 的 CarID 字 段 。 释 放 鼠 标 并 接受 弹出 对 话 框 的 所 有 默认 设 定 。 现 在 ， 重 复 相 同步 又 来 将 Customers 表 
的 CustID 键 映射 到 Orders 表 的 CustID 字 段 。 完 成 之 后 ， 我 们 可 以 看 到 图 21-14 中 的 类 对 话 框 。 


dbo.AutoLot Diagra...qlexpress.AutoLot) XX 





| orders | 
| uD 9 OrderD | 
i Mk | cusip | 
| ca | CariD 
| PetName | | | 
Bee—==—= = 

| 

[customers ss 

CustiD | 

| FrstName | 

| LastName | 

| | 

J 8 





图 21-14 ”关联 的 0rders 、Inventory 和 Customers 表 
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这 样 ，AutoLot 数 据 库 就 完成 了 ! 当然 ,这 和 真实 的 数据 库 差 很 远 ， 不 过 用 于 本 书 余下 部 分 就 够 
了 。 既 然 已 经 有 了 可 以 用 于 测试 的 数据 库 ， 就 让 我 们 深入 了 解 ADO.NET 数 据 提供 程序 工厂 模型 的 细 
节 吧 。 | 


21.7 ADO.NET 数据 提供 程序 工厂 模型 


.NET 数 据 提供 程序 工厂 模式 能 让 我 们 用 多 种 数据 访问 类 型 构建 单个 代码 库 。 而 且 通过 应 用 程序 配 
置 文件 ( 和 全 新 的 <connectionstrings> 片 段 )， 我 们 无 需 重 新 编译 、 重 新 部 署 程序 集 就 能 够 更 改 和 获 
取 提 供 程序 和 连接 字符 串 。 

为 了 理解 怎样 实现 数据 提供 程序 工厂 模式 ， 回 顾 表 21-1 所 说 的 ， 数 据 提供 程序 中 的 类 都 从 相同 的 
基 类 继承 并 且 都 被 定义 在 System.Data.Common 命 名 空间 内 。 

口 DbCommand: 所 有 命令 类 的 抽象 基 类 。 

口 DbConnection: 所 有 连接 类 的 抽象 基 类 。 

口 DbDataAdapter: 所 有 数据 适配器 类 的 抽象 基 类 。 

口 DbDataReader: 所 有 数据 读 取 器 类 的 抽象 基 类 。 

口 DbParameter: 所 有 参数 类 的 抽象 基 类 。 

口 DbTransaction: 所 有 事务 类 的 抽象 基 类 。 

另外 ,每 个 微软 提供 的 数据 提供 程序 都 有 一 个 继承 自 Ssystem.Data.Common DbProviderFactory 的 类 。 
这 个 基 类 定义 了 一 些 方法 来 获取 某 数 据 提供 程序 的 数据 对 象 。 下 面 是 DbProviderFactory 相 关 成 员 的 一 
段 代码 : 


public abstract class DbProviderFactory 


public virtual DbCommand CreateCommand(); 

public virtual DbCommandBuilder CreateCommandBuilder(); 

public virtual DbConnection CreateConnection(); 

public virtual DbConnectionStringBuilder CreateConnectionStringBuilder(); 
public virtual DbDataAdapter CreateDataAdapter(); 

public virtual DbDataSourceEnumerator CreateDataSourceEnumerator(); 
public virtual Dbparameter CreateParameter(); 


System.Data.Common 命 名 空间 下 有 一 个 叫做 DbProviderFactories 的 类 ( 注意 这 里 Factory 是 复数 ) 
帮助 我 们 从 DbProviderFactory 继 承 的 类 获取 数据 提供 程序 。 使 用 静态 方法 GetFactory()， 并 指定 包含 
提供 程序 功能 的 .NET 命 名 空间 的 名 称 , 能 够 获得 代表 该 数据 提供 程序 的 DbProviderFactory 对 象 , 如 下 
所 示 : 

static void Main(string[] args) 


// 获取 SQL 数据 提供 程序 工厂 
DbProviderFactory sqlFactory = 
DbProviderFactories.GetFactory("System.Data.SqlClient"); 


者 可 能 会 想 ， 为 什么 要 把 提供 程序 的 类 型 用 字符 串 硬 编码 而 不 是 直接 从 .config 文 件 读 取 这 些 信 


注 一 : 
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息 呢 (就 像 前 面 的 MyConnectionFactory 示 例 ) ? 你 仅 需 修改 少量 代码 就 能 实现 ,不管 怎么 样 ， 只 要 得 
到 了 某 个 数据 提供 程序 的 DbProviderFactory 以 后 ， 你 就 能 获取 它 相 关 的 一 些 数据 对 象 ( 比如 连接 、 命 
令 、 数 据 读 取 器 等 )。 





说 明 ”实际 上 , 可 以 把 数据 提供 程序 所 在 的 .NET 命 名 空间 的 名 称 作为 参数 传递 给 DbProviderFactories. 
GetFactory()。machine.config 使 用 该 字符 串 值 从 全 局 程序 集 缓存 中 动态 加 载 正确 的 库 。 


21.7.1 完整 的 数据 提供 程序 工厂 的 例子 


作为 完整 的 示例 ， 让 我 们 新 建 一 个 C# 控 制 台 应 ee 
汽车 库存 。 对 于 这 个 初始 的 示例 ,我 们 会 直接 在 DataProviderFactory.exe 中 硬 编码 数据 访问 逻辑 ( 只 是 
确保 现在 做 的 东西 足够 简单 ) 。 然 而 , 在 我 们 开始 深入 介绍 ADO.NET 编 程 模型 之 后 , 要 将 数据 逻辑 隔 
离 到 某 个 .NET 代 码 类 库 中 ， 本 书 余下 部 分 都 将 会 用 到 。 

首先 , 增加 System.Configuration.dll 程 序 集 的 引用 并 且 导 入 System.Configuration 命 名 空间 。 然 后 ， 
将 App.config 文 件 插 入 到 当前 项 目 中 , 并 定义 一 个 空 的 <appSettings> 元 素 。 新 增 一 个 叫 provider 的 键 ， 
映射 到 我 们 希望 获取 的 数据 提供 程序 的 命名 空间 ( System.Data.SqlClient ) 。 同 样 ， 在 SQL Server 
Express 的 本 地 实例 上 定义 一 个 表示 到 AutoLot 数 据 库 的 连接 的 连接 字符 串 : 


<?xml] version="1.0" encoding="utf-8" ?> 
<configuration> 
<appSettings> 


《<1-- 哪个 提供 程序 --> 
<add key="provider" value="System.Data.SqlClient" /> 


<1-- 哪个 连接 字符 囊 --> 
<add key="cnSti" value= "Data Source=(local)\SQOLEXPRESS; 
Initial Catalog=AutoLot;Integrated Security=True"/> 
</appSettings> 
</configuration> 


说 明 ” 稍 后 我 们 会 详细 研究 连接 字符 串 。 然 而 ,要 知道 如 果 我 们 在 Server Explorer 中 选择 AutoLot 数 据 
库 图 标 ， 就 可 以 从 Visual Studio Properties 窗 口 的 Connection String 属 性 中 复制 并 粘贴 正确 的 连 
接 字符 串 。 


现在 你 已 经 建立 了 一 个 正确 的 *.config 文 件 ,可 以 通过 ConfigurationManager.AppSetting 索 引 器 读 
取 provider 和 cnstzr 的 值 。provider 的 值 被 传 到 DbproviderFactories.GetFactory() 方 法 来 获取 某 个 数据 
提供 程序 的 工厂 类 型 ， 同 样 cnstz 的 值 会 被 继承 自 DbConnecion 的 对 象 用 做 Connectionstring 属 性 。 

假设 你 已 经 使 用 了 System.Data 和 System.Data.Common 命 名 空间 ， 然 后 按照 下 面 的 代码 来 修改 Main() 
方法 : 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Data Provider Factories *****\n"); 
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// 从 *.config 文 件 获取 连接 字符 事 和 提供 程序 

string dp = 
ConfigurationManager.AppSettings["provider"]; 

string cnStr = 
ConfigurationManager.AppSettings["cnStr"]; 


// 得 到 工厂 提供 程序 
DbProviderFactory df = DbProviderFactories.GetFactory(dp); 


// 得 到 连接 对 象 


using (DbConnection cn = df.CreateConnection()) 


Console.NriteLine("Your connection object is a: {0}", cn.GetType().Name); 
cn.ConnectionString = cnStr; 
cn.0pen(); 


// 得 到 命令 对 象 

DbCommand cmd = df.CreateCommand(); 

Console.WriteLine("Your command object is a: {0}", cmd.GetType().Name); 
cmd.Connection = cn; 

cmd.CommandText = "Select * From Inventory"; 


// 从 数据 读 取 器 输出 数据 
using (DbDataReader dr = cmd.ExecuteReader()) 


Console.WriteLine("Your data reader object is a: {0}", dr.GetType().Name); 
Console.WritelLine("\n***** Current Inventory *****"); 
while (dr.Read()) 


Console.Writeline("-> Car #{0} is a {1}.", 
dr["CarID"], dr["Make"].ToString()); 


Console.ReadLine(); 


值得 注意 的 是 ， 为 了 更 好 地 了 解 内 幕 ， 我 们 通过 反射 服务 输出 了 基层 连接 、 命 令 和 数据 读 取 器 对 


象 的 全 


名 。 运 行程 序 后 ， 你 能 发 现 AutoLot 数 据 库 的 Inventory 表 中 的 当前 数据 输出 到 了 控制 台 。 





六 阔 闵 冰 炒 Fun with Data Provider Factories 半 冰 冰冰 


Your connection object is a: SqlConnection 
Your command object is a: SqlCommand 
Your data reader object is a: SqlDataReader 


六 站 冰 本 六 Current InventoOry ****+* 


未 
“ 史 
-> 
» 江 
~» 
-» 
人 


Car #32 is a WW. 

Car #83 is a Ford. 
Car #872 is a Saab. 
Car #888 is a Yugo. 
Car #1000 is a BMW. 
Car #1011 is a BMW. 
Car #2911 is a BMW. 





现在 ， 如 果 修 改 *.config 文 件 指定 System.Data.01dDb 作 为 数据 提供 程序 ( 并 且 更 新 连接 字符 串 的 
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Provider 部 分 )， 如 下 所 示 : 


<configuration> 
<appSettings> 
《!-- 哪个 提供 程序 --> 
<add key="provider" value="System.Data.0leDb" /> 


《<1-- 哪个 连接 字符 囊 --> 
<add key="cnStr" value= 
"Provider=SQLOLEDB;Data Source=(local)\SQLEXPRESS; 
Integrated Security=SSPI;Initial Catalog=AutoLot"/> 
</appSettings> 
</configuration> 


这 代表 后 台 使 用 了 System.Data.0leDb 类 型 ， 并 产生 如 下 结果 : 





米 冰冰 炒米 Fun with Data Provider Factories 六 冰冰 冰冰 


Your connection object is a: OleDbConnection 
Your command object is a: OleDbCommand 
Your data reader object is a: OleDbDataReader 


六 * 炒 * 冰 Current InventoOry 六 冰冰 炒米 
-> Car #32 is a VW. 

-> Car #83 is a Ford. 

-> Car #872 is a Saab. 

-> Car #888 is a Yugo. 

-> Car #1000 is a BMW. 

-> Car #1011 is a BMW. 

-> Car #2911 is a BMW. 


sp spate 


当然 ， 看 到 这 里 你 可 能 还 不 是 很 清楚 连接 、 命 令 和 数据 读 取 器 对 象 分 别 起 什么 作用 ， 你 现在 不 需 
要 关注 过 多 的 细节 ( 后面 还 有 很 多 篇 幅 会 介绍 )。 通 过 这 个 例子 ， 你 只 需要 明白 在 ADO.NET 下 ， 以 声 
明 方 式 可 以 构建 能 适应 多 种 数据 提供 程序 的 单个 代码 库 。 


21.7.2 ”数据 提供 程序 工厂 模型 的 潜在 缺陷 


尽管 这 个 模型 很 强 ,但 是 你 要 知道 ， 代 码 库 其 实 只 能 通过 抽象 基 类 的 成 员 来 使 用 所 有 提供 程序 通 
用 的 一 些 类 型 和 方法 。 因 此 在 写 代 码 库 的 时 候 ， 你 会 被 局 限于 System.Data.Common 命 名 空间 下 的 
DbConnection 、DbCommand 等 其 他 类 型 公开 的 成 员 。 

这 样 ， 你 会 发 现 这 种 “ 泛 化 的 ”方式 使 得 我 们 不 能 直接 访问 特定 DBMS 的 漂亮 功能 。 如 果 我 们 必 
须 调用 基础 提供 程序 ( 比如 SqlConnection ) 的 特殊 成 员 ， 那 么 可 以 通过 显 式 强制 类 型 转换 就 能 实现 ， 
例如 : 


using (DbConnection cn = df.CreateConnection()) 








Console.WriteLine("Your connection object is a: {0}", cn.GetType().Name); 
cn.ConnectionString = cnStr; 

cn.0pen(); 

if (cn is SqlConnection) 


// 输出 使 用 的 SQL Server 版 本 


676 第 21 章 ADO.NET 之 一 : 连接 层 
Console.WriteLine(((SqlConnection)cn).ServerVersion); 


然而 ， 这 样 会 使 代码 变 得 不 易 维 护 ( 也 缺乏 灵活 性 ) ， 因 为 我 们 必须 增加 许多 运行 时 检测 。 但 如 
果 你 希望 以 最 灵活 的 方式 构建 数据 访问 库 ， 数 据 提供 程序 工厂 模型 提供 了 一 个 很 好 的 机 制 。 


21.7.3 “connectionStrings> 元 素 


我 们 的 连接 字符 串 数据 现在 在 *.config 文 件 的 <appSsettings> 元 素 中 ， 应 用 程序 配置 文件 定义 了 一 
个 新 的 元 素 ， 叫 做 <connectionSstrings>。 你 能 在 这 个 元 素 内 设置 任意 多 的 名 称 / 值 组 合并 且 能 通过 
ConfigurationManager.ConnectionStrings 索 引 器 以 编程 方式 访问 。 这 种 方式 的 ( 相 比 使 用 
<appSettings> 元 素 和 ConfigurationManager.AppSettings 索 引 器 来 访问 ) 好 处 在 于 它 能 为 你 的 应 用 程序 
以 一 个 统一 的 方式 定义 多 个 连接 字符 串 。 

做 一 个 实验 ， 请 按照 下 面 的 代码 修改 App.config 文 件 (注意 每 一 个 连接 字符 串 使 用 name 和 
connectionString 特 性 而 不 是 key 和 value 特 性 ): 


<configuration> 

<appSettings> 

<1-- 哪个 提供 程序 --> 

<add key="provider" value="System.Data.SqlClient" /> 
</appSettings> 


《1-- 这 里 是 连接 字符 事 --> 
<connectionStrings> 
<add name ="AutoLotSqlProvider" connectionString = 
"Data Source=(local)\SQLEXPRESS; 
Integrated Security=SSPI;Initial Catalog=AutoLot"/> 


<add name ="AutoLotOleDbProvider" connectionString = 
"Provider=SQLOLEDB;Data Source=(local)\SQLEXPRESS; 
Integrated Security=SSPI;Initial Catalog=AutoLot"/> 
</connectionStrings> 
</configuration> 


现在 你 还 需要 修改 Main() 方 法 : 
static void Main(string[] args) 


Console.WritelLine("***** Fun With Data Provider Factories *****\n"); 

string dp = 
ConfigurationManager.AppSettings["provider"]; 

string cnStr = 
ConfigurationManager.ConnectionStrings["AutoLotSqlProvider"].ConnectionString; 


至 此 ,我 们 已 经 有 了 一 个 应 用 程序 可 以 显示 AutoLot 数 据 库 中 Inventory 表 的 结果 。 我 们 看 到 ， 通 
过 把 提供 程序 名 字 和 连接 字符 串 放 到 外 部 *.config 文 件 , 数 据 提供 程序 工厂 模型 可 以 在 背后 动态 加 载 合 
适 的 提供 程序 。 有 了 这 第 一 个 示例 ， 我 们 就 可 以 深入 了 解 ADO.NET 连 接 层 的 更 多 细节 。 
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说 明 现在 你 已 经 理解 ADO.NET 数 据 提 供 程序 工厂 的 作用 ， 本 书 余下 的 例子 都 将 直接 使 用 
System.Data.SqlClient 命 名 空间 中 的 类 型 , 这 样 我 们 能 更 多 关注 手头 讨论 的 东西 。 如果 使 用 的 
是 另外 的 DBMS ( 如 Oracle )， 就 需要 相应 地 修改 代码 库 。 


源 代码 DataProviderFactory 项 目的 源 代码 位 于 Chapter 21 子 目录 下 。 


21.8 ADO.NET 的 连接 层 


前 面 曾 提 到 过 , ADO.NET 的 连接 层 允 许 通 过 数据 提供 程序 的 连接 、 命 令 、 数 据 读 取 器 对 象 与 数据 
库 进行 交互 。 尽 管 在 前 面 的 DataProviderFactory 例 子 里 已 经 用 过 这 些 对 象 ， 我 们 还 是 再 来 看 一 下 整个 
流程 。 当 想 连接 数据 库 并 且 使 用 一 个 数据 读 取 器 对 象 来 读 取 数 据 时 ， 需 要 实现 下 面 的 几 个 步骤 。 

口 创建 、 配 置 、 打 开 连 接 对 象 。 

口 创建 、 配 置 一 个 命令 对 象 ， 通 过 构造 参数 或 Connection 属 性 指定 连接 对 象 。 

口 执行 配置 后 的 命令 对 象 的 ExecuteReader() 方 法 。 

口 使 用 数据 读 取 器 的 Read() 方 法 一 条 一 条 处 理 记录 。 

要 熟练 掌握 这 些 对 象 , 我 们 建立 一 个 新 的 控制 台 应 用 程序 AutoLotDataReader, 并 使 用 System.Data 
和 System.Data.SqlClient 命 名 空间 。 下 面 是 Main() 函 数 的 完整 代码 和 相关 分 析 : 


class Program 
static void Main(string[] args) 


Console.WritelLine("***** Fun with Data Readers *****\n"); 


// 建立 并 打开 一 个 连接 


using(SqlConnection cn = new SqlConnection()) 


cn.ConnectionString = 
@"Data Source=(local)\SQOLEXPRESS; Integrated Security=SSPI;" + 
"Initial Catalog=AutoLot"; 
cn.Open(); 


// 建立 一 个 SQL 命 令 对 象 
string strSQL = "Select * From Inventory"; 
SqlCommand myCommand = new SqlCommand(strSQL, cn); 


// 通过 ExecuteReader() 获 取 一 个 数据 读 取 器 
using(SqlDataReader myDataReader = myCommand.ExecuteReader()) 


// 循环 所 有 的 记录 
while (myDataReader.Read()) 


Console.WritelLine("-> Make: {0}, PetName: {1}, Color: {2}.", 
myDataReader[ "Make"].ToString(), 
myDataReader[ "PetName"] .ToString(), 
myDataReader[ "Color"].ToString()); 
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} 


} 
Console.ReadLine(); 


} 


21.8.1 使 用 连接 对 象 


使 用 数据 提供 程序 需要 做 的 第 一 步 就 是 使 用 连接 对 象 (前 面 说 过 ， 从 DbConnection 继 承 ) 去 和 数 
据 库 建立 一 个 会 话 。NET 连 接 对 象 需要 靠 一 个 符合 一 定格 式 的 连接 字符 串 进行 创建 , 通常 它 包 含 了 几 
对 名 称 / 值 的 信息 并 且 通 过 分 号 分 割 。 这 些 信息 用 来 确定 你 想 要 连接 的 计算 机 名 、 必 要 的 安全 配置 、 机 
器 上 数据 库 的 名 字 和 其 他 一 些 数 据 提供 程序 特有 的 信息 。 

从 之 前 的 代码 中 我 们 可 以 推断 ，Initial Catalog 名 涉及 我 们 需要 建立 会 话 的 数据 库 。Data Source 名 
表示 维护 数据 库 的 机 器 名 。 在 这 里 ，(local) 人 允许 我 们 定义 一 个 标识 来 指示 当前 本 地 机 器 ( 不 管 这 个 机 器 
的 名 字 是 什么 ) ， 而 \SQLEXPRESS 标 识 通知 SQL Server 提 供 程序 : 正在 连接 到 SQL Server Express 默 认 版 本 
的 安装 。 ( 如 果 我 们 在 完整 版 本 的 SQL Server 上 创建 AutoLot， 就 只 需要 写 Data Source=(local)。 ) 

除了 这 些 ， 我 们 还 可 以 提供 许多 表示 安全 资格 的 标识 。 在 这 里 ， 我 们 设置 Integrated Security 为 
SSPI ( 等 价 于 true ) ， 它 使 用 当前 的 Windows 账 户 凭 据 作 为 用 户 身份 验证 。 


说 明 你 可 以 查阅 .NET Framework 4.5 SDK 中 数据 提供 程序 的 连接 对 象 的 ConnectionString 属 性 ， 了 
解 每 一 个 DBMS 的 名 称 / 值 组 合 的 细节 。 


在 传人 了 连接 字符 串 后 ， 就 可 以 调用 0pen() 来 建立 和 DBMS 之 间 的 连接 。 除 了 Connectionstring、 
0pen() 和 Close() 成 员外 , 连接 对 象 还 提供 了 一 些 成 员 让 你 能 进行 一 些 额外 的 配置 ， 比 如 说 超时 设置 和 
事务 信息 。 表 21-5 列 举 了 一 些 (但 不 是 全 部 ) DbConnection 基 类 的 成 员 。 


表 21-5 ”DbConnection 类 型 的 成 员 
成 员 作 用 
BeginTransaction() 用 来 开始 数据 库 事 务 
ChangeDatabase() 为 打开 的 连接 更 改 当前 数据 库 


ConnectionTimeout 这 个 只 读 属 性 返回 建立 连接 时 终止 尝试 并 生成 错误 之 前 所 等 待 的 时 间 (默认 15 秒 ) 如 果 想 修 
改 这 个 值 ， 请 在 连接 字符 串 中 加 入 Connect Timeout 片 段 (比如 Connect Timeout=30) 


Database 获取 连接 对 象 的 数据 库 名 

DataSource 获取 连接 对 象 的 数据 库 服 务 器 名 

GetSchema() 返回 一 个 包含 数据 源 结构 信息 的 DataTable 对 象 

State 这 个 只 读 属性 获取 当前 连接 状态 ， 表 示 为 ConnectionState 枚 举 形式 


我 们 知道 ，DbConnection 类 型 的 这 些 属性 实际 上 是 只 读 的 ， 只 有 我 们 想 在 运行 时 得 到 连接 的 一 些 
特征 时 才 会 去 用 它们 。 如 果 需 要 修改 这 些 默认 设置 的 话 ， 必 须 改变 连接 字符 串 本 身 。 比 如 ， 设 置 连接 
字符 串 把 超时 时 间 从 默认 的 15 秒 改 为 30 秒 : 
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static void Main(string[] args) 
Console.WritelLine("***** Fun with Data Readers *****\n"); 
using(SqlConnection cn = new SqlConnection()) 


cn.ConnectionString = 

@"Data Source=(local)\SQLEXPRESS;" + 

"Integrated Security=SSPI;Initial Catalog=AutoLot;Connect Timeout=30"; 
cn.0pen(); 


// 新 的 辅助 方法 〈( 见 下 面 ) 
ShowConnectionStatus(cn); 
光 
在 前 面 的 代码 中 我 们 注意 到 ， 这 里 把 连接 对 象 当 做 参数 传人 到 了 Program 类 的 一 个 叫做 Show- 
Connectionstatus() 的 新 辅助 方法 中 ， 方 法 实现 如 下 : 


static void ShowConnectionStatus(SqlConnection cn) 


// 显示 当前 连接 对 象 的 各 种 状态 

Console.Writeline("***** Info about your connection *****"); 
Console.WriteLine("Database location: {0}", cn.DataSource); 
Console.WritelLine("Database name: {0}", cn.Database); 
Console.WritelLine("Timeout: {0}", cn.ConnectionTimeout); 
Console.WriteLine("Connection state: {0}\n", cn.State.ToString()); 


} 
虽然 大 多 数 属性 看 字面 都 能 知道 它们 的 作用 ， 但 是 State 属 性 还 是 值得 特别 提 一 下 。 尽 管 它 的 值 
是 ConnectionSstate 这 个 枚 举 定义 的 ， 如 下 所 示 : 


public enum ConnectionState 


Broken, Closed, 
Connecting, Executing, 
Fetching, Open 


但 是 ConnectionState 中 只 有 ConnectionState.0pen 和 Connectionstate.Close 是 有 效 的 ( 枚 举 其 他 


的 成 员 为 将 来 的 使 用 所 保留 )。 还 有 ， 如 果 当 前 的 连接 状态 是 Connectionstate.Close， 再 去 关闭 一 次 
连接 不 会 出 现 什么 问题 。 


21.8.2 ”使 用 ConnectionSstringBuilder 对 象 


以 编程 方式 使 用 连接 字符 串 是 非常 有 用 的 ， 因 为 如 果 经 常用 一 个 文本 字符 串 来 写 连接 字符 串 的 
话 ,不 易于 维护 而 且 容 易 出 问题 ,微软 的 ADO.NET 数 据 提供 程序 现在 提供 了 连接 字符 串 构造 函数 对 象 ， 
通过 它 能 使 用 强 类 型 化 的 属性 来 指定 名 称 / 值 对 。 按 照 下 面 的 例子 修改 当前 的 Main() 方 法 : 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Data Readers *****\n"); 


// 通过 构造 函数 对 象 来 建立 连接 字符 事 
SqlConnectionStringBuilder cnStrBuilder = 
new SqlConnectionStringBuilder(); 


680 第 21 章 ADO.NET 之 一 : 连接 层 


cnStrBuilder.InitialCatalog = "AutoLot"; 
cnStrBuilder.DataSource = @"(local)\SQOLEXPRESS"; 
cnStrBuilder.ConnectTimeout = 30; 
cnStrBuilder.IntegratedSecurity = true; 


using(SqlConnection cn = new SqlConnection()) 


cn.ConnectionString = cnStrBuilder.ConnectionString; 
cn.0pen(); 


ShowConnectionStatus(cn); 


Console.ReadLine(); 


在 这 个 例子 中 ， 首 先 建立 了 SqlConnectionStringBuilders 的 实例 并 且 逐 一 设置 属性 ， 然 后 通过 
Connectionstring 属 性 获取 内 部 的 连接 字符 串 。 其 实 还 可 以 使 用 ConnectionstringBuilder 的 构造 方法 ， 
只 需要 先 建立 一 个 连接 字符 串 然后 把 它 作 为 构造 参数 传人 数据 提供 程序 的 连接 字符 串 构造 函数 即 可 
(如 果 想 从 App.config 文 件 动态 读 取 这 些 值 ， 这 个 功能 就 非常 有 用 )。 一 旦 传人 了 连接 字符 串 ， 你 就 能 
通过 相关 的 属性 来 修改 名 称 / 值 对 ， 例 如 : 

static void Main(string[] args) 


Console.WritelLine("***** Fun with Data Readers *****\n"); 


// 假设 实际 上 是 用 *.config 文 件 获 取 的 cnStT 
string cnStr = @"Data Source=(local)\SOLEXPRESS;" + 
"Integrated Security=SSPI;Initial Catalog=AutoLot"; 


SqlConnectionStringBuilder cnStrBuilder = 
new SqlConnectionStringBuilder(cnStr); 


// 改变 timeout 的 值 
cnStrBuilder.ConnectTimeout = 5; 


21.8.3 ”使 用 命令 对 象 


现在 你 对 连接 对 象 的 作用 更 加 清楚 了 ， 接 下 来 我 们 就 来 讨论 如 何 提交 SQL 查询 到 数据 库 。 
SqlCommand 类 型 ( 继承 自 DbCommand ) 是 SQL 查询 、 表 名 和 存储 过 程 的 一 种 面向 对 象 的 表示 方法 。 可 以 
用 CommandType 属 性 来 指定 命令 的 类 型 ， 它 的 值 由 CommandType 枚 举 定义 ， 如 下 所 示 : 


public enum CommandType 


StoredProcedure， 
TableDirect, 
Text // 默认 值 


当 创 建 一 个 命令 对 象 的 时 候 , 能 通过 传人 构造 参数 或 者 指定 CommandText 属 性 来 建立 SQL 查 询 。 当 
然 ， 还 需要 指定 一 个 将 要 使 用 的 连接 对 象 。 同 样 ， 连 接 对 象 也 可 以 通过 传人 构造 参数 或 者 通过 
Connection 属 性 来 指定 。 看 一 下 下 面 的 代码 段 : 
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// 通过 ctor 参 数 建立 命令 对 象 
string strSQL = "Select * From Inventory"; 
SqlCommand myCommand = new SqlCommand(strSQL, cn); 


// 通过 属性 建立 命令 对 象 

SqlCommand testCommand = new SqlCommand(); 
testCommand.Connection = cn; 

testCommand .CommandText = strSQL; 


直到 这 一 步 , 其 实 你 还 没有 真正 提交 SQL 查询 到 AutoLot 数 据 库 , 而 只 是 建立 了 将 要 使 用 的 命令 对 
象 状 态 。 表 21-6 列 举 了 一 些 DbCommand 类 型 的 其 他 成 员 。 


表 21-6 ”DbCommand 类 型 的 成 员 


成 员 作 用 

CommandTimeout 获取 或 设置 在 终止 执行 命令 的 尝试 并 生成 错误 之 前 的 等 待 时 间 ， 默认 30 秒 

Connection 获取 或 设置 此 DbCommand 实 例 使 用 的 DbConnection 

Parameters 获取 DbParameter 对 象 的 集合 ， 用 于 参数 化 查询 

Cancel() 取消 执行 命令 

ExecuteReader() 执行 SQL 查询 并 返回 一 个 数据 提供 程序 的 DbDataReader 对 象 , 以 只 读 向 前 的 方式 访问 查 
询 结果 

ExecuteNonQuery() 提交 SQL 语句 到 数据 库 ， 不 会 有 返回 值 ( 如 插入 、 更 新 、 删 除 或 创建 表 ) 

ExecuteScalar() 一 个 轻 量 级 版 本 的 ExecuteReader()， 用 于 返回 一 个 值 的 查询 ( 比如 得 到 记录 总 数 ) 

Prepare() 在 数据 源 上 创建 该 命令 的 准备 好 ( 或 已 编译 ) 的 版 本 ， 我 们 知道 这 样 一 个 查询 的 执行 


速度 会 稍微 快 些 〈 特别 是 在 你 想 多 次 执行 相同 查询 的 情况 下 ) 
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建立 了 活动 的 连接 和 SQL 命令 以 后 ， 下 一 步 就 是 向 数据 源 提交 查询 。 你 可 能 也 猜 到 了 这 有 很 多 方 
法 能 实现 。 但 DbDataReader 类 型 ( 实现 IDataReader 接 口 ) 是 从 数据 源 获取 信息 最 简单 也 最 快速 的 方法 。 
前 面 提 到 过 ， 数 据 读 取 器 是 只 读 向 前 的 数据 流 ， 并 且 一 次 返回 一 条 记录 。 因 此 ， 只 有 当 你 向 数据 源 提 
交 Select 查 询 语句 的 时 候 ， 数 据 读 取 器 才 有 用 。 

当 你 需要 快速 获取 大 批 数据 并 且 不 需要 在 内 存 中 存储 它们 的 时 候 ， 数 据 读 取 器 就 非常 有 用 了 。 比 
如 ， 你 想 从 表 中 取出 20 000 条 记录 保存 到 文本 文件 ， 先 用 Dataset 保 存 这 些 数 据 到 内 存 中 就 非常 不 值得 
了 (因为 Dataset 同 时 在 内 存 中 保存 整个 结果 )。 

一 个 更 好 的 方式 是 用 数据 读 取 器 快速 遍历 每 条 记录 。 需 要 知道 的 是 ， 数 据 读 取 器 对 象 ( 不 像 数 据 
适配器 对 象 ， 后 面 会 讨论 它 ) 会 保持 打开 的 连接 ， 除 非 显 式 地 关闭 会 话 。 

通过 执行 命令 对 象 的 ExecuteReader() 方 法 来 获得 数据 读 取 器 对 象 。 数 据 读 取 器 ( data reader ) 表 
示 从 数据 库 中 读 取 的 当前 记录 。 它 包含 一 个 索引 器 方法 ( 如 C# 中 的 [] 语 法 ) ， 可 以 通过 名 称 或 从 0 开 
始 的 整数 来 访问 当前 记录 中 的 列 。 

下 面 的 例子 表明 ， 可 以 通过 Read() 方 法 的 返回 值 来 确定 什么 时 候 到 达 了 最 后 一 条 记录 (返回 
false )。 对 于 每 一 条 记录 ， 我 们 使 用 索引 器 来 输出 每 一 个 汽车 的 商标 、 昵 称 、 颜 色 的 值 。 注 意 ， 当 结 
束 操作 记录 后 请 尽快 执行 数据 读 取 器 的 Close() 方 法 ， 以 释放 连接 对 象 
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static void Main(string[] args) 


{ 


通过 ExecuteReader() 得 到 一 个 数据 读 取 器 对 象 
using(SqlDataReader myDataReader = myCommand.ExecuteReader()) 


// 循环 所 有 记录 
while (myDataReader.Read()) 
{ 


Console.WritelLine("-> Make: {0}, PetName: {1}, Color: {2}.", 
myDataReader[ "Make"].ToString(), 
myDataReader[ "PetName"].ToString(), 
myDataReader[ "Color"].ToString()); 


} 


Console.ReadLine(); 


在 前 面 的 代码 段 中 ， 数 据 读 取 器 对 象 的 索引 器 已 经 重 载 ， 可 以 使 用 string ( 表示 列 名 ) 或 者 int 
(表示 列 的 原始 位 置 ) 两 种 方式 来 取 值 。 因 此 ， 可 以 像 下 面 一 样 改写 (避免 了 硬 编 码 字符 串 名 ) 前 面 
的 代码 ( 注意 FieldCount 属 性 的 使 用 ): 

while (myDataReader.Read()) 


Console. WriteLine("***** Record 汪 本 本 本 ”) > 
for (int i = 0; i < myDataReader.FieldCount; i++) 


Console.WriteLine("{0} = {1} ", 
myDataReader .GetName(i), 
myDataReader.GetValue(i).ToString()); 


Console.WritelLine(); 


编译 运行 这 个 项 目 后 ， 我 们 会 看 到 程序 列 出 了 AutoLot 数 据 库 Inventory 表 中 所 有 汽车 的 记录 。 下 
面 的 输出 结果 显示 来 自我 的 AutoLot 数 据 库 的 几 条 记录 : 





沙沙 沙 炒 米 Fun with Data Readers ***** 


***** Info about your connection ***** 
Database location: (local)\SQLEXPRESS 
Database name: AutoLot 

Timeout: 30 

Connection state: Open 


六 六 六 玉米 ReCOrd 六 六 六 冰冰 


CarID = 83 
Make = Ford 
Color = Rust 


PetName = Rusty 


六 六 六 冰冰 “ReCOT(d 六 六 冰冰 环 


CarID = 107 
Make = Ford 
Color = Red 


PetName = Snake 


OO 
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使 用 数据 读 取 器 获取 多 个 结果 集 


我 们 能 使 用 数据 读 取 器 对 象 从 一 个 命令 对 象 获 取 多 个 结果 集 。 比 如 说 ， 你 要 获取 Inventory 表 和 
Customers 表 的 所 有 行 ， 要 写 两 个 SQL Select 语 句 并 且 用 分 号 分 制 ， 如 下 所 示 : 
string str90L = “Select * From Inventory;Select * from Customers"; 
获得 了 数据 读 取 咒 对 象 后 ， 就 能 通过 NextResult() 方 法 循环 所 有 的 结果 集 。 需 要 知道 的 是 ， 它 会 
总 是 自动 返回 第 一 个 结果 集 。 因 此 , 当 需 要 遍历 每 一 个 表 的 行 的 时 候 , 可 以 像 下 面 一 样 建立 循环 语句 : 
do 
(myDataReader.Read()) 


Console.WriteLine("***** ReCOTd 六 冰冰 冰冰"”) ; 
for (int i = 0; i «< myDataReader.FieldCount; i++) 


Console.WriteLine("{0} = {1}", 
myDataReader .GetName(i), 
myDataReader.GetValue(i).ToString()); 


Console.WritelLine(); 


} while (myDataReader.NextResult()); 

至 此 ， 读 者 应 该 对 数据 读 取 器 对 象 访问 数据 表 的 功能 更 为 清楚 了 。 要 始终 记 住 ， 数 据 读 取 器 只 能 
处 理 SQL 的 Select 语 句 , 不 能 通过 Insert 、Update 或 Delete 请 求 来 修改 既 有 数据 库 表 。 要 理解 如 何 修改 
既 有 数据 库 ， 需 要 对 命令 对 象 进行 进一步 研究 。 


源 代码 ”AutoLotDataReader 项 目的 源 代码 位 于 Chapter 21 子 目录 下 。 
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通过 前 面 的 章节 我 们 看 到 了 ，ExecuteReader() 方 法 得 到 的 数据 读 取 器 对 象 允许 执行 SQL select 语句 
并 且 以 只 读 向 前 的 形式 获取 信息 。 然 而 ， 当 想 向 某 表 提 交 SQL 语 句 来 实现 修改 的 时 候 ( 或 其 他 非 查询 
的 SQL 语句 ， 如 创建 表 或 授权 )， 就 要 用 到 命令 对 象 的 ExecuteNonQuery() 方 法 了 。 这 个 方法 能 根据 命 
令 文 本 的 格式 执行 相应 的 插入 、 修 改 和 删除 操作 。 














说 明 严格 来 说 ，“ 非 查询 ”是 指 没 有 返回 结果 集 的 SQL 语句 。 因 此 ，S$elect 语 句 是 查询 ， 而 Insert、 
Update 和 Delete 语 句 则 不 是 。 因 此 ，ExecuteNonQuery() 返 回 的 int 值 代表 被 影响 的 行 数 ， 而 不 
是 一 组 新 记录 。 
为 了 阐明 如 何 只 通过 调用 ExecuteNonQuery() 来 修改 轻 有 数据 库 , 下 一 个 目标 就 是 构建 一 个 自 定 义 
的 数据 访问 类 库 来 封装 对 AutoLot 数 据 库 的 操作 过 程 。 在 生产 级 别 的 环境 中 ，ADO.NET 逻 辑 总 是 应 该 
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隔离 到 .NET 的 一 个 *.dll 程 序 集中 ， 原 因 很 简单 : 代码 重用 ! 本 章 第 一 个 示例 没有 这 么 做 ， 是 为 了 让 我 
们 手头 的 事情 变 得 简单 。 然 而 ， 我 们 可 以 想象 ， 对 于 需要 和 AutoLot 数 据 库 交互 的 应 用 程序 来 说 ， 需 
要 编写 相同 的 连接 逻辑 、 相 同 的 读 逻 辑 以 及 相同 的 命令 逻辑 ， 这 会 浪费 很 多 时 间 。 

通过 把 数据 访问 逻辑 隔离 到 .NET 代 码 库 ， 多 个 使 用 任何 前 端 ( 基于 控制 台 的 、 基 于 桌面 的 或 者 基 
于 Web 的 ， 等 等 ) 的 应 用 程序 都 可 以 以 语言 独立 的 方式 直接 引用 类 库 。 因 此 ， 如 果 使 用 C# 编 写 数 据 类 
库 ， 其 他 开发 者 就 可 以 使 用 他 们 喜欢 的 .NET 语 言 来 构建 UI。 

在 本 章 中 ， 数 据 类 库 AutoLotDAL.dll 会 包含 一 个 命名 空间 AutoLotConnectedLayer ， 它 使 用 
ADO.NET 的 连接 类 型 和 AutoLot 进 行 交 互 。 在 下 一 章 中 ,我 们 会 新 增 一 个 命名 空间 ( AutoLot 
DisconnectionLayer ) 到 相同 的 *.dll 中 ， 其 中 包含 的 类 型 使 用 断 开 连 接 层 和 AutoLot 进 行 通信 。 在 本 书 
余下 的 内 容 中 ,将 有 很 多 应 用 程序 会 用 到 这 个 类 库 。 

首先 ， 新 建 一 个 叫 AutoLotDAL ( AutoLot Data Access Layer 的 缩写 ) 的 C# 类 库 项 目 ， 并 且 重 命名 
初始 C# 代 码 文件 为 AutoLotConnDAL.cs。 然 后 ， 重 命名 我 们 的 命名 空间 域 为 AutoLotConnectedLayer， 
并 且 改 变 初始 类 的 名 字 为 InventoryDAL， 因 为 这 个 类 会 定义 各 种 成 员 ， 与 AutoLot 数 据 库 的 Inventoty 
表 进 行 交互 。 最 后 ， 导 入 如 下 .NET 命 名 空间 : 


using System; 


// 我 们 会 使 用 SQL server 提 供 程序 ， 然 而 ， 使 用 ADO.NET 工 厂 模式 来 获得 更 好 的 灵活 性 也 是 可 以 的 
using System.Data; 
using System.Data.SqlClient; 


namespace AutoLotConnectedLayer 
public class InventoryDAL 


} 
} 


说 明 从 第 13 章 中 知道 ， 如 果 对 象 使 用 管理 底层 资源 ( 如 数据 库 连 接 ) 的 类 型 ， 实 现 IDisposable 以 
及 编写 正确 的 终结 器 就 是 最 佳 实践 。 在 生产 环境 中 ,诸如 InventoryDAL 的 类 也 应 该 一 样 ， 但 我 
们 重点 关注 的 是 ADO.NET， 所 以 我 们 没有 这 么 做 。 


21.10.1 增加 连接 逻辑 


我 们 要 做 的 第 一 件 事情 就 是 定义 一 些 方法 允许 调用 者 使 用 有 效 的 连接 字符 串 连 接 到 某 个 数据 源 
或 从 数据 源 断 开 。 因 为 AutoLotDAL.dll 程 序 集 会 硬 编码 使 用 System.Data.5q1Client 类 型 ， 所 以 要 定义 
一 个 在 创建 InventoryDAL 对 象 时 分 配 的 SqlConnection 私 有 变量 。 同 样 ， 要 定义 0penConnection() 方 法 
和 CloseConnection() 方 法 来 和 这 个 成 员 变 量 进行 交互 ， 如 下 所 示 : 


public class InventoryDAL 
{ 
// 这 个 成 员 会 被 所 有 方法 使 用 


private SqlConnection sqlCn = null; 
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public void OpenConnection(string connectionString) 


sqlCn = new SqlConnection(); 
sqlCn.ConnectionString = connectionString; 
sqlCn.0pen(); 


public void CloseConnection() 
sqlCn.Close(); 


} 

简单 起 见 ，InventoryDAL 类 型 不 会 检测 可 能 的 异常 ， 也 不 会 在 各 种 情况 下 抛 出 自 定义 异常 ( 比如 
不 正确 的 连接 字符 串 ) 。 如 果 要 构建 一 个 工业 标准 的 数据 访问 库 ， 最 好 为 各 种 运行 时 异常 情况 使 用 结 
构 化 异常 处 理 技 术 。 


21.10.2 ”增加 插入 逻辑 


增加 新 记录 到 Inventory 表 就 像 格 式 化 SQL Insert 语 句 (根据 用 户 输入 ) 和 使 用 命令 对 象 调用 
ExecuteNonQuery() 这 么 简单 。 例 如 ， 增 加 一 个 公共 方法 InsertAuto() 到 InventoryDAL 类 型 中 ， 这 个 方 
法 接受 4 个 参数 , 它们 分 别 对 应 Inventory 表 的 4 个 列 ( CarID、Color、Make 和 PetName ) 。 使 用 这 些 参 数 ， 
格式 化 一 个 字符 串 类 型 来 插入 新 记录 。 最 后 ， 使 用 SqlConnection 对 象 ， 执 行 SQL 语句 : 
public void InsertAuto(int id, string color, string make, string petName) 
// 格式 化 并 且 执 行 SQL 语句 
string sql = string.Format("Insert Into Inventory" + 


"(CarID, Make, Color, PetName) Values" + 
"('{0}', '{1}', '{2}', '{3}')", id, make, color, petName); 


// 使 用 我 们 的 连接 来 执行 
using(SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 


cmd.ExecuteNonQuery(); 
3 
} 
这 个 方法 在 语法 上 没有 问题 ， 但 你 可 以 提供 一 个 重 载 版 本 ， 人 允许 调用 者 传递 一 个 表示 行 数据 的 强 
类 型 类 。 定 义 如 下 所 示 的 NewCar 类 ， 表 示 Inventory 表 的 新 行 : 


public class NewCar 


public int CarID { get; set; } 

public string Color { get; set; } 

public string Make { get; set; } 

public string PetName { get; set; } 
} 


现在 ， 在 InventoryDAL 类 中 添加 下 面 这 个 版 本 的 InsertAuto(): 


public void InsertAuto(NewCar car) 


{ 
// 格式 化 并 且 执 行 SQL 语 向 
string sql = string.Format("Insert Into Inventory" + 
"(CarID, Make, Color, PetName) Values" + 
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"('{0}', '{1}', '{2}', '{3}')", car.CarID, car.Make, car.Color, car.PetName); 


// 使 用 我 们 的 连接 来 执行 
using (SqlCommand cmd = new SqlCommand(sql，this.sqlCn)) 


y cmd.ExecuteNonQuery(); 
} 
定义 表示 关系 数据 库 中 记录 的 类 , 是 构建 数据 访问 库 的 常见 方法 。 事实 上 , 你 将 在 第 23 章 中 看 到 ， 
ADO.NET Entity Framework 自 动 生成 强 类 型 的 类 , 来 与 数据 库 中 的 数据 进行 交互 。 而 ADO.NET 的 非 连 
接 层 ( 见 第 22 章 ) 生成 强 类 型 的 DataSet 对 象 ， 表 示 关 系 型 数据 库 某 个 表 中 的 数据 。 


说 明 你 可 能 知道 ， 使 用 字符 串 拼接 构建 SQL 语句 可 能 会 有 安全 风险 ( 比如 SQL 注入 攻击 ) 。 推 荐 使 
用 参数 化 查询 来 构建 命令 文本 ， 稍 后 我 们 会 探讨 。 


21.10.3 ”增加 删除 逻辑 


删除 既 有 记录 和 插入 新 记录 一 样 简单 。 和 InsertAuto() 的 代码 清单 不 同 ， 我 会 演示 如 何 使 用 重要 
的 try/catch 块 域 来 处 理 可 能 试图 删除 一 辆 当前 已 被 Customers 表 中 的 一 位 顾客 下 了 订单 的 汽车 。 为 
InventoryDAL 类 类 型 增加 如 下 的 方法 : 
public void DeleteCar(int id) 
于 了 天 询 六 罗 潜 未 六 并 关 衣 了 
string sql = string.Format("Delete from Inventory where CarID = '{0}'", 


id); 
using(SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 
1 


try 
cmd.ExecuteNonQuery(); 

} 

catch(SqlException ex) 

{ 


Exception error = new Exception("Sorry! That car is on order!", ex); 
throw error; 
} 
} 
} 


21.10.4 ”增加 更 新 逻辑 


谈 到 Inventory 表 中 的 既 有 记录 ， 第 一 个 问题 就 是 我 们 究 竞 希望 调用 者 改变 什么 数据 ?汽车 的 颜 
色 ? 昵称 还 是 制造 商 ? 或 者 所 有 ? 当然 ,一 个 让 调用 者 充分 灵活 的 方式 就 是 只 定义 一 个 方法 ,接受 表 
示 任 何 SQL 语 句 的 string 类 型 ， 但 是 这 太 冒 险 了 。 

理想 情况 下 ， 我 们 可 能 会 设置 一 组 方法 ， 人 允许 调用 者 以 各 种 方式 来 更 新 记录 。 然 而 ， 为 了 做 一 个 
简单 的 数据 访问 库 ， 我 们 会 定义 一 个 方法 ， 人 允许 调用 者 更 新 某 辆 汽车 的 昵称 ， 如 下 所 示 
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public void UpdateCarpPetName(int id, string newPetName) 


// 获取 要 修改 的 汽车 的 ID 以 及 新 的 昵称 
string sql = string.Format("Update Inventory Set PetName = '{0}' Where CarID = '{1}'", 
newPetName, id); 


using(SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 
cmd.ExecuteNonQuery(); 


} 


21.10.5 ”增加 选择 逻辑 


下 一 个 要 增加 的 是 选择 方法 。 在 本 章 之 前 我 们 看 到 ， 一 个 数据 提供 程序 的 数据 读 取 器 对 象 可 以 使 
用 只 能 向 前 读 的 服务 器 端 游 标 来 选取 记录 。 调 用 Read() 方 法 后 ， 我 们 就 可 以 以 统一 的 方式 处 理 每 一 个 
记录 。 这 没什么 问题 ， 但 是 我 们 需要 处 理 如 何 将 这 些 记录 返回 给 应 用 程序 调用 层 这 个 问题 。 

一 个 方法 就 是 用 从 Read() 方 法 获取 的 数据 填充 多 维 数 组 (或 诸如 泛 型 List<NewCar> 的 此 类 对 象 ) 
并 返回 。 另 外 一 种 方法 ( 当前 示例 会 采用 ) 就 是 从 Inventory 表 获取 数据 : 

ee List<NewCar> GetAllInventoryAsList() 


// 这 将 保存 记录 
List<NewCar> inv = new List<NewCar>(); 


// 准备 命令 对 象 
string sql = "Select * From Inventory"; 
using (SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 


SqlDataReader dr = cmd.ExecuteReader(); 
while (dr.Read()) 


inv.Add(new NewCar 


CarID = (int)dr["CarID"], 

Color = (string)dr["Color"], 
Make = (string)dr["Make"], 
PetName = (string)dr["PetName"] 
)); 


} 
dr.Close(); 


return inv; 


还 有 另 一 种 返回 System.Data.DataTable 对 象 的 方法 , 它 实际 上 是 ADO.NET 非 连接 层 的 一 部 分 。 我 
们 将 在 下 一 章 中 全 面 介绍 非 连接 层 。 而 现在 , 你 只 需要 理解 DataTable 是 一 个 表示 表格 式 数据 ( 如 数据 
表格 中 的 网 格 ) 的 类 类 型 。 

DataTable 类 表示 行 和 列 的 数据 集合 。 虽 然 这 些 集合 可 以 以 编程 方式 进行 填充 ， 但 DataTable 类 型 
还 提供 了 一 个 Load() 方 法 , 它 会 使 用 数据 读 取 器 对 象 自动 填充 这 些 集合 。 考 虑 下 面 的 方法 ,将 Inventory 
中 的 数据 以 DataTable 的 形式 返回 : 

0 DataTable GetAllInventoryAsDataTable() 
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// 它 会 保存 记录 
DataTable inv = new DataTable(); 


// 准备 命令 对 象 
string sql = "Select * From Inventory"; 
using(SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 


SqlDataReader dr = cmd.ExecuteReader(); 
// 用 读 取 器 的 数据 填充 DataTable 并 且 清 理 
inv.Load(dr); 

dr.Close(); 


return inv; 


21.10.6 ”使 用 参数 化 的 命令 对 象 


现在 InventoryDAL 类 型 的 插入 、 更 新 和 删除 逻辑 的 每 一 个 SQL 查询 都 是 用 字符 串 字 面 量 硬 编码 的 。 
读者 可 能 知道 ， 参 数 化 查询 能 像 对 象 那样 处 理 SQL 参 数 ， 而 不 是 像 一 堆 文 本 一 样 。 而 且 ， 参 数 化 查询 
执行 起 来 比 纯 文本 的 SQL 语 句 快 多 了 ， 它 只 需要 解析 一 次 ( 而 不 是 像 SQL 语 句 那 样 每 次 被 分 配 到 
CommandText 属 性 都 要 解析 )。 同 样 ， 参 数 化 查询 也 能 消除 SQL 注 入 攻击 ( 非常 著名 的 数据 访问 安全 问 
题 ) 的 隐患 。 

为 支持 参数 化 查询 , ADO.NET 命 令 对 象 使 用 一 个 集合 来 保存 参数 对 象 。 这 个 集合 默认 是 空 的 , 可 
以 添加 任意 多 的 参数 对 象 并 映射 到 SQL 语句 中 的 占 位 符 参 数 。 如 果 需 要 把 SQL 查询 中 的 参数 和 命令 对 
象 参数 集合 中 某 一 个 成 员 关 联 的 话 ， 只 需要 在 SQL 文本 参数 前 面 加 @ 符 号 ( 微软 SQL Server 是 这 样 的 ， 
不 是 所 有 的 DBMS 都 支持 @ 符 号 )。 

使 用 DbParameter 类 型 指定 参数 

在 建立 参数 化 查询 以 前 ， 先 来 看 一 下 DbParameter 类 型 ( 提供 程序 参数 对 象 的 基 类 )。 这 个 类 有 许 
多 属性 让 你 来 配置 参数 的 名 字 、 大 小 、 类 型 和 其 他 一 些 诸如 参数 传递 方向 等 的 特性 。 表 21-7 列 举 了 
DbParameter 类 型 的 一 些 主要 属性 。 


表 21-7 ”DbParameter 类 型 的 主要 成 员 


属 性 作 用 
DbType 从 数据 源 获 取 或 设置 原始 数据 类 型 ， 以 CLR 数 据 类 型 呈现 
Direction 获取 或 设置 一 个 值 ， 该 值 指示 参数 是 只 可 输入 、 只 可 输出 、 双 向 还 是 返回 值 参 数 
IsNullable 获取 或 设置 一 个 值 ， 该 值 指 示 参 数 是 否 接受 空 值 
ParameterName 获取 或 设置 DbParameter 的 名 称 
Size 获取 或 设置 列 中 数据 的 最 大 尺寸 ( 只 对 文本 数据 有 用 ) 
Value 获取 或 设置 该 参数 的 值 





为 了 演示 如 何 填 充 与 DBParameter 兼 容 的 对 象 的 命令 对 象 集合 ， 让 我 们 重新 修改 前 面 InsertAuto() 
方法 来 使 用 参数 ( 也 可 以 对 其 余 的 SQL 方法 做 类 似 的 修改 ， 但 在 本 例 中 没 必要 这 样 做 ): 
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public void InsertAuto(int id, string color, string make, string petName) 


{ 
// 注意 SQL 查询 中 的 “ 占 位 符 ” 
string sql = string.Format("Insert Into Inventory" + 
"(CarID, Make, Color, PetName) Values" + 
"(@CarID, @Make, @Color, @PetName)"); 


// 这 个 命令 有 内 部 参数 
using(SqlCommand cmd = new SqlCommand(sql, this.sqlCn)) 


' 
// 填充 参数 集合 
SqlParameter param = new SqlParameter(); 
param.ParameterName = "@CarID"; 
param.Value = id; 
param.SqlDbType = SqlDbType.Int; 
cmd.Parameters .Add(param); 


param = new SqlParameter(); 
param.ParameterName = "@Make"; 
param.Value = make; 
param.SqlDbType = SqlDbType.Char; 
param.Size = 10; 

cmd.Parameters .Add(param); 


param = new SqlParameter(); 
param.ParameterName = "@Color"; 
param.Value = color; 
param.SqlDbType = SqlDbType.Char; 
param.Size = 10; 

cmd.Parameters .Add(param); 


param = new SqlParameter(); 
param.ParameterName = "@PetName"; 
param.Value = petName; 
param.SqlDbType = SqlDbType.Char; 
param.Size = 10; 
cmd.Parameters.Add(param); 


cmd.ExecuteNonQuery(); 
} 
} 


同样 ， 注 意 SQL 查 询 包含 4 个 骨 入 的 占 位 符 ， 每 一 个 都 以 @ 标 识 为 前 级 。 使 用 SqlParameter 类 型 ， 
我 们 就 可 以 使 用 ParameterName 属 性 以 强 类 型 格式 来 映射 每 一 个 占 位 符 并 指定 各 种 细节 ( 值 、 数 据 类 型 
和 大 小 等 )。 参 数 对 象 都 准备 好 之 后 ， 就 可 以 通过 调用 Add() 方 法 加 到 命令 对 象 的 集合 中 。 


说 明 在 这 里 ， 我 使 用 了 各 种 属性 来 创建 参数 对 象 。 但 要 知道 ， 这 个 参数 对 象 支持 许多 重 载 构造 函 
数 ， 允 许 我 们 设置 各 种 属性 的 值 ( 这 样 能 产生 更 简洁 的 代码 ) 。 还 要 知道 ，Visual Studio 提 供 
了 许多 图 形 设计 器 , 它们 可 以 根据 需要 生成 很 多 无 技术 含量 的 参数 相关 的 代码 ( 参见 第 22 章 )。 


虽然 构建 参数 化 查询 总 是 需要 很 多 代码 ， 但 是 我 们 可 以 更 方便 地 以 编程 方式 调试 SQL 语 句 ， 并且 
性 能 更 好 。 虽 然 我 们 完全 可 以 在 调用 SQL 查询 时 使 用 这 项 技术 ， 但 是 参数 化 查询 在 我 们 希望 调用 存储 
过 程 时 更 有 用 。 
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21.10.7 执行 存储 过 程 


存储 过 程 是 存储 在 数据 库 内 的 一 段 已 命名 的 SQL 代码 ， 你 可 以 构造 存储 过 程 ， 返 回 一 组 行 或 标量 
数据 类 型 ， 或 进行 其 他 有 意义 的 处 理 ( 如 插 和 人 入、 更新、 删除 ) ， 也 可 以 接受 一 些 可 选 参数 。 其 实 它 就 
像 是 一 个 存储 在 数据 库 内 的 功能 模块 ， 和 那些 二 进 制 数据 对 象 有 明显 区 别 。AutoLot 数 据 库 定义 了 一 
个 存储 过 程 GetPetname， 按 如 下 方式 对 它 进行 格式 化 : 


GetPetName 

@carID int, 

@petName char(10) output 
AS 


SELECT @petName = PetName from Inventory where CarID = @carID 
下 面 是 InventoryDAL 类 型 的 最 后 一 个 方法 ， 它 调用 了 GetPetname 存 储 过 程 : 


public string LookUpPetName(int carID) 
{ 
string carPetName = string.Empty; 


// 设 定 存储 过 程 名 
using (SqlCommand cmd = new SqlCommand("GetPetName", this.sqlCn)) 
{ 


cmd.CommandType = CommandType.StoredProcedure; 


// 输入 参数 

SqlParameter param = new SqlParameter(); 
param.ParameterName = "@carID"; 
param.SqlDbType = SqlDbType.Int; 
param.Value = carID; 


// 默认 的 方向 即 为 Input， 但 为 了 更 清楚 
param.Direction = ParameterDirection.Input; 
cmd.Parameters .Add(param); 


// 输出 参数 

param = new SqlParameter(); 
param.ParameterName = "@petName"; 
param.SqlDbType = SqlDbType.Char; 

param.Size = 10; 

param.Direction = ParameterDirection.Output; 
cmd.Parameters.Add(param); 


// 执行 存储 过 程 


cmd.ExecuteNonQuery(); 


// 返回 输出 参数 
CarpPetName = (string)cmd.Parameters["@petName"] .Value; 


return carPetName; 


调用 存储 过 程 的 一 个 重要 方面 就 是 命令 对 象 表示 SQL 语句 ( 默认 ) 或 者 存储 过 程 名 称 。 如 果 希 望 
通知 命令 对 象 调用 一 个 存储 过 程 , 我 们 就 传人 过 程 名 称 ( 作为 构造 函数 实 参 或 通过 CommandText 属 性 ) ， 
并 且 必 须 设 置 CommandType 属 性 为 值 CommandType.StoredProcedure ( 如 果 不 这 样 做 ,我 们 就 会 收 到 一 个 
运行 时 异常 ， 因 为 命令 对 象 在 默认 情况 下 接受 SQL 语句 ) : 
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SqlCommand cmd = new SqlCommand("GetPetName"，this.sqlCn); 
cmd.CommandType = CommandType.StoredProcedure; 


接着 要 注意 , 参数 对 象 的 Direction 属 性 可 以 为 每 一 个 传人 存储 过 程 的 参数 指定 传递 方向 ( 如 输入 
参数 、 输 出 参数 、in / out 参 数 或 返回 值 ) 。 像 以 前 那样 ， 把 每 一 个 参数 对 象 加 入 命令 对 象 的 参数 集 
合 中 : 


// 输入 参数 

SqlParameter param = new SqlParameter(); 
param.ParameterName = "@carID"; 
param.SqlDbType = SqlDbType.Int; 
param.Value = carID; 

param.Direction = ParameterDirection.Input; 
cmd.Parameters .Add(param); 


最 后 , 通过 调用 ExecuteNonQuery() 完 成 存储 过 程 之 后 ， 可 以 通过 调查 命令 对 象 的 参数 集合 并 且 做 
相应 的 强制 类 型 转换 来 获取 输出 参数 的 值 。 


// 返回 输出 参数 
carPetName = (string)cmd.Parameters["@petName"] .Value; 


至 此 ，AutoLotDAL.dll 数 据 访问 类 库 的 首次 迭代 完成 了 。 使 用 这 个 程序 集 ， 我们 可 以 构建 任何 类 
型 的 前 端 (基于 控制 台 、 桌 面 GUI 或 者 基于 HTML 的 Web 应 用 程序 ) 来 显示 和 编辑 数据 。 由 于 还 没有 
研究 如 何 构建 GUI， 我 们 会 从 一 个 新 的 控制 台 应 用 程序 来 测试 我 们 的 类 库 。 


源 代 码 ”AutoLotDAL 项 目的 源 代 码 位 于 Chapter 21 子 目录 下 。 
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新 建 一 个 控制 台 应 用 程序 AutoLotCUIclient。 在 创建 了 新 的 项 目 之 后 ,请 确保 添加 AutoLotDAL.dll 
程序 集 和 System.Configuration.dll 的 引用 ， 并 且 添 加 如 下 using 语 句 到 C# 代 码 文件 中 : 
using AutoLotConnectedLayer; 


using System.Configuration; 
using System.Data; 


接着 ,插入 一 个 新 的 App.config 文 件 到 项 目 中 ， 它 包含 一 个 用 于 连接 到 AutoLot 数 据 库 实例 的 
<connectionString> 元 素 ， 例 如 : 


<configuration> 
<connectionStrings> 
<add name ="AutoLotSqlProvider" connectionString = 
"Data Source=(local)\SQOLEXPRESS; 
Integrated Security=SSPI;Initial Catalog=AutoLot"/> 
</connectionStrings> 
</configuration> 


21.11.1 实现 Main() 方 法 


Main() 方 法 负责 响应 用 户 的 一 系列 行为 ， 并 且 通 过 switch 语 名 执行 请 求 。 这 个 程序 允许 用 户 输入 
如 下 命令 。 
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口 I: 插入 新 的 记录 到 Inventory 表 。 

口 U: 更 新 Inventory 表 的 既 有 记录 。 

口 D: 从 Inventory 表 中 删除 既 有 记录 。 

口 L: 使 用 数据 读 取 器 显示 当前 库存 。 

口 S: 为 用 户 显示 这 些 选 项 。 

口 P: 根据 汽车 ID 查询 昵称 。 

口 0: 退出 程序 。 

每 一 个 可 能 的 选项 都 由 Program 类 中 对 应 的 唯一 一 个 静态 方法 处 理 。 下 面 是 Main() 方 法 的 完整 实 
现 . 注 意 , 每 一 个 从 do/while 循 环 中 调用 的 方法 (除了 ShowInstruction() 方 法 之 外 ) 都 接受 InventoryDAL 
对 象 作 为 唯一 参数 : 


static void Main(string[] args) 


{ 


Console.WritelLine("***** The AutoLot Console UI *****\n"); 


// 从 App.config 获 取 连 接 字 符 事 

string cnStr = 
ConfigurationManager.ConnectionStrings["AutoLotSqlProvider"].ConnectionString; 

bool userDone = false; 

string userCommand = ""; 


// 创建 InventoryDAL 对 象 
InventoryDAL invDAL = new InventoryDAL(); 
invDAL .OpenConnection(cnStr); 


// 不 断 请 求 输入 ， 直 到 用 户 按 下 Q 键 
try 


ShowInstructions(); 
do 
{ 
Console.Write("\nPlease enter your command: "); 
UserCommand = Console.ReadLine(); 
Console.WritelLine(); 
switch (userCommand.ToUpper()) 
{ 
case "I": 
InsertNewCar(invDAL); 
break; 
case "U": 
UpdateCarPetName(invDAL); 
break; 
case "D": 
DeleteCar(invDAL); 
break; 
case "L": 
ListInventory(invDAL); 
break; 
ES 
ShowInstructions(); 
break; 
case "Pp": 
LookUpPetName (invDAL); 
break; 
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case "0"”: 
userDone = true; 
break; 
default: 
Console.WriteLine("Bad data! Try again"); 
break; 


} while (!userDone); 
catch (Exception ex) 
Console.WritelLine(ex.Message); 
i 


invDAL.CloseConnection(); 
} 
} 


21.11.2 ”实现 ShowInstructions() 方 法 
ShowInstructions() 方 法 做 的 事情 如 下 所 示 : 


private static void ShowInstructions() 


{ 
Console.WriteLine("I: Inserts a new car."); 
Console.WritelLine("U: Updates an existing car."); 
Console.WritelLine("D: Deletes an existing car."); 
Console.WriteLine("L: Lists current inventory."); 
Console.WritelLine("S: Shows these instructions."); 
Console.WriteLine("P: Looks up pet name."); 
Console.WriteLine("Q: Quits program."); 


21.11.3 ”实现 ListInventory() 方 法 


根据 构建 数据 访问 库 的 方式 ,可 以 通过 两 种 方式 中 的 任何 一 种 实现 ListInventory() 方 法 。 你 应 该 
记得 ， InventoryDAL 对 象 的 GetAllInventoryAsDataTable() 方 法 返回 DataTable 对 象 。 你 可 以 像 下 面 这 
样 实现 ListInventory() 方 法 : 


private static void ListInventory(InventoryDAL invDAL) 


// 获取 库存 列表 
DataTable dt = invDAL.GetAllInventoryAsDataTable(); 


// 将 DataTable 传 递 给 辅助 函数 用 于 显示 数据 
DisplayTable(dt); 


DisplayTable() 辅 助 方法 使 用 传人 DataTable 的 Rows 和 Columns 属 性 显示 表 数 据 ( DataTable 对 象 的 完 
整 细节 会 在 下 一 章 中 介绍 ， 在 这 里 先 不 要 纠缠 于 细节 ) : 

private static void DisplayTable(DataTable dt) 

{ 


// 输出 列 名 
for (int curCol = 0; curCol < dt.Columns.Count; curCol++) 
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Console.Write(dt.Columns[curCol].ColumnName + "\t"); 
Console.WriteLine("\n---------------------------------- 和 


// 输出 DataTable 
for (int curRow = 0; curRow < dt.Rows.Count; curRow++) 


for (int curCol = 0; curCol «< dt.Columns.Count; curCol++) 
Console.Write(dt.Rows[curRow][curCol].ToString() + "\t"); 


Console.WritelLine(); 


} 
} 


如 果 和 希望 调用 InventoryDAL 的 GetAllInventoryAsList() 方 法 ,可 以 实现 ListInventoryVialist() 方 
法 ， 如 下 所 示 : 


private static void ListInventoryVialist(InventoryDAL invDAL) 


// 获取 库存 列表 
List<NewCar> record = invDAL.GetAllInventoryAsList(); 


foreach (NewCar c in record) 


Console.WriteLine("CarID: {0}, Make: {1}, Color: {2}, PetName: {3}", 
Cc.CarID, c.Make, c.Color, c.PetName); 


} 


21.11.4 ”实现 DeleteCar() 方 法 


删除 既 有 汽车 很 简单 ， 只 需要 向 用 户 询问 要 删除 的 汽车 ID ， 然 后 把 它 传 给 InventoryDAL 类 型 的 
DeleteCar() 方 法 ， 如 下 所 示 : 


private static void DeleteCar(InventoryDAL invDAL) 


{ 
// 获取 要 删除 的 汽车 ID 
Console.Write("Enter ID of Car to delete: "); 
int id = int.Parse(Console.ReadLine()); 


// 以 防 违 反 引 用 完整 性 
try 
{ 

invDAL .DeleteCar(id); 


catch(Exception ex) 


Console.WritelLine(ex.Message); 


} 
} 


21.11.5 ”实现 InsertNewCar() 方 法 
插入 新 记录 到 Inventory 表 也 很 简单 ， 只 需要 向 用 户 请 求 新 数据 ( 通过 调用 Console.ReadLine() )， 
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并 把 数据 传人 InventoryDAL 的 InsertAuto() 方 法 ， 如 下 所 示 : 


private static void InsertNewCar(InventoryDAL invDAL) 


{ 
// 首先 获取 用 户 数据 
int newCarID; ， 
string newCarColor, newCarMake, newCarPetName; 


Console.Write("Enter Car ID: "); 
newCarID = int.Parse(Console.ReadLine()); 


Console.Write("Enter Car Color: "); 
newCarColor = Console.ReadLine(); 


Console.Write("Enter Car Make: "); 
newCarMake = Console.ReadLine(); 


Console.Write("Enter Pet Name: "); 
newCarPetName = Console.ReadLine(); 


// 现在 传 入 数据 访问 类 库 
invDAL.InsertAuto(newCarID, newCarColor, newCarMake, newCarPetName); 


} 
我 们 还 重 载 了 InsertAuto() 方 法 ， 它 接收 NewCar 对 象 ， 而 不 是 一 些 独 立 的 参数 。 因 此 ， 你 可 以 这 
样 实现 InsertNewCar() 方 法 : 


private static void InsertNewCar(InventoryDAL invDAL) 


{ 
// 首先 获取 用 户 数据 


// 现在 传 入 数据 访问 库 
NewCar c = new NewCar { CarID = newCarID, Color = newCarColor, 

Make = newCarMake, PetName = newCarPetName }; 
invDAL.InsertAuto(c); 


} 


21.11.6 ”实现 UpdateCarPetName() 方 法 


下 面 的 UpdateCarPetName() 的 实现 也 非常 相似 : 


private static void UpdateCarPetName(InventoryDAL invDAL) 
{ 

// 首先 获取 用 户 数据 

int carID; 

string newCarPetName; 


Console.Write("Enter Car ID: "); 

carID = int.Parse(Console.ReadLine()); 
Console.Write("Enter New Pet Name: "); 
newCarPetName = Console.ReadLine(); 


// 现在 传 入 数据 访问 类 库 
invDAL .UpdateCarPetName(carID, newCarPetName); 
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21.11.7 ”实现 LookUpPetName() 


获取 给 定 汽车 昵称 的 方法 与 前 面 的 方法 类 似 ， 因 为 数据 访问 库 封装 了 所 有 低级 别 的 ADO.NET 
调用 : 


private static void LookUpPetName(InventoryDAL invDAL) 


‘ 
// 获取 要 查找 的 汽车 的 ID 
Console.Write("Enter ID of Car to look up: "); 
int id = int.Parse(Console.ReadLine()); 
Console.WriteLine("pPetname of {0} is {1}.", 
id, invDAL.LookUpPetName(id).TrimEnd()); 
} 


有 了 这 个 方法 ， 基 于 控制 台 的 前 端 就 基本 完成 了 。 现 在 该 运行 程序 测试 各 个 方法 了 。 以 下 是 测试 
L、P、0Q 命 令 的 部 分 输出 结果 : 





****** The AutoLot Console UI ***** 


: Inserts a new car. 

: Updates an existing car. 
: Deletes an existing car. 
: Lists current inventory. 
: Shows these instructions. 
: Looks up pet name. 

: Quits program. 


OW"OIOCH 


Please enter your command: 上 
CarID Make Color PetName 


678 Yugo Green Clunker 
904 VW Black Hank 
1000 BMW Black Bimmer 
1001 BMW Tan Daisy 
1992 Saab Pink Pinkey 


Please enter your command: P 


Enter ID of Car to look up: 904 
Petname of 904 is Hank. 


Please enter your command: 0 


Press any key to continue . .. 








源 代码 ”AutoLotCUIClient 项 目的 源 代码 位 于 Chapter 21 子 目录 下 。 
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21.12 数据库 事务 


在 结束 对 ADO.NET 连 接 层 的 研究 前 , 我 们 来 看 一 下 数据 库 事 务 的 概念 。 简 单 来 说 ， 事 务 是 一 组 数 
据 库 操 作 ， 作 为 一 个 整体 ， 它 们 要 么 全 部 完成 ， 要 么 全 部 失败 。 我 们 可 以 想象 ， 事 务 对 于 确保 表 数 据 
的 安全 、 有 效 以 及 一 致 性 来 说 非常 重要 。 

如 果 数 据 库 操作 包含 与 多 个 表 或 多 个 存储 过 程 (或 数据 库 原子 的 组 合 ) 的 交互 , 事务 就 非常 重要 。 
经 典 的 事务 示例 包括 在 两 个 银行 账户 之 间 转 账 的 过 程 。 例 如 ， 如 果 我 们 从 储蓄 账户 转账 500 美 元 到 文 
票 账户 ， 如 下 步骤 应 该 以 事务 方式 发 生 : 

口 银行 应 该 从 储蓄 账户 移 除 500 美 元 ; 

口 银行 应 该 为 支票 账户 增加 500 美 元 。 

如 果 钱 从 储蓄 账户 移 走 了 但 又 没有 转移 到 支票 账户 ， 这 确实 是 一 件 糟糕 的 事情 ( 由 于 银行 方面 的 
某 些 错误 ) ， 因 为 我 们 现在 损失 了 500 美 元 ! 然而 ， 如 果 这 些 步 骤 放 入 数据 库 事务 ,DBMS 就 会 确保 所 
有 相关 步骤 以 一 个 整体 发 生 。 如 果 任 何 一 个 事务 失败 ， 整 个 操作 就 会 回 滚 到 原始 状态 。 另 一 方面 ， 如 
果 所 有 步骤 都 成 功 ， 事务 就 会 被 提交 。 

















说 明 你 可 能 在 研究 事务 相关 资料 时 已 经 听 说 过 ACID 这 个 缩写 。 这 表示 一 个 正规 事务 的 关键 属性 ， 
具体 而 言 就 是 原子 性 ( 全 有 或 全 无 ) 、 一 致 性 (数据 在 整个 事务 中 保持 稳定 ) 、 隔 离 性 ( 事 
务 之 间 不 会 互相 影响 ) 和 持久 性 (事务 会 被 保存 和 记录 上 日志) 。 





其 实 ，.NET 平 台 以 各 种 形式 支持 事务 。 对 本 章 来 说 ， 最 重要 的 就 是 ADO.NET 数 据 提 供 程序 的 事 
务 对 象 (在 这 里 就 是 System.Data.Sq1Client 中 的 SqlTransaction ) 。 此 外 ，.NET 基 础 类 库 提供 了 许多 
API 来 支持 事务 。 
口 System.EnterpriseServices: 这 个 命名 空间 ( 位 于 System.EnterpriseServices.dll 程 序 集 ) 提供 的 
类 型 允许 我 们 和 COM+ 运 行 库 层 结合 使 用 ， 包 括 对 分 布 式 事务 的 支持 。 
口 System.Tiransactions: 这 个 命名 空间 ( 位 于 System.Transactions.dl] 程 序 集 ) 包含 的 类 允许 我 们 
为 各 种 服务 写 事务 性 应 用 程序 和 资源 管理 器 ( 如 MSMQ、ADO.NET、COM+ 等 )。 
口 WCF ( Windows Communication Foundation ): WCF API 提 供 的 服务 使 事务 便于 处 理 各 种 分 布 式 
绑 定 类 。 
口 WF (Windows Workflow Foundations ): WF API 为 工作 流 活动 提供 事务 性 支持 。 

除了 .NET 基 础 类 库 中 现成 的 事务 支持 外 ， 还 可 以 使 用 数据 管理 系统 中 的 SQL 语言 本 身 来 实现 事 
务 。 例 如 ,我们 可 以 编写 存储 过 程 来 利用 BEGIN TRANSACTION 、ROLLBACK 和 COMMIT 语 句 。 


21.12.1 ADO.NET 事 务 对 象 的 主要 成 员 


虽然 事务 相关 类 型 在 基础 类 库 中 有 很 多 ,但 是 我 们 将 着 重 研究 ADO.NET 数 据 提 供 程序 中 的 事务 对 
象 ， 它 们 都 从 DBTransaction 派 生 并 且 实 现 了 IDbTransaction 接 口 。 回 忆 一 下 本 章 开 头 部 分 ， 
IDbTransaction 定 义 了 一 批 成 员 ， 如 下 所 示 : 
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public interface IDbTransaction : IDisposable 


IDbConnection Connection { get; } 
IsolationLevel IsolationLevel { get; } 


void Commit(); 
void Rollback(); 


注意 Connection 属 性 ， 它 会 返回 对 初始 化 当前 事务 的 连接 对 象 的 引用 ( 可 以 看 到 ， 我 们 从 某 个 连 
接 对 象 获 得 事务 对 象 )。Commit() 方 法 在 所 有 数据 库 操作 都 完成 后 才 调 用 , 为 此 ,所 有 待定 的 改变 都 会 
持久 化 到 数据 库 中 。 相 反 ，Rollback() 方 法 会 在 出 现 运 行 时 异常 时 进行 调用 ， 它 会 通知 DMBS 来 放弃 
所 有 待定 的 改变 ,保留 原始 数据 。 


说 明 ”事务 对 象 的 IsolationLevel 属 性 允许 我 们 指定 事务 在 遇 到 其 他 并 行事 务 时 如 何 处 理 。 默认 情况 
下 ， 事 务 会 被 完整 隔离 直到 提交 。 更 多 有 关 IsolationLevel 枚 举 值 的 细节 ， 请 参考 .NET 
Framework 4.5 SDK 文 档 。 


除了 IDbTransaction 接 口 定义 的 成 员 ，SqlTransaction 类 型 还 定义 了 一 个 叫做 Save() 的 成 员 , 它 允 
许 我 们 定义 保存 点 。 这 个 概念 允许 我 们 把 失败 的 事务 回 滚 到 一 个 保存 点 ,而 不 是 回 滚 整 个 事务 。 其 实 ， 
在 调用 SqlTransaction 对 象 的 Save() 方 法 时 ， 我 们 可 以 指定 一 个 友好 的 字符 串 名 。 在 调用 Rollback() 
时 ， 我 们 就 可 以 指定 相同 的 名 字 来 有 效 执行 部 分 回 滚 。 如 果 调 用 的 Rollback() 不 带 参数 ， 所 有 的 待定 
改变 会 被 回 滚 。 


21.12.2 ”为 AutoLot 数 据 库 添 加 CreditRisks 表 


为 了 说 明 ADO.NET 事 务 的 使 用 , 首先 使 用 Visual Studio 的 服务 器 资源 管理 器 向 AutoLot 数 据 库 添加 
一 个 叫 CreditRisks 的 新 表 ， 其 中 的 列 和 本 章 前 面 创建 的 Customers 表 完全 一 样 (作为 主键 的 CustID、 
FirstName 和 LastName )。 顾名思义 ,CreditRisks 用 于 记录 没有 通过 信用 检查 的 客户 ( 如 图 21-15 所 示 ) 。 





CreditRisks 
8 CustD 
FirstName 
LastName 





图 21-15 ”CreditRisks 表 


和 之 前 描述 的 从 储蓄 账户 转账 到 支票 账户 的 示例 相似 ， 把 风险 客户 从 Customers 表 转移 到 
CreditRisks 表 也 应 该 在 事务 范围 中 发 生 (毕竟 ， 我 们 会 希望 记 住 那些 不 诚信 的 客户 的 ID 和 名 字 )。 具 
体 而 言 , 我 们 需要 确保 这 两 个 数据 库 操作 要 么 都 发 生 , 要 么 都 不 发 生 : 从 当前 Customers 表 删除 当前 信 
用 风险 和 把 它们 加 入 到 CreditRisks 表 。 


21.12 数据库 事务 699 


说 明 在 生产 环境 下 ,没有 必要 构建 完整 的 数据 库 表 来 获取 高 风险 客户 。 你 可 以 在 已 知 的 Customers 
表 中 添加 Boolean 列 IsCreditRisk。 但 这 个 新 表 可 以 执行 简单 的 事务 。 


21.12.3 ”为 InventoryDAL 添 加 事物 方法 


为 了 演示 如 何以 编程 方式 使 用 ADO.NET 事 务 ， 打 开 我 们 在 本 章 前 面 创建 的 AutoLotDAL 代 码 类 库 
项 目 。 新 增 一 个 公共 方法 ProcessCreditRisk() 到 InventoryDAL 类 中 ， 它 会 如 下 处 理 接收 到 的 信用 风险 
( 注意 本 例 中 不 使 用 参数 化 查询 未 简化 实现 ,但 是 你 会 想 为 生产 级 方法 使 用 这 种 查询 ): 


// InventoryDAL 类 的 新 成 员 
public void ProcessCreditRisk(bool throwEx, int custID) 


// 首先 ， 基 于 客户 ID 查询 当前 的 名 字 
string fName = string.Empty; 
string lName = string.Empty; 
SqlCommand cmdSelect = new SqlCommand( 
string.Format("Select * from Customers where CustID = {0}", custID), sqlCn); 
using (SqlDataReader dr = cmdSelect.ExecuteReader()) 


if(dr.HasRows) 


dr.Read(); 
fName = (string)dr["FirstName"]; 
lName = (string)dr["LastName"]; 


else 
return; 


// 创建 表示 每 一 步 操 作 的 命令 对 象 
SqlCommand cmdRemove = new SqlCommand( 
string.Format("Delete from Customers where CustID = {0}", custID), sqlCn); 


SqlCommand cmdInsert = new SqlCommand(string.Format("Insert Into CreditRisks" + 
"(CustID, FirstName, LastName) Values" + 
"({0}, '{1}', '{2}')", custID, fName, lName), sqlCn); 


// 我 们 会 从 连接 对 象 获得 
SqlTransaction tx = null; 
try 

{ 


tx = sqlCn.BeginTransaction(); 


// 将 命令 加 入 到 事务 


cmdInsert .Transaction = tx; 
cmdRemove .Transaction = tx; 
// 执行 命令 


cmdInsert.ExecuteNonQuery(); 
cmdRemove. ExecuteNonQuery(); 


// 模拟 错误 
if (throwEx) 
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throw new Exception("Sorry! Database error! Tx failed..."); 


// 提交 
tx.Commit(); 


catch (Exception ex) 


Console.Writeline(ex.Message); 
// 有 任何 错误 都 会 回 滚 事 务 
tx.Rollback(); 


} 
} 


在 这 里 ， 我 们 使 用 传人 的 boo1 参 数 来 表示 是 否 在 处 理 不 诚信 客户 时 会 抛 出 一 个 异常 。 这 能 让 我 们 
轻松 模拟 会 导致 数据 库 事务 失败 的 不 可 预料 的 情况 。 很 明显 ， 这 只 是 出 于 演示 目的 ， 一 个 真正 的 数据 
库 事 务 方法 当然 不 会 允许 调用 者 来 强制 逻辑 失败 | 

注意 ， 我 们 使 用 两 个 sqlcommand 对 象 来 表示 事务 中 的 每 一 步 。 根 据 传 人 的 custID 参 数 获取 了 客户 
的 姓 和 名 之 后 , 通过 BeginTransaction() 方 法 从 连接 对 象 获 取 有 效 的 SqlTransaction 对 象 。 接 下 来 ， 最 
重要 的 是 , 我 们 必须 通过 把 Transaction 属 性 指定 给 刚才 获得 的 事务 对 象 来 登记 每 个 命令 对 象 。 如 果 不 
这 样 做 ， 插 入 /删除 逻辑 就 不 会 处 于 事务 上 下 文 之 中 。 

调用 了 每 一 个 命令 的 ExecuteNonQuery() 之 后 ， 如 果 ( 仅 当 ) boo1 参 数 的 值 是 true， 我 们 就 抛 出 一 
个 异常 。 在 这 种 情况 下 ， 所 有 待定 的 数据 库 操 作 都 会 回 滚 。 如 果 不 抛 出 异常 ， 所 有 的 步 又 都 会 在 我 们 
调用 Commit() 时 被 提交 到 数据 库 表 中 。 编 译 修改 后 的 AutoLotDAL 项 目 以 确保 没有 任何 拼写 错误 。 


21.12.4 测试 数据 库 事务 


虽然 现在 我 们 就 可 以 更 新 之 前 的 AutoLotCUIClient 应 用 程序 ， 新 增 一 个 调用 ProcessCreditRisk() 
方法 的 选项 ， 但 我 们 还 是 新 建 一 个 控制 台 应 用 程序 AdoNetTransaction。 添 加 AutoLotDAL.dll 程 序 集 的 
引用 ， 并 且 导 和 人 AutoLotConnectedLayer 命 名 空间 。 

然后 ， 右 击 ServerExplorer 中 的 表 图 标 ， 选 择 Show Table Data， 打 开 Customers 表 来 输入 数据 。 新 增 
一 个 低 信用 的 客户 ， 例 如 ， 

口 CustID: 333 

口 FirstName: Homer 

口 LastName: Simpson 

最 后 ， 按 如 下 所 示 更 新 我 们 的 Main() 方 法 : 


static void Main(string[] args) 
Console.WritelLine("***** Simple Transaction Example *****\n"); 


// 让 事务 成 功 或 失败 的 简单 方式 
bool throwEx = true; 
string userAnswer = string.Empty; 


Console.Write("Do you want to throw an exception (Y or N): "); 
userAnswer = Console.ReadLine(); 
if (userAnswer.ToLower() == "n") 
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throwEx = false; 


InventoryDAL dal = new InventoryDAL(); 
dal.0penConnection(@"Data Source=(local)\SQLEXPRESS; Integrated Security=SSPI;" + 
"Initial Catalog=AutoLot"); 


// 处 理 客 户 333 
dal.ProcessCreditRisk(throwEx, 333); 


Console.WriteLine("Check CreditRisk table for results"); 
Console.ReadLine(); 


如 果 运 行程 序 并 选择 抛 出 一 个 异常 ， 就 会 发 现 Homer 没 有 从 Customers 表 移 除 ， 因 为 整个 事务 被 回 
滚 了 。 然 而 ， 如 果 不 抛 出 异常 ， 就 会 发 现 Customer ID 333 不 再 存在 于 Customers 表 中 ， 而 是 被 放 到 了 
CreditRisks 表 中 。 


源 代码 ”AdoNetTransaction 项 目的 源 代码 位 于 Chapter 21 子 目录 下 。 


21.13 小结 


ADO.NET 是 .NET 平 台 的 原生 数据 访问 技术 ， 它 可 以 以 三 种 不 同 的 方式 进行 使 用 : 连接 式 、 断 
开 连 接 式 或 通过 Entity 框 架 。 在 本 章 中 ,我 们 研究 了 连接 层 并 进而 理解 了 数据 提供 程序 的 作用 ， 它 
们 本 质 上 是 几 个 抽象 基 类 ( 在 System.Data.Common 命 名 空间 中 ) 和 接口 类 型 ( 在 system.Data 命 名 空 
间 中 ) 的 具体 实现 。 我 们 已 经 看 到 , 可 以 使 用 ADO.NET 数 据 提供 程序 工厂 模型 来 构建 提供 程序 无 关 
的 代码 。 

通过 使 用 连接 对 象 、 事 务 对 象 、 命 令 对 象 以 及 连接 层 的 数据 读 取 器 对 象 , 我 们 就 可 以 选择 、 更 新 、 
插入 和 删除 记录 。 另 外 你 应 该 记得 ， 命 令 对 象 支持 内 部 参数 集合 ， 它 可 以 为 SQL 查询 增加 类 型 安全 ， 
并 且 对 于 触发 存储 过 程 也 非常 有 用 。 


ADO.NET 之 二 : 断 开 连接 层 








21 章 介绍 了 ADO.NET 的 连接 层 ， 它 允许 使 用 连接 、 命 令 和 数据 提供 程序 的 数据 读 取 器 对 象 
提交 SQL 语 句 到 数据 库 。 在 本 章 中 ， 我 们 会 介绍 ADO.NET 的 断 开 连 接 层 。 如 果 我 们 使 用 它 ， 
就 可 以 使 用 System.Data 命 名 空间 的 许多 成 员 ( 主要 是 DataSet .DataTable、DataRow、DataColumn、DataView 
和 DataRelation ) 在 调用 层 建 模 内 存 中 的 数据 库 数 据 。 这 样 就 使 我 们 误 以 为 调用 层 持续 连接 着 外 部 数据 
源 ， 而 其 实 只 是 在 操作 关系 数据 的 本 地 副本 。 
虽然 完全 可 以 使 用 ADO.NET 的 断 开 功能 而 不 连接 任何 关系 数据 库 , 但 是 我 们 通常 会 使 用 数据 提供 
程序 的 数据 适配器 对 象 来 填充 Dataset 对 象 。 我 们 会 看 到 , 数据 适配器 对 象 就 像 客户 层 和 关系 数据 库 之 
前 的 桥梁 。 使 用 这 些 对 象 , 我 们 就 可 以 获取 Dataset 对 象 , 操作 它们 的 内 容 , 把 修改 后 的 记录 发 送 回去 
处 理 。 这 样 就 能 产生 高 度 可 扩展 的 数据 相关 的 .NET 应 用 程序 。 
本 章 还 将 使 用 Windows Forms GUI 桌面 应 用 程序 演示 一 些 数据 绑 定 技 术 ， 并 介绍 强 类 型 DataSet 的 
作用 。 我 们 会 更 新 第 21 章 中 创建 的 AutoLotDAL.dl 数 据 类 库 , 使 用 ADO.NET 断 开 连 接 层 的 新 命名 空间 。 
最 后 ， 我 们 会 研究 LINQ to DataSet 的 作用 ， 它 允许 将 LINQ 查 询 应 用 于 内 存 数据 缓存 。 





说 明 ”你 将 在 本 书后 面 学 习 WPF 和 ASP.NET 应 用 程序 的 不 同 的 数据 绑 定 技术 。 





22.1 ADO.NET 断 开 连接 层 


通过 前 面 的 章节 我 们 知道 ， 连 接 层 可 以 通过 连接 、 命 令 、 数 据 读 取 器 对 象 来 和 数据 库 交 互 。 仅 仅 
使 用 这 几 个 简单 的 类 型 你 就 能 “尽情 享用 ”选择 、 插 入 、 更 新 、 删 除 记录 的 操作 [ 也 包括 调用 存储 过 
程 或 执行 其 他 数据 操作 ( 使 用 DDL 创 建 表 ， 使 用 DCL 赋 子 权 限 ) ]。 实 际 上 ADO.NET 的 内 容 你 才 看 了 
一 半 ， 前 面 曾 说 过 ，ADO.NET 对 象 模型 还 包括 断 开 式 模式 。 

使 用 断 开 连 接 层 ， 就 可 以 通过 内 存 中 的 对 象 模型 来 构建 关系 数据 。 除 了 构建 表格 形式 的 行 和 列 ， 
System.Data 中 的 类 型 允许 我 们 表示 表 关 系 、 列 约束 、 主 键 、 视 图 以 及 其 他 数据 库 基 元 。 此 外 ,一旦 我 
们 构建 了 数据 ， 就 可 以 应 用 过 滤器 ,提交 内 存 中 的 查询 以 及 以 XML 或 二 进 制 格式 持久 化 (或 加 载 ) 数 
据 。 我 们 甚至 可 以 在 不 与 DBMS 连 接 的 情况 下 做 所 有 这 些 事情 ( 因此 也 就 称 为 断 开 连接 层 ) ， 这 可 以 
通过 从 本 地 XML 文件 加 载 数据 或 在 代码 中 手动 构建 Dataset 来 实现 。 











说 明 第 23 章 将 学 习 ADO.NET Entity Framework， 它 是 基于 本 章 介绍 芍 基 并 连 竺 局 作 梳 咎 折 球 的 。 
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当 使 用 ADO.NET 的 断 开 式 访 问 方 式 的 时 候 , 不 需要 连接 到 数据 库 ,但 仍然 会 使 用 连接 和 命令 对 象 。 
另外 , 我 们 还 会 补充 一 个 叫做 数据 适配器 的 特殊 对 象 (扩展 自 DbbDataAdapter 抽 象 类 ) 来 获取 和 更 新 数 
据 。 与 连接 层 不 同 ， 这 里 的 数据 通过 数据 适配器 而 不 是 数据 读 取 器 获取 ， 并 且 数 据 适配器 对 象 通过 
DataSset 对 象 (或 者 更 确切 地 说 ， 是 DataSet 中 的 DataTable 对 象 ) 在 调用 者 和 数据 源 之 间 传 递 数据 。 
DataSet 可 以 包含 任意 多 的 DataTable 对 象 ， 而 DataTable 对 象 又 是 DataRow 和 DataColumn 对 象 的 集合 。 

数据 提供 程序 的 数据 适配器 对 象 自 动 处 理 数 据 库 连 接 。 为 了 增加 性 能 ， 数 据 适 配器 会 尽 可 能 缩短 
连接 打开 的 总 时 间 。 一 旦 调用 者 获得 了 DataSet 对 象 ， 它 会 立即 关闭 DBMS 的 连接 ， 仅 在 本 地 留 下 一 个 
远程 数据 的 本 地 副本 。 调用 者 可 以 任意 对 DataTable 进 行 插入 、 修 改 和 删除 操作 , 但 物理 数据 库 不 会 被 
更 新 ， 直 到 调用 者 显 式 将 Dataset 中 的 DataTable 提 交 到 到 数据 适配器 才 进 行 更 新 。 简 而 言 之 ，DataSet 
造成 了 客户 端 总 是 连接 着 数据 库 的 假 相 , 其实 所 有 的 操作 都 是 对 一 个 内 存 中 的 数据 库 进行 的 ( 如 图 22-1 
所 示 )。 


应 用 程序 


DataSet 


图 22-1 数据 适配器 对 象 从 客户 端 提交 Dataset 、 返 回 DataSet 到 客户 端 


既然 断 开 连接 层 的 亮点 在 于 Dataset， 下 面 我 们 的 任务 就 是 去 研究 如 何 手 动 操作 Dataset。 掌 握 了 
这 些 ， 对 你 来 说 操作 从 数据 适配器 对 象 返 回 的 Dataset 的 数据 就 轻而易举 了 。 





22.2 DataSet 的 作用 


前 面 提 到 过 ，Dataset 是 对 关系 数据 的 一 种 在 内 存 中 的 表现 形式 。 说 得 具体 一 点 ， 其 实 Dataset 类 
型 内 部 包含 了 3 个 强 类 型 的 集合 ( 如 图 22-2 所 示 )。 





DataSet 


DataTableCollection 
DataRelationCollection 
PropertyCollection 


图 22-2 ”剖析 DataSet 





DataSet 的 Tables 属 性 允许 访问 包含 独立 DataTable 的 DataTableCollection, DataSet 所 使 用 的 另外 一 个 
重要 的 集合 是 DataRelationCollection ， 既 然 Dataset 是 数据 库 的 一 个 断 开 连接 的 副本 ， 
DataRelationCollection 可 以 通过 编程 来 表示 各 表 之 间 的 父子 关系 。 比 如 , 使 用 DataRelation 类 型 对 两 
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个 外 键 约束 关联 的 表 建 立 联 系 。 然 后 能 通过 Relations 属 性 把 这 个 对 象 加 到 DataRelationCollection。 
这 样 ， 你 就 能 非常 方便 地 在 这 些 关联 表 中 搜索 数据 。 在 本 章 后 续 部 分 ,会 看 到 详细 的 实现 。 

ExtendedProperties 属 性 提供 了 PropertyCollection 对 象 的 访问 , 通过 它 能 把 额外 的 名 称 / 值 信息 关 
联 到 DataSet， 当 然 这 些 信息 可 以 是 任何 东西 ， 即使 它们 和 数据 本 身 没 有 任何 关系 。 比 如 说 你 能 把 你 公 
司 的 名 字 关 联 到 Dataset ， 表 现 为 一 种 在 内 存 中 的 元 数据 。 其 他 的 一 些 扩展 属性 的 用 途 还 包括 时 间 戳 、 
加 密 的 密码 ( 必须 提供 密码 才能 访问 DataSet 内 容 ) 和 数据 刷新 时 间 的 数值 等 。 


说 明 DataTable 和 DataColumn 类 同样 通过 ExtendedProperties 属 性 支持 扩展 属性 。 


22.2.1 DataSet 的 主要 属性 


在 探究 其 他 的 一 些 编程 细节 以 前 ， 先 来 看 一 下 DataSet 的 一 些 核心 成 员 。 除 了 Tables 、Relations 
和 ExtendedProperties 属 性 ， 表 22-1 还 列举 了 其 他 的 一 些 有 意思 的 属性 。 
表 22-1 DataSet 的 一 些 属性 





属 性 作 “用 
CaseSensitive 指示 DataTable 对 象 中 的 字符 串 比 较 是 否 区 分 大 小 写 。 默 认 值 为 false ( 默认 情况 下 不 区 分 大 
小 写 ) 
DataSetName 表示 DataSet 的 一 个 友好 名 ， 通 常 通过 构造 参数 指定 
EnforceConstraints 获取 或 设置 一 个 值 ， 该 值 指示 在 尝试 执行 任何 更 新 操作 时 是 否 遵 循 约束 规则 
HasErrors 获取 一 个 值 ， 指 示 在 此 Dataset 中 任何 DataTable 对 象 中 的 数据 行 是 否 存在 错误 
RemotingFormat 定义 DataSet 在 传输 时 内 容 的 序列 化 方式 [二进制 序列 化 或 XML 序列 化 《默认 值 ) ] 


22.2.2 ” DataSet 的 主要 方法 


DataSet 的 方法 实现 某 些 前 面 属性 提 到 的 那些 功能 ， 除 了 和 XML 数 据 流 交互 以 外 ，DataSet 提 供 了 
一 些 方法 让 你 复制 Dataset 的 内 容 ， 在 内 部 表 之 间 导 航 ， 另 外 包括 一 些 诸如 设置 批量 更 新 起 始 / 结 束 点 
的 功能 。 表 22-2 描 述 了 其 中 的 一 些 核 心 方法 。 


表 22-2” ”DataSet 的 一 些 方法 


方 法 作 用 
AcceptChanges() 提交 自 加 载 此 Dataset 或 上 次 调用 AcceptChanges() 以 来 对 其 进行 的 所 有 更 改 
Clear() 通过 移 除 所 有 DataTable 表 中 的 所 有 行 来 清除 任何 Dataset 的 数据 
Clone() 复制 Dataset 的 结构 ， 而 不 是 Dataset 的 数据 ， 包 括 所 有 DataTable 架 构 、 关 系 和 约束 
Copy() 复制 该 DataSet 的 结构 和 数据 
GetChanges() 获取 DataSet 的 副本 ， 该 副本 包含 自 上 次 加 载 以 来 或 自 调 用 AcceptChanges() 以 来 对 该 数据 


集 进行 的 所 有 更 改 。 重 载 该 方法 以 便 只 得 到 执行 、 已 修改 的 行 或 已 删除 的 行 
HasChanges() 获取 一 个 值 ， 该 值 指示 DataSet 是 否 有 更 改 ， 包括 新 增 行 、 已 删除 的 行 或 已 修改 的 行 
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( 续 ) 
广 法 作 用 
Merge() 将 指定 的 Dataset 合 并 到 当前 的 Dataset 中 
Readxml() 基于 XML 架构 和 从 流 中 读 取 的 数据 ， 定 义 Dataset 对 象 的 结构 并 用 数据 填充 它 
RejectChanges() 回 滚 自 创建 Dataset 以 来 或 上 次 调用 AcceptChanges() 以 来 对 其 进行 的 所 有 更 改 
WriteXml() 把 Dataset 的 内 容 写 人 一 个 有 效 的 数据 流 


22.2.3 ”构建 DataSet 


现在 对 Dataset 的 作用 了 解 得 更 清楚 了 ， 下 面 建立 一 个 新 的 控制 台 程 序 SimpleDataSet 并 导入 
System.Data 命 名 空间 。 在 Main() 方 法 里 定义 一 个 新 的 DataSet 对 象 ， 它 包含 3 个 扩展 属性 ， 分 别 代表 公 
司 名 、 标 识 符 (表示 为 System.Guid 类 型 ) 和 时 间 惟 ， 如 下 所 示 ， 

static void Main(string[] args) 


Console.WriteLine("***** Fun with DataSets *****\n"); 


// 建立 DataSet 对 象 并 添加 一 些 属性 
DataSet carsInventoryDS = new DataSet("Car Inventory"); 


"] = DateTime.Now; 
carsInventoryDS.ExtendedProperties["DataSetID"] = Guid.NewGuid(); 
carsInventoryDS.ExtendedProperties["Company"] = 
"Mikko’s Hot Tub Super Store"; 


Console.ReadLine(); 


carsInventoryDS.ExtendedProperties["TimeStamp" 
] 





说 了 明 GUID (全 局 唯一 标识 符 ) 是 静态 唯一 的 128 位 数字 。 


在 任何 情况 下 ， 只 有 你 在 DataSset 中 插入 几 个 DataTable 时 ，DataSet 对 象 才 会 有 意思 。 因 此 接 下 来 
就 要 研究 DataTable 的 内 部 结构 ， 我 们 先 从 DataColumn 类 型 开始 。 


22.3 使 用 DataColumn 


DataColumn 类 型 表示 DataTable 中 的 一 个 单列 。 一 般 来 说 ， 一 组 DataColumn 类 型 绑 定 到 一 个 特定 的 
DataTable， 组 合成 一 个 表 的 基本 结构 信息 。 比 如 你 想 为 AutoLot 数 据 库 建 立 一 个 Inventory 表 ( 见 第 21 
章 )， 就 要 建立 4 个 DataColumn ， 一 个 DataColumn 对 应 一 列 (CarID 、Make 、Color 和 PetName )。 在 建立 完 
DataColumn 对 象 以 后 , 需要 把 这 些 DataColumn 放 到 DataTable 类 型 的 列 集合 中 (通过 DataTable 的 Columns 
属性 )。 

如 果 了 人 解 关系 数据 库 的 话 ， 你 可 能 知道 数据 库 表 中 的 某 列 能 被 指定 一 组 约束 ( 比如 配置 成 主键 ， 
设置 默认 值 ， 配 置 成 只 读 等 )。 还 有 ， 数 据 表 中 的 每 列 必须 映射 到 一 个 基层 的 数据 类 型 ， 比 如 说 
Inventory 表 的 结构 需要 映射 CarID 列 为 数字 型 ， 映 射 Make 、Color 、PetName 为 字符 数组 型 。DataColumn 
类 有 许多 允许 配置 这 些 东西 的 属性 。 表 22-3 简 要 介绍 了 一 些 重要 属性 。 
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表 22-3 ”DataColumn 的 属性 








属 性 作 用 

AllowDBNu]1 该 属性 用 来 指示 对 于 表 中 的 行 ， 此 列 中 是 否 允 许 空 值 ， 默 认为 true 

AutoIncrement、AutoIncrementSeed ”这些 属性 用 来 配置 该 列 的 自 增 行为 , 当 需 要 确保 该 列 值 的 唯一 性 ( 比如 说 主键 ) 

和 AutoIncrementStep 时 将 会 非常 有 用 。 默 认 情 况 下 ，DataColumn 不 支持 自 增 

Caption 该 属性 用 来 获取 或 设置 要 显示 的 列 的 标题 ， 它 允许 我 们 为 数据 库 列 名 定义 一 个 
用 户 友好 的 版 本 

ColumnMapping 该 属性 决定 当 使 用 DataSet .WriteXml() 来 把 Dataset 保 存 到 XML 文 件 时 ， 该 列 将 以 
什么 样 的 形式 呈现 。 可 以 把 数据 列 写成 XML 元 素 、XML 特 性 或 文本 的 形式 

ColumnName 该 属性 用 来 获取 或 设置 列 集合 中 的 列 名 ( 在 DataTable 内 部 以 什么 样 的 名 字 呈 


现 )。 如 果 不 显 式 设置 ColumnName， 默认 的 列 名 格式 是 “Column” 字符 和 (n+1 ) 
后 缀 的 形式 ( 比如 column1、Column2、Column3 等 ) 


DataType 该 属性 定义 了 存储 在 列 中 的 数据 类 型 ( Boolean、string、float 等 ) 
DefaultValue 该 属性 用 来 获取 或 设置 在 创建 新 行 时 列 的 默认 值 

Expression 该 属性 用 来 获取 或 设置 表达 式 ， 用 于 筛选 行 、 计 算 列 中 的 值 或 创建 聚合 列 
Ordinal 该 属性 用 来 以 数字 形式 获取 DataTable 中 列 在 Columns 集 合 中 的 位 置 

Readonly 该 属性 指示 如 果 向 表 中 添加 了 行 ， 列 是 否 还 允许 更 改 ， 默 认为 false 

Table 该 属性 用 来 获取 DataColumn 所 属 的 DataTable 

Unique 该 属性 用 来 获取 或 设置 一 个 值 , 指示 列 的 每 一 行 中 的 值 是 否 必须 是 唯一 /可 重复 


的 。 如 果 列 作为 主键 ，Unique 属 性 应 该 设置 为 true 


22.3.1 构建 DataColumn 


我 们 来 继续 前 面 的 项 目 SimpleDataSet, 并 且 演 示 怎 么 使 用 DataColumn 为 Inventory 表 建立 列 。 因 为 
CarID 列 是 表 的 主键 ， 对 于 这 个 DataColumn 对 象 ， 我 们 将 它 设 置 为 只 读 、 唯 一 和 不 允许 空 值 (通过 
ReadOnly、Unique 和 AllowDBNull 属 性 )。 接着， 用 FillDataSet() 方 法 更 新 Program 类 ， 该 方法 用 于 建立 4 
个 DataColumn 对 象 。 注 意 该 方法 将 DataSet 对 象 作为 它 的 唯一 参数 : 

static void FillDataSet(DataSet ds) 

// 建立 对 应 AutoLot 数 据 库 Inventory 表 真实 字段 的 数据 列 
DataColumn carIDColumn = new DataColumn("CarID", typeof(int)); 
carIDColumn.Caption = "Car ID"; 

carIDColumn.ReadOnly = true; 


carIDColumn.AllowDBNull = false; 
carIDColumn.Unique = true; 


DataColumn carMakeColumn = new DataColumn("Make", typeof(string)); 
DataColumn carColorColumn = new DataColumn("Color", typeof(string)); 
DataColumn carPetNameColumn = new DataColumn("PetName", typeof(string)); 
carPetNameColumn.Caption = "Pet Name"; 


注意 ， 在 配置 carIDColumn 对 象 的 时 候 ， 我 们 就 为 Caption 属 性 赋 了 一 个 值 。 这 个 属性 很 有 用 ， 因 
为 它 能 让 我 们 定义 一 个 用 于 显示 的 、 和 原先 列 名 不 一 样 的 一 个 字符 串 值 [要 知道 ， 数 据 库 表 中 的 列 名 
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(如 au_fname ) 更 适合 用 于 编程 而 不 是 显示 ( 如 Author First Name )]。 这 里 基于 相同 的 原因 为 PetName 
列 设置 标题 ， 因 为 对 于 终端 用 户 来 说 ，Pet Name 比 PetName 更 好 看 。 


22.3.2 ”启用 自 增 列 


可 能 会 配置 的 DataColumn 的 另 一 个 方面 就 是 自 增 的 能 力 。 简 单 地 说 ， 自 增 列 是 为 了 保证 为 表 添加 
了 新 行 后 ， 该 列 自动 被 分 配 值 ， 该 值 基于 当前 的 自 增 步 进 。 当 需要 确保 该 列 的 值 是 不 重复 的 时 候 非 常 
有 用 (比如 说 主键 )。 

这 个 功能 使 用 AutoIncrement、AutoIncrementSeed 和 AutoIncrementStep 属 性 来 实现 。 第 二 个 属性 指 
定 列 的 起 始 值 ， 第 三 个 参数 指定 每 次 增加 的 步 进 值 。 看 下 面 对 carIDColumn 的 DataColumn 改 进 : 


static void FillDataSet(DataSet ds) 
DataColumn carIDColumn = new DataColumn("CarID", typeof(int)); 
carIDColumn.ReadOnly = true; 
carIDColumn.Caption = "Car ID"; 
carIDColumn.AllowDBNull] = false; 
carIDColumn.Unique = true; 
carIDColumn.AutoIncrement = true; 
carIDColumn.AutoIncrementSeed = 0; 
carIDColumn.AutoIncrementStep = 1; 


a 
在 这 里 ， 我 们 配置 了 carIDColumn 对 象 来 保证 当 表 新 增 了 一 行 后 ， 列 值 自 增 1。 因 为 我 们 设置 了 起 
始 值 为 0， 所 以 列 值 会 是 9、1、2、3 等 。 


22.3.3 ”把 DataColumn 对 象 加 入 DataTable 


DataColumn 类 型 显然 不 能 单独 存在 ， 需 要 加 入 到 一 个 相关 的 DataTable 中 去 。 为 了 演示 ， 我 们 创建 
一 个 新 的 DataTable 对 象 ( 稍 后 会 详细 介绍 )， 然 后 使 用 columns 属 性 加 入 列 集合 中 的 所 有 DataColumn 对 
象 ， 如 下 所 示 : 

a void FillDataSet(DataSet ds): 


// 把 DataColumn 加 入 到 DataTable 
DataTable inventoryTable = new DataTable("Inventory"); 
inventoryTable.Columns .AddRange (new DataColumn[] 

{ carIDColumn, carMakeColumn, carColorColumn, carPetNameColumn }); 


至 此 ， DataTable 对 象 有 4 个 DataColumn 对 象 ， 用 来 表示 内 存 中 Inventory 表 的 架构 。 然 而 ， 表 当前 
并 没有 数据 , 并 且 也 不 在 Dataset 维 护 的 表 和 集合 中 。 我 们 稍 后 会 处 理 这 些 不 足 , 首先 让 我 们 通过 DataRow 
对 象 来 填充 表 。 


22.4 ”使 用 DataRow 
我 们 知道 , DataColumn 对 象 的 集合 用 来 表示 DataTable 的 结构 。 反之, DataRow 对 象 的 集合 表示 的 是 
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表 中 的 实际 数据 .因此 ,如 果 在 AutoLot 数 据 库 的 Inventory 表 中 有 20 条 记录 ,你 就 可 以 使 用 20 个 DataRow 
对 象 来 呈现 它们 。 表 22-4 列 举 了 一 些 (但 不 是 全 部 ) DataRow 类 型 的 成 员 。 


表 22-4 ”DataRow 类 型 的 主要 成 员 








成 员 作 用 
HasErrors.、 HasErrors 属 性 返回 一 个 布尔 值 ， 指 示 该 行 是 否 存 在 错误 。 如 果 有 错误 ， 
GetColumnsInError().、 GetColumnsInError() 可 以 用 来 获取 包含 错误 的 成 员 ，GetColumnError() 获 取 错 误 说 明 ， 
GetColumnError()、 而 ClearError() 用 来 清除 该 行 的 所 有 错误 。RowErrors 属 性 可 以 为 错误 设置 一 个 自 定义 的 
ClearErrors() 和 文本 说 明 
RowError 
ItemArray 这 个 属性 通过 一 个 对 象 数组 来 获取 或 设置 此 行 的 所 有 列 值 
RowState 这 个 属性 用 来 得 到 DataTable 中 当前 DataRow 的 “状态 ”"， 值 由 RowState 枚 举 定义 ( 如 行 可 
以 被 标记 为 新 的 、 已 修改 的 、 未 改变 的 或 已 删除 的 
Table 这 个 属性 用 来 获取 包含 该 DataRow 的 DataTable 
AcceptChanges() 和 这 些 方法 提交 或 拒绝 自 上 次 调用 AcceptChanges 以 来 对 该 行进 行 的 所 有 更 改 
RejectChanges() 
BeginEdit()、 这 些 方法 开始 、 结 束 和 取消 对 某 DataRow 对 象 的 编辑 操作 
EndEdit() 和 
CancelEdit() 
Delete() 这 个 方法 能 标记 该 行为 待 删除 ， 调 用 AcceptChanges() 后 移 除 该 行 
IsNul1() 这 个 方法 获取 一 个 值 ， 该 值 指示 指定 的 列 是 否 包 含 空 值 


使 用 DataRow 和 使 用 DataColumn 有 些 不 同 ,因为 没有 公共 构造 函数 ,所 以 你 不 能 直接 创建 该 类 型 的 实例 : 


// 错误 ! 没 有 公共 构造 函数 
DataRow T = new DataRow(); 


正确 的 方法 是 从 某 个 DataTable 获 得 新 的 DataRow 对 象 。 比如 , 假设 你 想 在 Inventory 表 中 插入 两 行 ， 
DataTable.NewRow() 方 法 能 让 你 获得 该 表 的 下 一 个 “ 插 横 ”"， 然 后 通过 类 型 索引 器 为 每 列 赋值 。 我 们 可 
以 指定 赋值 给 DataCcolumn 的 字符 串 名 或 它 的 顺序 位 置 ( 以 0 开始 )， 下 面 是 代码 : 


static void FillDataSet(DataSet ds) 
{ 


// 现在 为 Inventory 表 增加 一 些 行 

DataRow carRow = inventoryTable.NewRow(); 
carRow[ "Make"] = "BMW"; 

carRow[ "Color"] = "Black"; 
carRow["PetName"] = "Hamlet"; 
inventoryTable.Rows .Add(carRow); 


CarRow = inventoryTable.NewRow(); 
// 第 0 列 是 自 增 ID 字段 ， 因 此 从 1 开始 
CarRow[1] = "Saab"; 

CarRow[2] = "Red"; 

carRow[3] = "Sea Breeze"; 
inventoryTable.Rows.Add(carRow); 


} 








说 明 如 果 传 入 DataRow 索 引 器 方法 的 是 无 效 的 列 名 或 无 效 的 顺序 位 置 ， 我 们 就 会 收 到 运行 时 异常 。 
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至 此 , 已 经 有 一 个 DataTable 包 含 了 两 行 。 当 然 ， 我 们 可 以 重复 这 个 过 程 ， 创 建 许多 DataTable， 
定义 架构 和 数据 内 容 。 在 把 inventoryTable 对 象 插 入 DataSset 对 象 中 之 前 ， 让 我 们 来 看 看 所 有 重要 的 
RowState 属 性 。 

22.4.1 RowState 属 性 


当 需 要 以 编程 方式 指定 表 中 的 一 组 行 被 修改 、 新 增 等 的 时 候 ， 就 会 使 用 Rowstate 属 性 。 这 个 属性 
的 值 可 以 是 DataRowState 枚 举 的 任何 值 ， 如 表 22-5 所 示 。 


表 22-5 ”DataRowState 枚 举 的 值 








值 作 用 
Added 该 行 已 添加 到 DataRowCollection 中 ，AcceptChanges() 尚 未 调用 
Deleted 该 行 标记 为 通过 DataRow 的 Delete() 方 法 被 删除 ， 并 且 没 有 调用 AcceptChanges() 方 法 
Detached 该 行 已 被 创建 , 但 不 属于 任何 DataRowCollection。DataRow 在 以 下 情况 下 立即 处 于 此 状态 : 创建 
之 后 ， 添 加 到 集合 中 之 前 或 者 从 集合 中 移 除 之 后 
Modified 该 行 已 被 修改 ，AcceptChanges() 尚 未 调用 
Unchanged 该 行 自 上 次 调用 AcceptChanges() 以 来 尚未 更 改 


当 以 编程 方式 操作 DataTable 表 中 的 行 时 ，Rowstate 属 性 会 被 自动 设置 作为 一 个 示例 。 例 如 ， 
Program 类 新 增 一 个 方法 ， 它 操作 本 地 DataRow 对 象 ， 然 后 输出 它 的 行 状态 ， 如 下 所 示 : 


private static void ManipulateDataRowState() 
{ 
// 创建 一 个 临时 的 DataTable 用 于 测试 
DataTable temp = new DataTable("Temp"); 
temp.Columns.Add(new DataColumn("TempColumn", typeof(int))); 


村 


// RowState = Detached (i.e. not part of a DataTable yet) 
DataRow row = temp.NewRow(); 
Console.WritelLine("After calling NewRow(): {0}", row.RowState); 


// Rowstate = Added 
temp.Rows .Add(row); 
Console.WriteLine("After calling Rows.Add(): {0}", row.RowState); 


// RowState = Added 
row["TempColumn"] = 10; 
Console.WriteLine("After first assignment: {0}", row.RowState); 


// RowState = Unchanged 
temp.AcceptChanges(); 
Console.WriteLine("After calling AcceptChanges: {0}", row.RowState); 


// RowState = Modified 
row["TempColumn"] = 11; 
Console.WriteLine("After first assignment: {0}", row.RowState); 


// RowState = Deleted 
temp.Rows[0] .Delete(); 
Console.WritelLine("After calling Delete: {0}", row.RowState); 
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可 见 ，ADO.NET DataRow 非 常 “ 聪 明 ”， 它 能 记 住 操作 后 的 状态 。 因 此 ， 包 含 DataRow 的 DataTable 
就 能 识别 哪些 行 是 添加 的 、 修 改过 的 或 者 删除 的 。 当 我 们 向 数据 库 提交 更 新 信息 的 时 候 ， 只 有 修改 过 
的 数据 才 会 被 提交 ， 这 是 DataSet 的 一 个 主要 特性 。 


22.4.2” ”DataRowVersion 属 性 


除了 通过 RowState 属 性 维护 行 的 当前 状态 外 ，DataRow 对 象 还 通过 DataRowVersion 属 性 维护 了 它 包 
含 的 数据 的 3 个 可 能 版 本 。 在 首次 构建 DataRow 对 象 时 , 它 仅 包含 一 份 数据 , 表示 为 “当前 版 本 ”。 然而 ， 
当 我 们 以 编程 方式 操作 DataRow 对 象 ( 通过 各 种 方法 调用 ) 后 ， 就 会 引入 其 他 版 本 的 数据 。 具 体 而 言 ， 
DataRowVersion 可 以 设置 为 DataRowVersion 枚 举 的 任何 相关 值 ( 如 表 22-6 所 示 )。 


表 22-6 ”DataRowVersion 枚 举 值 


值 作 “用 
Current ， 表示 行 的 当前 值 ， 即 使 在 做 出 改变 后 
Default DataRowState 的 默认 值 。 对 于 Added、Modified 或 Deleted 值 的 DataRowState， 默 认 版 本 
就 是 Current。 对 于 Detached 的 DataRowState， 版 本 就 是 Proposed 
Original 表示 首次 插入 DataRow 的 值 ， 或 AcceptChanges() 最 后 一 次 被 调用 后 的 值 
Proposed 表示 调用 BeginEdit() 后 当前 正在 被 编辑 的 行 的 值 


正如 表 22-6 所 示 , DataRowVersion 属 性 的 值 在 很 多 情况 下 取决 于 DataRowState 属 性 的 值 ,之 前 说 过 ， 
DataRowVersion 属 性 在 我 们 调用 了 DataRow ( 某 种 情况 下 是 DataTable ) 的 各 种 方法 之 后 会 悄悄 改变 。 下 
面 对 可 以 影响 行 的 DataRowVersion 属 性 值 的 方法 进行 一 些 分 析 。 

口 如 果 调 用 DataRow.BeginEdit() 方 法 并 且 改 变 行 的 值 ，Current 和 Proposed 值 就 可 用 了 。 

口 如 果 调 用 DataRow.CancelEdit() 方 法 ， 就 删除 了 Proposed 值 。 

口 在 调用 DataRow.EndEdit() 之 后 ，Proposed 值 就 变 为 Current 值 。 

口 在 调用 DataRow.AcceptChanges() 方 法 之 后 ，0original 值 就 和 Current 值 一 样 了 。 在 调用 

DataTable.AcceptChanges() 后 也 会 发 生 相 同 的 转换 。 

口 在 调用 DataRow.RejectChanges() 之 后 ，Proposed 值 就 被 取消 了 ， 版 本 就 变 成 了 Current。 

是 的 , 这 确实 很 复杂 一 一 主要 是 因为 DataRow 在 任何 时 候 都 可 能 有 也 可 能 没有 所 有 的 版 本 ( 如 果 我 
们 尝试 获取 当前 没有 跟踪 的 行 版 本 就 会 收 到 运行 时 异常 ) 。 虽 然 很 复杂 ， 但 是 DataRow 维 护 3 份 数据 副 
本 ,构建 允许 用 户 改变 值 、 改 变 主意 之 后 回 深 值 或 永久 提交 值 的 前 端 就 变 得 很 简单 。 在 本 章 剩余 部 分 
中 ， 我 们 会 看 到 操作 这 些 方法 的 各 种 示例 。 








22.5 使 用 DataTable 


DataTable 类 型 定义 了 许多 成 员 , 许多 在 名 字 和 功能 上 和 Dataset 的 差不多 。 表 22-7 列 举 了 DataTable 
类 型 除了 Rows 和 Columns 外 的 一 些 主要 属性 。 
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表 22-7 ”DataTable 类 型 的 主要 成 员 


属 性 作 用 
CaseSensitive 指示 表 中 的 字符 串 比较 是 否 区 分 大 小 写 ， 默 认为 false 
ChildRelations 获取 此 DataTable 的 子 关系 的 集合 ( 如 果 有 ) 
Constraints 获取 由 该 表 维 护 的 约束 的 集合 
Copy() 将 某 个 DataTable 的 架构 和 数据 复制 到 新 实例 中 
DataSet 获取 此 表 所 属 的 Dataset ( 如 果 有 ) 
DefaultView 获取 可 能 包括 筛选 视图 或 游标 位 置 的 表 的 自 定义 视图 
ParentRelations 获取 该 DataTable 的 父 关 系 的 集合 
PrimaryKey 获取 或 设置 充当 数据 表 主 键 的 列 的 数组 
TableName 获取 或 设置 表 的 名 称 ， 同 样 能 通过 构造 参数 指定 这 个 属性 


在 当前 例子 中 ， 让 我 们 先 来 把 DataTable 的 PrimaryKey 属 性 设置 为 DataColumn 对 象 carIDColumn。 要 
知道 ， 将 DataColumn 对 象 的 集合 赋 给 了 PrimaryKey 属 性 ， 表 示 多 列 键 。 然 而 在 这 里 ,我们 只 需要 指定 
CarID 列 ( 是 表 中 第 一 个 位 置 ) ， 如 下 所 示 : 


static void FillDataSet(DataSet ds) 


“7// 为 这 个 表 指 定 主键 


inventoryTable.PrimaryKey = new DataColumn[] { inventoryTable.Columns[0] }; 


22.5.1 将 DataTable 插 入 到 DataSet 中 


做 完 这 个 后 ，DataTable 的 例子 就 结束 了 。 最 后 一 步 就 是 使 用 Tables 集 合 把 DataTable 对 象 插 人 到 
carsInventoryDS 这 个 DataSset 对 象 ， 如 下 所 示 : 

static void FillDataSet(DataSet ds) 

{ 


“// 最 后 ， 把 我 们 的 表 加 入 到 DataSet 
ds.Tables.Add(inventoryTable); 
现在 更 新 Main() 方 法 以 调用 FillDataSet(), 然后 传递 这 个 Dataset 对 象 作为 参数 。 接着 将 这 个 对 象 
传递 到 一 个 叫 PrintDataset() 的 辅助 方法 ( 还 没有 写 )， 如 下 所 示 : 
static void Main(string[] args) 


Console.Writeline("***** Fun with DataSets *****\n"); 


FillDataSet(carsInventoryDS); 
PrintDataSet(carsInventoryDS); 
Console.ReadLine(); 
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22.5.2 ”获取 DataSet 中 的 数据 


这 个 PrintDataSet() 方 法 通过 ExtendedProperties 集 合 迭 代 DataSet 元 数据 和 DataSet 中 的 每 一 个 
DataTable， 并 且 使 用 索引 器 输出 列 名 和 行 值 : 


static void PrintDataSet(DataSet ds) 


{ 
// 输出 DataSet 名 称 和 扩展 属性 
Console.WriteLine("DataSet is named: {0}", ds.DataSetName); 
foreach (System.Collections.DictionaryEntry de in ds.ExtendedProperties) 


Console.WritelLine("Key = {0}, Value = {1}", de.Key, de.Value); 
Console.WritelLine(); 


// 输出 每 一 张 表 
foreach (DataTable dt in ds.Tables) 


{ 


Console.WritelLine("=> {0} Table:", dt.TableName); 


// 输出 列 名 
for (int curCol = 0; curCol «< dt.Columns.Count; curCol++) 


Console.Write(dt.Columns[curCol].ColumnName + "\t"); 
Console.WriteLine("\Nn------------- 二 中 


// 输出 DataTable 
for (int curRow = 0; curRow < dt.Rows.Count; curRow++) 


for (int curCol = 0; curCol < dt.Columns.Count; curCol++) 
Console.Write(dt.Rows[curRow][curCol].ToString() + "\t"); 


Console.WriteLine(); 
} 
} 
} 


如 果 现 在 运行 程序 ， 就 会 看 到 下 面 的 输出 结果 ( 时 间 蕉 和 GUID ) 值 当 然 会 不 同 : 


米 冰 炒米 Fun with DataSets ***** 








DataSet is named: Car Inventory 


Key = TimeStamp, Value = 1/22/2012 6:41:09 AM 
Key = DataSetID, Value = 11c533ed-d1aa-4c82-96d4-bof88893ab21 
Key = Company, Value = Mikko's Hot Tub Super Store 


=> Inventory Table: 
CarID Make Color PetName 


0 BMW Black Hamlet 
1 Saab Red Sea Breeze 


TE ERO 


22.5 使 用 DataTable 713 


22.5.3 ”使 用 DataTableReader 对 象 处 理 DataTable 


如 果 你 看 过 第 21 章 的 话 , 肯定 注意 到 了 使 用 连接 层 ( 如 数据 读 取 器 对 象 ) 和 断 开 连接 层 ( 如 DataSet 
对 象 ) 处 理 数据 的 方式 很 不 同 。 使 用 数据 读 取 器 一 般 会 创建 一 个 while 循 环 , 调用 Read() 方 法 并 且 使 用 
一 个 索引 器 来 取出 名 称 / 值 对 。 在 另 一 方面 ，DataSet 处 理 一 般 会 包含 一 系列 迭代 结构 来 挖掘 其 中 的 表 、 
行 和 列 ( 记得 DataReader 需 要 一 个 打开 的 数据 库 连 接 ， 以 便 从 实际 的 数据 库 中 读 取 数据 ) 。 

DataTable 支 持 一 个 叫做 CreateDataReader() 的 方法 。 这 个 方法 允许 使 用 像 数据 读 取 器 一 样 的 方式 
(数据 读 取 器 会 从 内 存 DataTable 而 不 是 实际 的 数据 库 中 读 取 数据 ， 因 此 这 里 不 涉及 数据 库 连 接 ) 来 获 
取 DataTable 内 的 数据 。 这 个 方法 的 主要 优势 是 , 我 们 可 以 用 一 个 模型 来 处 理 数据 ， 而 不 去 管 使 用 哪个 
层 的 ADO.NET。 为 了 演示 , 我 们 在 Program 类 中 创建 一 个 新 的 名 为 PrintTable() 的 辅助 方法 , 实现 如 下 : 


static void PrintTable(DataTable dt) 


// 得 到 DataTableReader 类 型 
DataTableReader dtReader = dt.CreateDataReader(); 


// 像 数 据 读 取 器 一 样 操作 DataTableReader 
while (dtReader.Read()) 


for (int i = 0; i «< dtReader.FieldCount; i++) 
Console.Write("{0}\t", dtReader.GetValue(i).ToString().Trim()); 
Console.WriteLine(); 


J) 
dtReader.Close(); 


注意 ， 操 作 DataTableReader 的 方式 和 操作 数据 提供 程序 的 数据 读 取 器 对 象 差 不 多 。 当 想 要 从 
DataTable 中 快速 取出 数据 时 ，DataTableReader 是 一 个 理想 的 解决 方案 ， 它 不 需要 手动 遍历 DataTable 
内 的 行列 集合 。 假 定 修改 了 前 面 的 PrintDataSet() 方 法 以 调用 PrintTable() 方 法 ,而 没有 遍历 Rows 和 
Columns 集 合 : 

static void PrintDataSet(DataSet ds) 

{ 

// 输出 DataSet 名 字 和 扩展 属性 
Console.WriteLine("DataSet is named: {0}", ds.DataSetName); 
foreach (System.Collections.DictionaryEntry de in ds.ExtendedProperties) 
Console.WriteLine("Key = {0}, Value = {1}", de.Key, de.Value); 
Console.WritelLine(); 
foreach (DataTable dt in ds.Tables) 
Console.Writeline("=> {0} Table:", dt.TableName); 


// 输出 列 名 
for (int curCol = 0; curCol < dt.Columns.Count; curCol++) 


Console.Write(dt.Columns[curCol].ColumnName.Trim() + "\t"); 
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Console.WriteLine("\n---------------------------------- “让 


// 调用 新 的 辅助 方法 
printTable(dt); 


} 
此 时 运行 应 用 程序 ,得 到 的 输出 结果 与 前 面 一 样 。 唯 一 的 不 同 是 在 内 部 访问 DataTable 的 内 容 的 方式 。 


22.5.4 ”序列 化 DataTable/DataSet 对 象 为 XML 


DataSet 和 DataTable 都 支持 WriteXm1() 和 ReadXml1() 方 法 。WriteXm1() 人 允许 把 它们 的 内 容 持久 化 成 
XML 文档 形式 的 本 地 文件 ( 包括 所 有 从 System.I0.Stream 继 承 的 类 型 )。Readxml() 人 允许 从 XML 文档 加 
载 数 据 到 Dataset (或 者 DataTable )。 另 外 ，pDataset 和 DataTable 都 支持 Writexmlschema() 和 
ReadXmlSchema() 来 保存 和 加 载 一 个 *.xsd 文 件 。 

为 了 做 个 测试 ， 请 修改 Main() 方 法 以 调用 最 后 一 个 辅助 方法 ( DataSet 是 唯一 参数 ): 


static void SaveAndLoadAsxml(DataSet carsInventoryDS) 
{ 


// 保存 这 个 DataSet 为 XML 
carsInventoryDS .WriteXml("carsDataSet .xm]"); 
carsInventoryDS .WriteXmlSchema("carsDataSet.xsd"); 


// 清除 DataSet 
carsInventoryDS.Clear(); 


// 从 XML 文件 中 加 载 DataSet 
carsInventoryDS.ReadXm]l("carsDataSet.xml”"); 


} 
如 果 打 开 carsDataSet.xml 文 件 ( 它 将 位 于 你 的 项 目的 \bin\Debug 文 件 夹 下 )， 你 会 看 到 表 中 的 各 个 
列 都 被 编码 成 了 XML 元 素 : 


<?xml version="1.0" standalone="yes"?> 
<Car_x0020_Inventory> 
<Inventory> 
《CarID>0</CarID> 
<Make>BMW< /Make> 
<Color>Black</Color> 
<PetName>Hamlet</PetName> 
</Inventory> 
<Inventory> 
<CarID>1¢/CarID> 
<Make>Saab</Make> 
<Color>Red</Color> 
<PetName>Sea Breeze</PetName> 
</Inventory> 
</Car_x0020_Inventory> 


在 Visual Studio 中 双击 生成 的 *.xsd 文 件 ( 同样 位 于 \bin\Debug 文 件 夹 )， 将 打开 IDE 的 XML 架构 编 
辑 器 ( 如 图 22-3 所 示 )。 


说 明 第 24 章 将 介绍 LINQ to XML API， 它 是 在 .NET 平 台 下 操纵 XML 数据 的 首选 方式 。 
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carsDataSet.xsd* XpPr ram.cs : 





| CariD 
| Make 

Color 

PetName 


图 22-3 ”Visual Studio 的 XSD 编辑 器 


22.5.5 ”以 二 进 制 格式 序列 化 DataTable/DataSet 对 象 
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还 可 以 把 Dataset ( 或 单个 DataTable ) 的 内 容 以 紧凑 二 进 制 格式 进行 持久 化 。 如 果 DataSet 对 象 需 
要 跨越 机 器 边界 传递 的 话 ， 这 就 特别 有 用 ( 比如 在 分 布 式 应 用 程序 中 ) 。XML 数据 表现 的 一 个 劣势 就 


是 其 强 描述 性 可 能 会 导致 大 量 的 负担 。 


为 了 以 二 进 制 格式 持久 化 DataTable 或 Dataset ， 只 需要 设置 RemotingFormat 属 性 为 
SerializationFormat.Binary。 至 此 ， 我 们 就 可 以 按照 期 望 使 用 BinaryFormatter 类 型 ( 见 第 20 章 )。 考 
虑 SimpleDataSet 项 目的 最 后 一 个 方法 (不 要 忘记 导 人 System.I0 和 System.Runtime。 Serialization. 


Formatters.Binary 命 名 空间 ) : 


static void SaveAndLoadAsBinary(DataSet carsInventoryDS) 


{ 
// 设置 二 进 制 序列 化 标记 
carsInventoryDS.RemotingFormat = SerializationFormat.Binary; 


// 以 二 进 制 格式 保存 DataSet 

FileStream fs = new FileStream("BinaryCars.bin", FileMode.Create); 
BinaryFormatter bFormat = new BinaryFormatter(); 

bFormat. Serialize(fs, carsIinventoryDS); 

fs.Close(); 


// 清空 DataSet 
carsInventoryDS.Clear(); 


// 从 二 进 制 文件 加 载 DataSet 
fs = new FileStream("BinaryCars.bin", FileMode.Open); 
DataSet data = (DataSet)bFormat.Deserialize(fs); 


如 果 从 Main() 中 调用 该 方法 ， 就 会 在 bin\Debug 文 件 夹 中 找到 *.bin 文 件 。 图 22-4 显 示 了 BinaryCars. 


bin 文 件 的 内 容 。 
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BinaryCars.bin PD X carsDataSet.xsd” Program.cs : > 
000028d0 02 SF 68 02 SF 69 02 SF 6A 02 5F 6B 00 00 00 00 ] hg a 
000028e0 
000028f0 
00002900 
00002910 
00002920 
00002930 
00002940 
00002950 
00002960 


000029c0 
000029a0 
000029e0 





图 22-4 ”以 二 进 制 格式 序列 化 一 个 Dataset 


源 代码 ”SimpleDataSet 应 用 程序 的 源 代码 位 于 Chapter 22 子 目录 下 。 


22.6 将 DataTable 对 象 绑 定 到 用 户 界面 


至 此 ， 我 们 已 经 研究 了 如 何 使 用 ADO.NET 的 继承 对 象 模型 手动 创建 、 合 成 和 迭代 Dataset 对 象 的 
内 容 。 虽 然 理 解 如 何 实现 很 重要 ， 但 是 .NET 平 台 有 许多 API 提 供 了 自动 将 数据 绑 定 到 用 户 界面 元 素 的 
能 力 。 

例如 ，.NET 的 原始 GUI 工具 包 Windows Forms 支 持 一 个 叫 DataGridview 的 控件 , 它 内 建 了 使 用 几 行 
代码 来 显示 DataSet 或 DataTable 对 象 内 容 的 能 力 。 ASP.NET( .NET Web 开 发 API ) 和 WPF API( .NET 3.0 
引入 的 增强 的 GUI API ) 也 支持 以 相似 形式 实现 数据 绑 定 。 本 书后 面 将 学 习 如 何 绑 定数 据 到 WPF 和 
ASPNET GUI 元 素 。 但 是 在 本 章 中 ， 你 将 使 用 Windows Forms， 因 为 它 是 相当 简单 的 编程 模型 。 


说 明 下 一 个 示例 假设 你 已 经 具备 使 用 Windows Forms 来 构建 GUI 的 经 验 。 如 果 不 是 这 样 的 话 ， 你 最 
好 先 学 习 一 下 解决 方案 ， 或 者 在 阅读 附录 A 后 返回 到 这 部 分 内 容 。 


下 一 个 任务 就 是 构建 一 个 Windows Forms 应 用 程序 ， 在 用 户 界 面 上 显示 DataTable 对 象 的 内 容 。 然 
后 ， 我 们 还 会 研究 如 何 过 滤 和 改变 表 数 据 ， 并 且 我 们 会 了 解 DataView 对 象 的 作用 。 

首先 ， 创建 一 个 叫做 WindowsFormsDataBinding 的 全 新 Windows Forms 项 目 工作 区 。 使 用 Solution 
Explorer 将 初始 的 Forml.cs 重 命名 为 更 合适 的 MainForm.cs。 然 后 ， 使 用 Visual Studio 工 具 箱 将 Data 选 项 
卡 上 的 DataGridView 控 件 ( 通过 Properties 窗 口 的 Name 属 性 重 命名 为 carInventoryGridview ) 拖 归 到 设计 
器 界面 上 。 你 可 能 会 注意 到 ， 当 第 一 次 向 设计 器 添加 DataGridview 时 ， 激 活 了 一 个 允许 连接 到 物理 数 
据 源 的 上 下 文 菜 单 。 但 是 现在 忽略 设计 器 的 这 个 方面 , 因为 我 们 会 通过 编程 绑 定 DataTable 对 象 。 最 后 ， 
为 了 显示 信息 ， 向 设计 器 增加 一 个 描述 性 的 Label。 图 22-5 演 示 了 可 能 的 外 观 。 
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Mainform,cs [Design}” 2 Xx 





Here is what we have in stock 











图 22-5 ”Windows Forms 应 用 程序 最 初 的 GUI 


22.6.1 ”从 泛 型 Listx<T> 合 成 DataTable 


和 之 前 的 SimpleDataSet 示 例 相 似 ，WindowsFormsDataBinding 应 用 程序 会 构建 一 个 DataTable 来 包 
含 一 组 表示 各 列 各 行 数据 的 DataColumn。 然 而 ， 现 在 我 们 会 使 用 泛 型 List<T> 成 员 变 量 填充 行 。 首 先 ， 
为 我 们 的 项 目 插 入 一 个 叫做 Car 的 新 的 C# 类 ， 定 义 如 下 : 

public class Car 


public int ID { get; set; } 
public string PetName { get; set; } 
public string Make { get; set; } 
public string Color { get; set; } 

} 


现在 ， 在 默认 构造 函数 中 ， 使 用 一 个 叫 1listCars 的 List<T> 成 员 变 量 来 填充 一 组 car 对 象 ， 如 下 所 示 : 


public partial class MainForm : Form 


// Car 对 象 的 集合 
List<Car> listCars = null; 


public MainForm() 
InitializeComponent(); 


// 填充 一 些 汽车 


listCars = new List<Car> 


new Car { ID = 100, PetName = "Chucky", Make = "BMW", Color = "Green" }, 
new Car { ID = 101, PetName = "Tiny", Make = "Yugo", Color = "White"” }, 
new Car { ID = 102, PetName = "Ami", Make = "Jeep", Color = "Tan" }, 
new Car { ID = 103, PetName = "Pain Inducer", Make = "Caravan", 

Color = "Pink"” }, 
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new Car { ID = 104, PetName = "Fred", Make = "BMW", Color = "Green" }, 

new Car { ID = 105, PetName = "Sidd", Make = "BMW", Color = "Black”}， 

new Car { ID = 106, PetName = "Mel", Make = "Firebird", Color = "Red" }, 

new Car { ID = 107, PetName = "Sarah", Make = "Colt", Color = "Black” }, 
}; 


} 
} 


然后 ， 向 MainForm 类 增加 一 个 叫 inventoryTable 的 DataTable 类 型 成 员 变量 ， 如 下 所 示 : 


public partial class MainForm : Form 


// Car 对 象 的 集合 


List<Car> listCars = null; 


// 库存 信息 
DataTable inventoryTable = new DataTable(); 


和 
为 我 们 的 类 增加 一 个 叫 CreateDataTable() 的 辅助 郴 数 ， 并 且 在 MainForm 类 的 默认 构造 函数 中 调用 
:了 
这 个 方法 : 
private void CreateDataTable() 


// 创建 表 构 架 

DataColumn carIDColumn = new DataColumn("ID", typeof(int)); 

DataColumn carMakeColumn = new DataColumn("Make", typeof(string)); 

DataColumn carColorColumn = new DataColumn("Color", typeof(string)); 

DataColumn carPetNameColumn = new DataColumn("PetName", typeof(string)); 

carPetNameColumn.Caption = "Pet Name"; 

inventoryTable.Columns.AddRange(new DataColumn[] { carIDColumn, 
carMakeColumn, carColorColumn, carPetNameColumn }); 


// 选 代数 组 列表 List<T> 来 创建 行 


foreach (Car c in listCars) 


DataRow newRow = inventoryTable.NewRow(); 
newRow[ "ID"] = c.ID; 

newRow[ "Make"] = c.Make; 

newRow[ "Color"] = c.Color; 

newRow[ "PetName"] = c.PetName; 
inventoryTable.Rows .Add(newRow); 


} 


// 把 DataTable 绑 定 到 carInventoryGridView 
carInventoryGridView.DataSource = inventoryTable; 


} 

这 个 方法 的 实现 首先 通过 创建 4 个 DataColumn 对 象 来 创建 DataTable 的 架构 ( 为 了 简单 ， 我 们 没有 
增加 自动 递增 的 ID 字段 或 把 它 设 为 主键 ) ， 然 后 我 们 把 它们 加 入 到 DataTable 成 员 变 量 中 。 然 后 使 用 
foreach 和 迭代 结构 和 原生 ADO.NET 对 象 模型 将 行 数据 从 List<Car> 字 段 映 射 到 DataTable。 

然而 ， 注 意 CreateDataTable() 方 法 中 最 后 一 个 代码 语句 将 inventoryTable 赋 值 给 了 DataGridview 
对 象 的 DataSource 属 性 。 只 需要 设置 这 个 属性 就 可 以 绑 定 DataTable 到 DataGridview 对 象 。GUI 控 件 会 
在 内 部 读 取 行列 集合 ， 和 我 们 在 SimpleDataSet 示 例 中 处 理 的 PrintDataSet() 方 法 很 相似 。 至 此 就 可 以 
运行 应 用 程序 了 ， 我 们 将 看 到 DataGridView 控 件 中 的 DataTable， 如 图 22-6 所 示 。 
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图 22-6” 绑 定 DataTable 到 Windows Forms DataGridView 


22.6.2 ”从 DataTable 中 删除 行 


现在 如 果 想 修改 图 形 界面 ,使 用户 能 删除 绑 定 到 DataGridView 的 DateTable 中 的 行 ， 一 个 办 法 就 是 
调用 DataRow 对 象 的 Delete() 方 法 来 表明 这 行 即将 删除 。 只 需 指 定 待 删除 行 的 索引 (或 者 DataRow 对 象 )。 
为 了 使 用 户 能 指定 要 删除 的 行 ， 将 一 个 TextBox ( 名 为 txtRowRemove ) 和 一 个 Button 控 件 (名 为 
btnRemoveRow ) 添加 到 当前 设计 器 。 如 图 22-7 显 示 了 一 个 可 能 的 UI 更 新 ( 注意 本 例 在 GroupBox 控 件 中 
包括 两 个 控件 ， 以 便 强 调 它们 是 如 何 关联 的 )。 
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图 22-7 修改 UI 以 允许 从 DataTable 移 除 行 
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新 Button 的 Click 事 件 处 理 程序 根据 汽车 的 ID ， 从 位 于 内 存 的 DataTable 中 移 除 了 用 户 指定 的 行 。 
DataTable 类 的 Select() 方 法 可 以 指定 一 个 搜索 条 件 ， 它 模仿 了 正常 的 SQL 语法 。 返 回 值 为 匹配 搜索 条 
件 的 DataRow 对 象 的 数组 : 

// 从 DataRowCollection 删 除 这 行 

private void btnRemoveCar Click (object sender, EventArgs e) 


try 


{ 
// 找到 要 删除 的 行 
DataRow[ ] rowToDelete = inventoryTable.Select( 
string.Format("ID={0}", int.Parse(txtCarToRemove.Text))); 


// 删除 它 
rowToDelete[0].Delete(); 
inventoryTable.AcceptChanges(); 


catch (Exception ex) 


MessageBox.Show(ex.Message); 


} 
现在 可 以 运行 应 用 程序 并 且 指 定 要 从 DataTable 中 删除 的 汽车 ID。 如 果 从 DataTable 移 除 DataRow 对 
象 的 话 ， 我 们 会 发 现 网 格 的 UI 立即 更 新 了 ， 因 为 它 绑 定 了 到 DataTable 对 象 的 状态 。 


22.6.3 ”根据 筛选 条 件 选 择 行 


很 多 数据 相关 的 应 用 程序 需要 通过 指定 某 种 过 滤 标 准 来 查看 DataTable 数 据 的 一 个 小 集合 。 例 如 ， 
可 以 只 看 到 内 存 中 DataTable 中 某 个 牌子 的 汽车 ( 如 BMW )。 使 用 DataTable 类 的 select() 方 法 , 我 们 就 
可 以 找到 要 删除 的 行 ， 然 而 为 了 显示 ， 也 可 以 用 这 个 方法 选择 记录 的 子 集 。 

再 次 修改 图 形 界 面 ， 这 次 使 用 一 个 新 的 TextBox ( 名 为 txtMakeToView ) 和 一 个 新 的 Button ( 名 为 
btnDisplayMakes ) 能 允许 用 户 填写 一 个 他 们 感 兴趣 的 品牌 的 字符 串 ( 如 图 22-8 所 示 )。 

Select() 方 法 被 重 载 了 多 次 ， 以 提供 不 同 的 筛选 方式 。 最 简单 的 就 是 用 包含 条 件 操作 符 的 字符 串 
作为 参数 值 来 指定 。 首 先 观察 下 面 新 建 按钮 的 Click 事 件 处 理 程序 : 

private void btnDisplayMakes Click(object sender, EventArgs e) 


// 根据 用 户 输入 的 内 容 构建 过 滤器 
string filterSstr = string.Format("Make= '{0}'", txtMakeToView.Text); 


// 查找 符合 条 件 的 所 有 记录 
DataRow[] makes = inventoryTable.Select(filterstr); 


if (makes.Length == 0) 

MessageBox.Show("Sorry, no cars...", "Selection error!"); 
else 
{ 

string strMake = ""; 

for (int i = 0; i < makes.Length; i++) 


{ 
// 从 当前 行 开始 ， 获 取 PetName 的 值 
strMake += makes[i]["PetName"] + "\n"; 
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// 显示 消息 框 中 所 有 符合 条 件 的 记录 
MessageBox.Show(strMake, 
string.Format("We have {0}s named:", txtMakeToView.Text)); 
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图 22-8 更 新 UI 以 启用 行 筛选 


在 这 里 ， 我 们 做 的 这 个 简单 的 过 滤器 是 以 TextBox 的 值 为 基础 的 。 如 果 你 填写 BMW， 过 滤 参 数 就 
是 Make='BMW' 。 当 使 用 select() 方 法 提交 这 个 条 件 时 ,你 会 得 到 一 个 符合 这 个 条 件 的 DataRow 类 型 数组 
( 如 图 22-9 所 示 )。 
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可 见 ， 过 滤 参 数 是 标准 的 SQL 语 法 。 假 设 你 想 按 照 PetName 字 段 的 字母 顺序 得 到 前 面 的 Select() 执 
行 结果 ， 对 于 SQL 语句 而 言 ， 就 是 按照 PetName 列 进行 排序 。 幸 好 Select() 方 法 已 被 重 载 ， 有 一 个 相应 
的 标准 能 实现 这 个 功能 ， 下 面 是 代码 : 


// 按照 PetName 排 序 
makes = inventoryTable.Select(filterStr，"PetName"); 


如 果 你 想 要 结果 倒序 ， 像 这 样 调用 select() : 


// 以 倒序 返回 结果 
makes = inventoryTable.Select(filterStr，"pPetName DESC"); 


通常 ， 这 个 排序 字符 串 由 列 名 和 ASC ( 正 序 ) 或 者 DESC ( 倒序 ) 组 成 。 如 果 需 要 的 话 ， 可 以 用 逗号 
分 割 字段 来 按照 多 个 字段 排序 。 最 后 需要 知道 ， 过 滤器 字符 串 能 包含 任意 多 的 关系 操作 。 例 如 ， 当 你 
想 查 找 所 有 ID 大 于 5 的 汽车 时 ， 该 怎么 做 呢 ? 下 面 是 一 个 完成 这 个 工作 的 辅助 方法 : 
private void ShowCarsWithIdGreaterThanFive() 
// 现在 显示 所 有 ID 大 于 5 的 汽车 名 字 
DataRow[] properIDs; 
string newFilterStr = "ID > 5"; 
properIDs = inventoryTable.Select(newFilterStr); 


string strIDs = null; 
for(int i = 0; i < properIDs.Length; i++) 


DataRow temp = properIDs[i]; 
strIDs += temp["PetName"] 
+ ”is ID ”+ temp["ID"] + "\n"; 


MessageBox.Show(strIDs, "Pet names of cars where ID > 5"); 


22.6.4 ”在 DataTable 中 更 新 行 


最 后 需要 了 解 如 何 用 新 的 值 更 新 DataTable 中 现 有 行 的 操作 。 一 个 方法 就 是 先 使 用 Select() 方 法 按 
照 一 定 的 标准 筛选 出 一 些 行 ， 只 要 得 到 了 这 些 DataRow， 就 逐一 修改 它们 。 比 如 , 假设 现在 可 以 在 表单 
btnChangeMakes 上 新 建 一 个 Button， 单 击 Button 后 ， 从 DataTable 搜 索 所 有 Make 字 段 等 于 BMw 的 行 ， 然 后 
逐一 修改 Make 字 段 内 容 ， 从 BMW 改 为 Yugo， 如 下 所 示 : 

// 用 过 滤器 找到 想 编辑 的 行 

private void btnChangeMakes Click(object sender, EventArgs e) 


// 确认 用 户 是 否 改 变 主意 
if (DialogResult.Yes == 
MessageBox.Show("Are you sure?? BMWs are much nicer than Yugos!", 
"Please Confirm!", MessageBoxButtons.YesNo)) 


{ 
// 建立 一 个 过 滤器 
string filterStr = "Make="BMW'"; 
string strMake = string.Empty; 


// 找到 所 有 匹配 过 滤器 的 行 
DataRow[] makes = inventoryTable.Select(filterStTr); 


// 把 所 有 的 “Beemers” 修 改 成 “Yugos” 
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for (int i = 0; i < makes.Length; i++) 
makes[i]["Make"] = "Yugo"; 


} 
} 


22.6.5 ”使 用 DataView 类 型 


在 数据 库 术 语 中 ,视图 对 象 是 一 个 表 ( 或 者 一 组 表 ) 自 定义 的 表现 形式 。 比 如 说 ， 使 用 微软 SQL 
Server 可 以 为 现在 的 Inventory 表 建立 一 个 视图 , 返回 一 个 只 有 某 种 特定 颜色 的 汽车 的 表 。 在 ADO.NET 
中 ，DataView 类 型 允许 以 编程 方式 从 DataTable 中 提取 一 组 数据 到 独立 的 对 象 。 

为 同一 个 表 建 立 多 个 视图 最 大 的 好 处 就 是 允许 绑 定 它们 到 不 同 的 GUI 部 件 〈 比如 DataGridView )。 
比如 说 ， 一 个 DataGridyview 绑 定 到 Dataview， 显 示 Inventory 表 中 的 所 有 数据 ， 另 外 一 个 则 被 配置 成 只 
显示 绿色 的 车 型 。 

为 了 演示 ， 我 们 先 为 当前 的 用 户 界面 男 外 增加 一 个 名 为 dataGridYugosView 的 DataGridView 和 一 个 
描述 性 Label。 接 着 ， 定 义 一 个 DataView 类 型 的 变量 yugo0nlyView: 

public partial class MainForm : Form 

// DataTable 的 视图 
DataView yugosOnlyView; 

半 

现在 ， 在 程序 默认 的 构造 方法 内 新 建 一 个 叫做 CreateDataView() 的 辅助 方法 ， 并 且 在 DataTable 建 立 
后 调用 ， 代 码 如 下 : 


public MainForm() 


“7/ 建立 一 个 数据 表 
CreateDataTable(); 


// 建立 一 个 视图 
CreateDataView(); 


} 

下 面 是 这 个 新 辅助 方法 的 实现 。 需 要 注意 的 是 ,我 们 把 DataTable 作 为 构造 参数 传人 DataView， 用 
来 建立 自 定义 数据 行 集合 : 

private void CreateDataView() 


// 设置 用 来 构建 这 个 视图 的 表 


yugosOnlyView = new DataView(inventoryTable); 


// 用 过 滤器 配置 这 个 视图 
yugosOnlyView.RowFilter = "Make = 'Yugo'"; 


// 绑 定 到 新 网 格 


dataGridYugosView.DataSource = yugosOnlyView; 


} 
可 见 ，DataView 类 支持 一 个 叫做 RowFilter 的 属性 ,用 来 设置 表示 筛选 标准 的 字符 串 ， 以 获得 匹配 
的 行 。 一 旦 建立 了 视图 ， 相 应 地 设置 网 格 的 DataSource 属 性 。 图 22-10 显 示 了 完整 的 程序 效果 。 
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图 22-10 显示 数据 的 唯一 视图 


源 代码 ” WindowsFormsDataBinding 项 目的 源 代码 位 于 Chapter 22 子 目录 下 。 


22.7 ”使 用 数据 适配器 


现在 知道 了 如 何 操作 ADO.NET DataSet 进 行 输入 输出 ,下 面 介绍 一 下 数据 适配器 对 象 。 数据 适配器 类 
用 来 向 DataSset 填 充 DataTable 并 把 修改 后 的 DataTable 返 回 数 据 库 处 理 。 表 22-8 列 举 了 一 些 DbDataAdapter 基 
类 的 核心 成 员 。 这 是 每 个 数据 适配器 对 象 的 公共 父 对 象 ( 例如 sqlDataAdapter 和 0dbcDataAdapter )。 


表 22-8 ”DbDataAdapter 类 的 核心 成 员 


成 员 作 用 
Fill() 执行 SQL SELECT 命令 ( 由 SelectCommand 属 性 指定 ) 查询 数据 库 并 将 数据 加 载 到 Data- 
Table 中 
SelectCommand 、 建立 用 于 Fil1() 和 Update() 方 法 的 由 数据 库 执 行 的 SQL 命令 
InsertCommand、 
UpdateCommand 和 
DeleteCommand 
Update() 执行 SQL INSERT、UPDATE 和 DELETE 命 令 ( 由 InsertCommand 、UpdateCommand 和 DeleteCommand 


属性 指定 来 持久 化 DataTable 修 改 到 数据 库 中 
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注意 数据 适配器 定义 了 4 个 属性 : SelectCommand、InsertCommand、UpdateCommand 和 DeleteCommand。 
如 果 我 们 为 某 个 数据 提供 程序 创建 数据 适配器 对 象 ( 如 SqlDataAdapter )， 我 们 就 可 以 传人 
SelectCommand 命 令 对 象 使 用 的 表示 命令 文本 的 字符 串 类 型 。 

如 果 4 个 命令 行 对象 都 被 正确 配置 了 ， 我们 就 可 以 调用 Fil1() 方 法 来 获取 DataSet ( 也 可 以 选择 一 
个 DataTable )。 这 可 以 通过 让 数据 适配器 执行 SelectCommand 属 性 指定 的 SQL SELECT 语句 来 实现 。 

同样 ， 如 果 我 们 希望 把 修改 后 的 DataSet (或 DataTable ) 对 象 传 回 数据 库 来 处 理 ， 我 们 就 可 以 调用 
Update() 方 法 ， 它 会 根据 DataTable 中 每 一 行 的 状态 来 使 用 其 他 命令 行 对 象 ( 稍 后 我 们 会 详细 介绍 ) 。 

使 用 数据 适配器 对 象 一 个 奇怪 的 方面 是 我 们 从 来 不 需要 打开 或 关闭 对 数据 库 的 连接 ， 因 为 对 数据 
库 的 基础 连接 会 自动 管理 。 然 而 ， 我 们 仍然 需要 为 数据 适配器 提供 有 效 的 连接 对 象 或 连接 字符 串 (在 
内 部 会 用 于 构建 连接 对 象 ) 来 通知 数据 适配器 我 们 希望 和 哪个 数据 库 进 行 通信 。 


说 明 数据 适配器 在 本 质 上 是 不 可 知 的 。 你 可 以 在 运行 时 传 入 不 同 的 连接 对 象 和 命令 对 象 ， 也 可 以 
从 各 种 各 样 的 数据 库 中 获取 数据 。 例 如 ，DataSet 可 以 包含 从 SQL Server、Oracle、MySQL 等 
数据 库 提 供 程序 中 得 到 的 表 数 据 。 


22.7.1 一 个 简单 的 数据 适配器 示例 


下 一 步 就 是 向 第 21 章 中 创建 的 数据 访问 库 程序 集 AutoLotDAL.dll 新 增 功能 。 首 先 创建 一 个 简单 的 
示例 ， 它 会 使 用 ADO.NET 数 据 适 配器 为 DataSet 填 充 一 个 表 。 

新 建 一 个 叫 FilDataSetUsingSqlDataAdapter 的 控制 台 应 用 程序 ， 并 且 把 System.Data 和 
System.Data.Sq1Client 命 名 空间 导 和 人 到 我 们 最 初 的 C# 代 码 文件 中 。 现 在 ， 如 下 更 新 Main() 方 法 (根据 
在 第 21 章 创建 AutoLot 数 据 库 的 方式 ， 可 能 需要 修改 连接 字符 串 ): 


static void Main(string[] args) 
Console.WriteLine("***** Fun with Data Adapters *****\n"); 


// 硬 编码 的 连接 字符 囊 
string cnStr = "Integrated Security = SSPI;Initial Catalog=AutoLot;" + 
@"Data Source=(local)\SQLEXPRESS"; 


// 调用 者 创建 DataSet 对 象 
DataSet ds = new DataSet("AutoLot"); 


// 告知 适配器 的 Select 命 令 文 本 和 连接 字符 事 
SqlDataAdapter dAdapt = 
new SqlDataAdapter("Select * From Inventory"”, cnStr); 


// 为 DataSet 填 充 一 个 叫 Inventory 的 新 表 
dAdapt .Fill(ds, "Inventory"); 


// 显示 DataSet 的 内 容 ， 使 用 本 章 前 面 创建 的 辅助 方法 
printDataSet (ds); 
Console.ReadLine(); 
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注意 ， 数 据 适配器 已 经 通过 指定 映射 到 SQL SELECT 语 句 的 字符 串 文 本 来 构建 。 这 个 值 会 被 用 来 在 
内 部 构建 命令 对 象 ， 之 后 可 以 通过 selectCommand 属 性 来 获取 这 个 命令 对 象 。 

接着 ， 注 意 调用 者 需要 自己 来 创建 Dataset 类 型 的 实例 ， 它 被 传人 到 Fill() 方 法 。Fill() 方 法 接受 可 选 
的 第 二 个 参数 ， 即 一 个 字符 串 ， 用 来 设置 新 DataTable 的 TableName 属 性 ( 如 果 我 们 不 指定 表 名 的 话 ， 
数据 适配器 会 将 表 命 名 为 Table ) 。 虽 然 大 多 数 情况 下 赋 给 DataTable 的 名 字 会 和 关系 数据 库 中 的 物理 
表 名 字 一 样 ， 但 这 不 是 必需 的 。 


说 明 Fill() 方 法 返回 一 个 整数 来 表示 由 SQL 查询 返回 的 行 数 。 


最 后 ， 注 意 在 Main() 方 法 中 我 们 没有 显 式 打开 或 关闭 对 数据 库 的 连接 。 某 个 数据 适配器 的 Fill1() 
方法 已 经 被 预 编 程 ， 它 将 在 从 Fil1() 方 法 返回 之 前 打开 然后 关闭 基础 连接 。 因 此 ， 当 我 们 把 DataSet 
传人 PrintDataSet() 方 法 时 ( 本章 之 前 实现 的 ) ， 只 是 操作 断 开 连接 的 数据 的 本 地 副本 ， 而 不 会 发 生 
获取 数据 的 往返 过 程 。 


22.7.2 ”映射 数据 库 名 称 为 友好 名 称 


前 面 提 到 过 数据 库 管 理 员 ( DBA ) 往往 会 用 简短 的 而 不 是 对 于 终端 用 户 来 说 友好 的 名 称 来 作为 表 
名 和 列 名 (如 au_id、au_fname 或 au_lname )。 幸 好 通过 TableMappings 属 性 能 访问 数据 适配器 对 象 保持 
的 System.Data.Common.DataTableMapping 类 型 的 一 个 内 部 强 命 名 的 集合 ( DataTableMa- 
ppingCollection )。 

如 果 这 么 做 的 话 ， 可 以 操作 这 个 集合 来 告诉 DataTable 哪 些 是 要 在 显示 内 容 的 时 候 使 用 “友好 名 ” 
的 。 比 如 ， 假 设 你 想 在 显示 的 时 候 把 数据 库 名 Inventory 映 射 到 Current Inventory， 显 示 CarID 列 名 为 
Car ID (注意 中 间 的 空格 )， 显 示 PetName 列 名 为 Name of Car。 要 实现 这 个 ， 需 要 在 调用 数据 适配器 的 
Fill() 方 法 以 前 加 入 下 面 的 代码 (确信 已 经 使 用 了 System.Data.Common 命 名 空间 来 获得 
DataTableMapping 类 型 的 定义 ): 


static void Main(string[] args) 


// 现在 映射 列 名 到 一 个 用 户 友 好 的 名 字 
DataTableMapping custMap = 

dAdapt. TableMappings.Add("Inventory", "Current Inventory"); 
custMap.ColumnMappings.Add("CarID", "Car ID"); 
custMap.ColumnMappings.Add("PetName", "Name of Car"); 
dAdapt .Fill(ds, "Inventory"); 


如 果 再 次 运行 这 个 程序 的 话 , 会 发 现 PrintDataSet() 方 法 现在 为 DataTable 和 DataRow 对 象 显示 “ 友 
好 名 ”而 不 是 数据 库 结构 的 名 字 : 


SOOO 


**A*** Fun With Data Adapters ***** 


DataSet is named: AutoLot 
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=> Current Inventory Table: 
Car ID Make Color Name of Car 


678 Yugo Green Clunker 
904 VW Black Hank 
1000 BMW Black Bimmer 
1001 BMW Tan Daisy 
1992 Saab Pink Pinkey 
2003 Yugo Rust Mel 


源 代 码 ”FillDataSetUsingSqlDataAdapter 项 目的 源 代码 位 于 Chapter 22 子 目录 下 。 
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为 了 演示 使 用 数据 适配器 将 DataTable 中 的 修改 发 回 到 数据 库 处 理 的 过 程 ,我 们 现在 更 新 第 21 章 中 
创建 的 AutoLotDAL.dll 程 序 集 来 包含 新 的 命名 空间 AutoLotDisconnectedLayer。 这 个 命名 空间 会 包含 一 
个 叫 InventoryDALDisLayer 的 新 类 ， 它 会 使 用 数据 适配器 来 和 DataTable 交 互 。 

一 个 比较 好 的 方法 是 ， 将 第 21 章 创建 的 AutoLotDAL 项 目 所 在 的 文件 夹 整个 复制 到 硬盘 中 新 的 位 
置 ， 并 将 文件 夹 重 命名 为 AutoLotDAL(Version Two) 。 现 在 使 用 Visual Studio ， 激 活 File 一 Open 
Project/Solution... 菜 单 选项 ， 打 开 AutoLotDAL (Version Two) 文 件 夹 下 的 AutoLotDAL.sln 文 件 。 


22.8.1 定义 初始 类 类 型 

通过 Project 一 Add Class 菜 单项 插入 一 个 叫 InventoryDALDisLayer 的 新 类 ， 并 且 确 保 在 新 的 代码 文 
件 中 有 一 个 公共 类 类 型 。 

修改 包括 这 个 类 的 命名 空间 为 AutoLotDisconnetedLayer 并 且 导 和 System.Data 和 System.Data. 
SqlClient 命 名 空间 。 

和 与 连接 相关 的 InventoryDAL 类 型 不 同 的 是 ， 新 的 类 不 需要 提供 自 定义 打开 /关闭 方法 ， 因 为 数据 
适配器 会 自动 处 理 这 些 细节 。 

首先 ， 增 加 一 个 自 定义 构造 函数 来 设置 一 个 表示 连接 字符 串 的 私有 string 变 量 。 同 样 ， 定 义 一 个 
私有 的 SqlDataAdapter 成 员 变量 , 我们 会 通过 ConfigureAdapter() 辅 助 方 法 ( 还 没有 创建 ) 来 配置 ， 它 
接受 SqlDataAdapter 输 出 参数 : 

namespace AutoLotDisconnectedLayeT 


public class InventoryDALDisLayer 


// 字段 数据 
private string cnString = string.Empty; 
private SqlDataAdapter dAdapt = null; 


public InventoryDALDisLayer(string connectionString) 
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cnString = connectionString; 


// 配置 SqlDataAdapter 
ConfigureAdapter(out dAdapt); 


} 
} 


22.8.2 ”使 用 SqlCommandBuilder 来 配置 数据 适配器 


使 用 数据 适配器 来 修改 Dataset 中 的 表 时 ， 第 一 件 事情 就 是 为 UpdateCommand、DeleteCommand 以 及 
InsertCommand 属 性 赋予 有 效 的 命令 对 象 ( 在 这 样 做 之 前 ， 这 些 属性 都 会 返回 nul1 引 用 )。 

为 InsertCommand、UpdateCommand 和 DeleteCommand 属 性 手工 配置 命令 对 象 需要 大 量 的 代码 ， 特 别 
是 在 我 们 使 用 参数 化 查询 的 时 候 。 第 21 章 中 说 过 ， 参 数 化 查询 允许 我 们 使 用 一 组 参数 对 象 构建 SQL 语 
句 。 因 此 ， 如 果 和 希望 自己 走 这 条 路 的 话 ， 可 以 手动 创建 3 个 SqlCommand 对 象 来 实现 ConfigureAdapter()， 

一 个 对 象 都 包含 一 组 SqlParameter 对象 。 然 后 ,我 们 就 可 以 把 这 些 对 象 设 置 为 适配器 的 

UpdateCommand、DeleteCommand 和 InsertCommand 属 性 。 

值得 庆幸 的 是 , Visual Studio 提供 了 许多 设计 器 工具 来 为 我 们 处 理 这 些 没 有 技术 含量 而 又 枯燥 
的 工作 。 这 些 设计 器 因 所 使 用 的 API 不 同 ( 如 Windows Forms 、WPF 、ASP.NET ) 而 有 所 区 别 ， 但 
整体 的 功能 是 类 似 的 。 使 用 这 些 设 计 器 的 示例 将 贯穿 本 书 ， 包 括 本 章 稍 后 将 使 用 的 Windows Forms 
设计 器 。 

不 必 编 写 大 量 代码 语句 来 完整 配置 数据 适配器 ， 让 我 们 按 如 下 代码 实现 ConfigureAdapter() 来 精 
简 大 量 的 工作 : 

private void ConfigureAdapter(out SqlDataAdapter dAdapt) 


{ 
// 创建 适配器 并 且 设 置 SelectCommand 
dAdapt = new SqlDataAdapter("Select * From Inventory", cnString); 


// 使 用 SqlCommandBuilder 在 运行 时 动态 获取 其 余 的 命令 对 象 
SqlCommandBuilder builder = new SqlCommandBuilder(dAdapt); 


为 了 帮助 简化 数据 适配器 对 象 的 构建 ,微软 提供 的 每 一 个 ADO.NET 数 据 提 供 程序 都 提供 了 一 个 命 
令 生 成 器 类 型 。sqlCommandBuilder 类 型 根据 最 初 的 SelectCommand 自 动 生 成 包含 在 SqlDataAdapter 的 
InsertCommand、UpdateCommand 和 DeleteCommand 属 性 中 的 值 。 很 明显 ， 好 处 是 我 们 不 需要 手动 构建 所 
有 的 SqlCommand 和 SqlParameter 类 型 。 

这 个 时 候 一 个 很 明显 的 问题 是 命令 生成 器 如 何 能 即时 构建 这 些 SQL 命 令 对 象 。 简 洁 的 答案 就 是 利 
用 元 数据 。 在 运行 时 ， 如 果 我 们 调用 数据 提供 程序 的 Update() 方 法 ， 相 关 命 令 生成 器 会 读 取 数 据 库 的 
构架 数据 来 自动 生成 底层 的 插入 、 删 除 和 更 新 命令 对 象 。 

显然 ， 这样 做 的 话 会 产生 对 远程 数据 库 的 额外 往返 ， 因 此 在 一 个 应 用 程序 中 多 次 使 用 
SqlCommandBuilder 的 话 ， 肯 和 定 会 有 损 性 能 。 在 这 里 ， ee ee 
候 调 用 ConfigureAdapter() 方 法 来 最 小 化 负面 效果 , 这 样 配置 后 的 SqlDataApter 就 会 在 整个 对 象 的 生命 
周期 中 保留 下 来 。 
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在 之 前 的 代码 中 ,除了 作为 构造 函数 参数 传人 数据 适配器 以 外 ,我 们 并 没有 使 用 命令 生成 器 对 象 
(在 这 里 的 SqlCommandBuilder ) 。 可 能 看 上 去 很 奇怪 ， 这 就 是 我 们 需要 做 的 所 有 工作 吗 ? 在 背后 ， 这 
个 类 型 会 使 用 其 余 的 命令 对 象 配置 数据 适配器 。 

现在 ， 虽 然 你 可 能 喜欢 上 了 这 个 “空手 套 白 狼 ”的 主意 ， 但 是 要 知道 命令 生成 器 有 很 多 关键 的 限 
制 。 具 体 而 言 ， 命 令 生 成 器 只 能 在 如 下 条 件 是 true 的 时 候 才 自动 生成 用 于 数据 适配器 的 SQL 命令 。 

口 SQL SELECT 命令 必须 和 单个 表 交 互 〈 比 如 没有 联接 ) 。 

口 这 是 一 个 必须 有 主键 的 表 。 

口 这 个 表 必 须 有 表示 主键 的 列 并 且 必 须 包含 在 我 们 的 SQL SELECT 语句 中 。 

根据 我 们 构建 的 AutoLot 数 据 库 ， 这 些 限 制 都 没有 问题 ， 然 而 ， 在 一 个 工业 强度 更 大 的 数据 库 中 ， 
我 们 需要 考虑 这 个 类 型 是 否 有 用 ( 如 果 没 有 用 的 话 ，Visual Studio 会 自动 生成 大 量 需 要 的 代码 ， 在 本 
章 后 面 我 们 会 看 到 ) 。 


22.8.3 ”实现 GetAllInventory() 


既然 数据 适配器 已 经 准备 好 了 , 新 类 类 型 的 第 一 个 方法 只 需要 使 用 SqlDataAdapter 对 象 的 Fil1() 方 法 
来 获取 表示 AutoLot 数 据 库 中 Inventory 表 所 有 记录 的 DataTable， 如 下 所 示 : 

public DataTable GetAllInventory() 

{ 


DataTable inv = new DataTable("Inventory"); 
dAdapt .Fill(inv); 
return inv; 


22.8.4 ”实现 UpdateInventory() 
UpdateInventory() 方 法 很 简单 : 


public void UpdateInventory(DataTable modifiedTable) 


dAdapt .Update(modifiedTable); 


在 这 里 ,数据 适配器 对 象 会 检查 传人 DataTable 每 行 的 RowState 值 。 根 据 这 个 值 ( RowState.Added、 
RowState.Deleted、RowState.Modified ) 在 后 台 使 用 正确 的 命令 对 象 。 


22.8.5 “设置 版 本 号 
至 此 ， 数 据 访 问 库 第 二 个 版 本 的 逻辑 部 分 已 经 全 部 完成 。 你 可 以 将 该 库 的 版 本 号 设 为 2.0.0.0， 尽 


管 这 不 是 必需 的 , 但 这 样 做 是 一 个 很 好 的 习惯 。 如 第 14 章 所 述 ， 要 修改 .NET 程 序 集 的 版 本 ,可 以 双击 
Solution Explorer 中 的 Properties 节 点 ， 然 后 单 击 Application 选 项 卡 中 的 Assembly Information... 按 钮 。 在 
弹出 的 对 话 框 中 ， 将 Assembly Version 的 Major 号 〈 主 版 本 号 ) 设置 为 2 (详细 内 容 参考 第 14 章 )。 完 成 


之 后 ， 重 新 编译 应 用 程序 以 更 新 程序 集 清单 。 


源 代 码 ”AutoLotDAL (Version Two) 项 目的 源 代码 位 于 Chapter 22 子 目录 下 。 
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22.8.6 测试 非 连接 的 功能 
这 时 我 们 可 以 构建 一 个 前 端 来 测试 新 的 InventoryDALDisLayer 类 。 我 们 仍然 使 用 Windows Forms 
API 在 图 形 用 户 界面 上 显示 数据 。 新 建 一 个 Windows Forms 应 用 程序 InventoryDALDisconnectedGUTI， 
使 用 Solution Explorer 将 初始 的 Forml.cs 文 件 改 为 MainForm.cs， 然后 添加 对 新 的 AutoLotDAL.dll 程 序 集 
的 引用 (要 确保 所 添加 的 是 2.0.0.0 版 )， 并 引入 下 面 的 命名 空间 : 
using AutoLotDisconnectedLayer; 
表单 的 设计 包含 一 个 Label、DataGridView ( 叫 inventoryGrid ) 和 Button 控 件 ( 叫 btnUpdateInven- 
tory， 我 们 将 它 配置 为 处 理 Click 事 件 ) 。 下 面 是 表单 的 定义 : 
public partial class MainForm : Form 
InventoryDALDisLayer dal = null; 
public MainForm() 
InitializeComponent(); 
string cnStr = 


@"Data Source=(local)\SQLEXPRESS; Initial Catalog=AutoLot;" + 
"Integrated Security=True;Pooling=False"; 


// 创建 数据 访问 对 象 
dal = new InventoryDALDisLayer(cnStr); 


// 填充 网 格 
inventoryGrid.DataSource = dal.GetAllInventory(); 


} 


private void btnUpdateInventory Click(object sender, EventArgs e) 


// 从 网 格 获取 修改 后 的 数据 
DataTable changedDT = (DataTable)inventoryGrid.DataSource; 


try 


{ 
// 提交 我 们 的 改动 
dal.UpdateInventory(changedDT); 


} 
catch(Exception ex) 
MessageBox.Show(ex.Message); 


} 
} 


创建 了 InventoryDALDisLayer 对 象 之 后 ， 将 从 GetAllInventory() 返 回 的 DataTable 绑 定 到 
DataGridView 对 象 。 如 果 用 户 单 击 了 Update 按 钮 ,我 们 就 从 网 格 (通过 DataSource 属 性 ) 提取 修改 后 的 
DataTable 并 且 把 它 传人 UpdateInventory() 方 法 。 

就 这 么 简单 ! 运行 程序 后 , 增加 一 组 新 行 到 网 格 上 并 且 更 新 /删除 另外 一 些 。 如 果 单 击 Button 控 件 ， 
就 会 看 到 这 些 改动 持久 化 到 了 AutoLot 数 据 库 中 。 
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源 代码 ”更 新 后 的 InventoryDALDisconnectedGUI 项 目的 源 代码 位 于 Chapter 22 子 目录 下 。 
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当前 ， 本 章 所 有 涉及 DataSet 的 例子 都 只 包含 一 个 DataTable 对 象 。 然 而 ， 当 一 个 DataSet 对 象 包含 
数 个 关联 的 DataTable 的 时 候 才 是 发 挥 断 开 式 访问 强大 力量 的 时 刻 。 既 然 这 样 ， 我 们 就 能 把 任意 多 的 
DataRelation 对 象 插入 到 DataSet 的 DataRelation 集 合 中 去 ， 来 表示 数据 表 之 间 的 依赖 关系 。 使 用 这 些 
对 象 ， 客 户 端 就 能 自由 使 用 这 些 表 ， 避 人 免 了 不 必要 的 网 络 流量 。 


说 明 这 个 示例 把 数据 访问 还 辑 隔离 到 了 一 个 新 的 Windows Forms 项 目 ( 而 不 是 更 新 AutoLotDAL.dll ) 
来 处 理 Customers 和 0rders 表 。 然 而 ， 对 于 产品 级 别 的 应 用 程序 来 说 ， 不 推荐 把 UI 和 数据 访问 
逻辑 混合 在 一 起 。 本 章 最 后 的 示例 利用 了 各 种 数据 库 设 计 工 具 来 解 耦 UI 和 数据 逻辑 代码 。 


我 们 新 建 一 个 叫做 MultitabledDataSet 的 WindowsForms 应 用 程序 。 用 户 界 面 非常 简单 ( 注意 我 将 原 
始 的 Forml.cs 改 名 为 MainForm.cs )。 在 图 22-11 中 ， 你 能 看 到 3 个 DataGridview 部 件 〈 dataGridView- 
Inventory 、dataGridViewCustomers 和 dataGridViewOrders ) 显示 从 AutoLot 数 据 库 中 Inventory 、 
Customers 和 0rders 这 3 个 表 取 得 的 数据 。 另 外 ， 还 有 一 个 名 为 btnUpdateDatabase 的 Button 通 过 数据 适 
配器 对 象 把 所 有 的 修改 结果 返回 到 数据 库 处 理 。 


MainForm.cs fDesignj” 2 Xx 





图 22-11 初始 UI 显示 从 AutoLot 数 据 库 的 每 个 表 中 获得 的 数据 
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22.9.1 建立 数据 适配器 


为 了 简单 起 见 ，MainForm 还 是 使 用 命令 构建 器 对 象 来 为 3 个 SqlDataAdapter ( 每 个 表 一 个 ) 自动 生 
成 SQL 命令 。 这 里 是 Form 继 承 的 类 型 的 最 初 实现 (不 要 忘记 导 和 人 System.Data.5qlclient 命 令 空间 ): 


public partial class MainForm : Form 


// 窗 体 级 别 的 DataSet 
private DataSet autoLotDS = new DataSet("AutoLot"); 


// 使 用 命令 构建 器 来 简化 数据 适配器 的 配置 
private SqlCommandBuilder sqlCBInventory; 
private SqlCommandBuilder sqlCBCustomers; 
private SqlCommandBuilder sqlCBOrders; 


// 我 们 的 数据 适配器 (对 于 每 个 表 ) 

private SqlDataAdapter invTableAdapter; 
private SqlDataAdapter custTableAdapter; 
private SqlDataAdapter ordersTableAdapter; 


// 窗 体 级 别 的 连接 字符 囊 


private string cnStr = string.Empty; 


在 窗 体 的 构造 函数 内 我 们 做 一 些 乏 味 的 操作 : 建立 一 些 数据 相关 的 成 员 变 量 并 且 填 充 Dataset。 假 
设 这 里 编写 了 一 个 包含 正确 的 连接 字符 串 数据 的 App.config 文 件 ( 并 引用 了 System.Configuration.dll 和 
命名 空间 System.Configuration )， 例 如 : 


<configuration> 
<connectionStrings> 
<add name ="AutoLotSqlProvider" connectionString = 
"Data Source=(local)\SQLEXPRESS; 
Integrated Security=SSPI;Initial Catalog=AutoLot" 
/> 
</connectionStrings> 
</configuration> 


同样 注意 ， 这 里 使 用 了 一 个 私有 的 辅助 方法 BuildTableRelationship()， 代 码 如 下 : 


public MainForm() 
InitializeComponent(); 


// 从 *.config 文 件 中 提取 连接 字符 事 

cnStr = 
ConfigurationManager.ConnectionStrings[ 
"AutoLotSqlProvider"].ConnectionString; 


// 建立 数据 适配器 

invTableAdapter = new SqlDataAdapter("Select * from Inventory", cnStr); 
custTableAdapter = new SqlDataAdapter("Select * from Customers", cnStr); 
ordersTableAdapter = new SqlDataAdapter("Select * from Orders", cnStr); 


// 自动 生成 命令 
sqlCBInventory = new SqlCommandBuilder(invTableAdapter); 
sqlCBOrders = new SqlCommandBuilder(ordersTableAdapter); 
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sqlCBCustomers = new SqlCommandBuilder(custTableAdapter); 


// 在 DS 中 填充 表 
invTableAdapter.Fill(autoLotDS, "Inventory"); 
custTableAdapter.Fill(autoLotDS, "Customers"); 
ordersTableAdapter.Fill(autoLotDS, "Orders"); 


// 为 表 间 建立 关系 
BuildTableRelationship(); 


// 绑 定 到 网 格 

dataGridViewInventory.DataSource = autoLotDS.Tables["Inventory"] ; 
dataGridViewCustomers.DataSource = autoLotDS.Tables["Customers"]; 
dataGridViewOrders.DataSource = autoLotDS.Tables["Orders"]; 


| 22 
22.9.2 ”建立 表 间 关系 


BuildTableRelationship() 辅 助 方法 将 两 个 DataRelation 对 象 添加 到 autoLotDs 对 象 。 第 21 章 说 过 
AutoLot 数 据 库 表示 一 组 父子 关系 ， 下 面 是 具体 实现 ; 


private void BuildTableRelationship() 


// 建立 CuUstomer0rder 数 据 关系 对 象 

DataRelation dr = new DataRelation("CustomerOrder", 
autoLotDS.Tables["Customers"].Columns["CustID"], 
autoLotDS. Tables["Orders"].Columns["CustID"]); 

autoLotDS.Relations.Add(dr); 


// 建立 InventoryOrder 数 据 关 系 对 象 

dr = new DataRelation("InventoryOrder", 
autoLotDS. Tables["Inventory"].Columns["CarID"], 
autoLotDS. Tables["Orders"].Columns["CarID"]); 

autoLotD9.Relations.Add(dr); 


注意 ， 在 创建 DataRelation 对 象 的 时 候 ， 我 们 使 用 第 一 个 参数 来 创建 友好 的 字符 串 友 好 名 ( 稍 后 
我 们 会 看 到 这 么 做 的 好 处 )， 并 且 指 定 用 于 构建 关系 本 身 的 键 。 注 意 父 表 (第 二 个 构造 函数 参数 ) 在 
子 表 (第 三 个 构造 函数 参数 ) 之 前 指定 。 


22.9.3 ”更 新 Database 表 


现在 已 经 填充 了 Dataset 对 象 并 且 从 数据 源 断 开 ， 我 们 能 在 本 地 操作 每 个 DataTable。 随 意 在 3 个 
DataGridView 上 增加 、 更 新 或 者 删除 值 ， 当 需要 提交 回 数据 源 处 理 的 时 候 , 单 击 表单 上 的 Update 按 钮 。 
Click 事 件 的 代码 如 下 : 


private void btnUpdateDatabase Click(object sender, EventArgs e) 


{ 
try 
{ 
invTableAdapter.Update(autoLotDS, "Inventory"); 


custTableAdapter.Update(autoLotDS, "Customers"); 
ordersTableAdapter.Update(autoLotDS, "Orders"); 


catch (Exception ex) 
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MessageBox.Show(ex.Message); 


—_ 


运行 应 用 程序 并 执行 各 个 更 新 。 当 重新 运行 应 用 程序 时 ,我 们 会 发 现 每 一 个 网 格 都 填充 了 最 新 的 
修改 。 
22.9.4 在 关联 表 中 切换 


为 了 演示 DataRelation 怎 么 以 编程 方式 实现 表 之 间 的 切换 ， 我 们 扩展 UI， 新 增 一 个 名 为 btnGet- 
OrderInfo 的 Button 类 型 、 一 个 相关 的 文本 框 txtcustID 和 一 个 描述 性 标签 Label (为 了 可 见 ， 将 这 些 控 
件 放 到 GroupBox 中 )。 图 22-12 显 示 了 这 个 应 用 程序 可 能 的 UI。 


MainForm,cs [Design] + Xx 





串 


A 


| 4 ls 


图 22-12 更 新 后 的 UI 允许 用 户 查 找 客户 订单 信息 


使 用 这 个 更 新 后 的 UI， 最 终 用 户 就 可 以 输入 客户 的 ID 并 且 获 取 客 户 订单 的 所 有 相关 信息 ( name、 
order、car order 等 ) 。 它们 会 被 格式 化 成 string 类 型 并 最 终 显示 在 消息 框 中 。 考虑 如 下 新 按钮 的 Click 
事件 处 理 程序 : 


private void btnGetOrderInfo Click(object sender, System.EventArgs e) 
{ 


string strOrderInfo = string.Empty; 
DataRow[] drsCust = null; 
DataRow[] drsOrder = null; 


// 从 文本 框 得 到 客户 的 ID 
int custID = int.pParse(this.txtCustID.Text); 


// 根据 custID 从 Customers 表 得 到 相应 行 

drsCust = autoLotDS.Tables["Customers"].Select( 
string.Format("CustID = {0}", custID)); 

strOrderInfo += string.Format("Customer {0}: {1} {2}\n", 
drsCust[0]["CustID"].ToString(), 
drsCust[0]["FirstName"].ToString(), 
drsCust[0]["LastName"].ToString()); 
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// 从 Customers 表 切换 到 0rders 表 
drsOrder = drsCust[0] .GetChildRows(autoLotDS.Relations["CustomerOrder" ]); 


// 为 该 客户 循环 所 有 订单 
foreach (DataRow order in drsOrder) 


strOrderInfo += string.Format("----\nOrder Number: 
{0}\n", order["OrderID"]); 


// 通过 订单 得 到 Car 的 引用 
DataRow[] drsInv = order.GetParentRows(autoLotDS.Relations[ 
"InventoryOrder"]); 


// 得 到 该 订单 中 的 (单个) Car 信息 

DataRow car = drsInv[0]; 

strOrderInfo += string.Format("Make: {0}\n", car["Make"]); 
strOrderInfo += string.Format("Color: {0}\n", car["Color"]); 
strOrderInfo += string.Format("Pet Name: {0}\n", car["PetName"]); 


} 
MessageBox.Show(strOrderInfo, "Order Details"); 


图 22-13 显 示 了 当 指 定 客户 ID 为 3 时 可 能 的 输出 ( 由 于 你 的 AutoLot 数 据 库 表 中 的 数据 可 能 与 我 的 不 
同 ， 因 此 结果 也 会 不 一 样 )。 





Customer 3: Steve Hagen 





| Order Number 1002 
引 Make: Yugo 
Color: Yellow 
I Pet Name: Clunker 
















图 22-13 ”使 用 数据 关系 导航 
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希望 这 最 后 的 例子 能 让 你 确信 DataSet 类 有 多 么 有 用 。 既 然 Dataset 是 完全 和 基层 数据 源 断 开 的 ， 
我 们 就 可 以 使 用 在 内 存 中 的 这 么 一 个 副本 在 各 个 表 中 切换 并 做 必要 的 修改 、 删 除 和 插入 操作 。 操 作 结 
束 后 ， 就 把 这 些 改变 提交 给 数据 库 去 处 理 。 最 终 的 结果 是 一 个 可 扩展 的 、 健 壮 的 应 用 程序 。 


源 代码 ”MoultitabledDataSetApp 项 目的 源 代 码 位 于 Chapter 22 子 目录 下 。 


22.10 Windows Forms 数据 库 设 计 器 工具 


至 此 ,本 书 中 所 有 的 示例 都 包含 了 大 量 的 体力 活 ， 因 为 我 们 都 是 手动 写 的 这 些 数据 访问 逻辑 。 虽 
然 我 们 把 大 量 的 代码 放 到 .NET 类 库 中 ( AutoLotDAL.dll ) 来 让 书 中 后 面 的 章节 进行 重用 ， 在 和 关系 数 
据 库 交互 之 前 我 们 仍然 需要 手动 为 我 们 的 数据 适配器 创建 各 种 对 象 。 

本 章 接 下 来 将 介绍 如 何 使 用 不 同 的 Windows Forms 数 据 库 设 计 器 工具 ， 来 为 我 们 生成 大 量 的 数据 
访问 代码 。 





说 明 WPF 和 ASPNET Web 项 目 包 含 类 似 的 数据 库 设 计 器 工具 ， 本 章 稍 后 将 介绍 它们 。 


使 用 Windows Forms 中 DataGridview 控 件 所 支持 的 设计 器 , 是 这 些 集成 工具 的 一 种 用 法 。 但 这 种 方 
法 的 问题 是 ， 数 据 库 设计 器 工具 将 把 所 有 的 数据 访问 代码 直接 内 艇 到 GUI 代码 库 内 。 理 想 情况 下 ， 应 
该 把 所 有 这 些 设计 器 生成 的 代码 隔离 到 单独 的 .NET 代 码 库 中 , 这 样 就 可 以 在 多 个 项 目 中 轻松 地 复 用 这 
些 数 据 库 访问 逻辑 。 

不 过 ,由 于 这 个 方法 在 一 些小 型 项 目 和 应 用 程序 原型 中 还 是 很 有 用 的 ， 因 此 我 们 先 来 研究 如 何 使 
用 DataGridView 控 件 生成 需要 的 数据 访问 代码 。 然 后 ， 我 们 将 学 习 如 何在 第 3 版 的 AutoLot.dll 中 隔离 相 
同 的 设计 器 生成 的 代码 。 


22.10.1 可视化 设计 DataGridView 


DataGridview 控 件 有 相关 的 向 导 ， 可 以 为 我 们 生成 数据 访问 代码 。 首 先 ， 创 建 一 个 叫 
DataGridViewDataDesigner 的 全 新 Windows Forms 应 用 程序 项 目 。 使 用 Solution Explorer 重 命名 表单 为 
MainForm.cs, 然后 添加 DataGridView 控 件 的 实例 inventoryDataGridView 到 表单 中 ,在 选中 DataGridView 
控件 后 ,在 UI 控件 的 右边 应 该 有 一 个 内 联 编辑 器 ( 如 果 没 有 , 点 击 控件 右上 角 的 小 三 角 图 标 )。 从 Choose 
Data Source 下 拉 框 中 选择 Add Project Data Source 链 接 ， 如 图 22-14 所 示 。 

数据 源 配置 向 导 启 动 了 。 这 个 工具 会 通过 一 系列 步骤 引导 我 们 选择 和 配置 数据 源 ， 然 后 就 会 使 用 
自 定 义 的 数据 适配器 类 型 绑 定 到 DataGridview。 向 导 的 第 一 步 只 是 询问 我 们 希望 和 哪 种 类 型 的 数据 源 
进行 交互 。 选 择 Database ( 如 图 22-15 所 示 ) ， 然 后 单 击 Next 按 钮 。 

第 二 步 ( 可 能 会 因 第 一 步 中 选择 的 不 同 而 稍微 有 一 点 不 同 ) 询问 我 们 是 希望 使 用 Dataset 数 据 库 模 
型 还 是 Entity 数 据 模型 。 确 保 选 择 Dataset 数 据 库 模 型 ( 如 图 22-16 所 示 )， 因 为 你 还 没有 学 习 Entity 框 架 
(下 一 章 会 详细 介绍 )。 


22.10 ”Windows Forms 数据 库 设 计 器 工具 737 











ccnnect to data. 


| 
BAddProjectDatasourcse | | 
Click the ‘Add Project 小 Source.. linkto 

| 





图 22-14 ”DataGridView 编 辑 器 


日 图 一 Choose a Data Source Type 





| Where will the application get data from? 


| Service Object SharePoint 








Lets you connect to a database and choose the database objects foryour application. 





图 22-15 ”选择 数据 源 类 型 


第 三 步 允 许 我 们 配置 数据 库 连 接 。 如 果 数 据 库 现在 已 经 加 到 了 服务 器 资源 管理 器 中 ， 我 们 就 可 
以 在 下 拉 列 表 中 发 现 它 自动 列 出 了 。 如 果 不 是 这 样 的 话 (或 如 果 你 需要 连接 一 个 之 前 没有 加 到 服务 
器 资源 管理 器 中 的 数据 库 ) ， 单 击 New Connection 按 钮 。 图 22-17 显 示 了 选择 AutoLot 本 地 实例 后 的 
结果 。 
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: 
| What type of database model do you want to use? 


图 ” 介 


Dataset Entity Data 
Model 


: 国 - Choose a Database Model 


The database model you choose deterrnines the types of data objects your spplication code uses, A dataset fije Wi 让 
be added to your project, 





| 图 一 Choose Your Data Connection 
| 汐 





| Which data connection shouid your application use to connect to the database? 
| .manyuandrew-pe\sqlepressAutoLotidbo 








| 他) Connection string that you will save in the application (expand to see details) 


Data Source= (local}\SQLEXPRESS,Initial Catalog=AutoLotIntegrated Security= True 








在 向 导 的 下 一 步 ,， 你 将 被 询问 是 否 希 望 将 连接 字符 串 保 存 到 应 用 程序 配置 文件 。 这 里 没有 给 出 截 
屏 ， 你 应 该 选择 保存 连接 字符 串 ， 然 后 点 击 Next 按 钮 。 

最 后 一 步 就 是 选择 将 由 自动 生成 的 DataSet 和 相关 数据 适配器 处 理 的 数据 库 对 象 。 虽然 我 们 可 以 
选择 AutoLost 数 据 库 的 所 有 数据 对 象 , 但 在 这 里 我 们 只 关心 Inventory 表 。 因 此 , 把 DataSet 的 建议 名 修 
改 为 InventoryDataSet ( 如 图 22-18 所 示 )， 检 查 Inventory 表 ， 然 后 单 击 Finish 按 钮 。 
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国 -， Choose Your Database Objects 
‘me | 


Stored precedures 


GetPetName 
Functions 


| InventoryDataSet 











图 22-18 ”选择 Inventory 表 
完成 之 后 ， 我 们 就 会 注意 到 可 视 化 设计 器 很 多 地 方 都 更 新 了 。 最 值得 注意 的 就 是 DataGridyiew 显 
示 了 Inventory 表 的 构架 ， 如 列 头 所 显示 的 那样 。 同 样 ， 在 表单 设计 器 的 底部 ( 在 组 件 托盘 区 域 )， 我 
们 会 看 到 3 个 组 件 : DataSet 组 件 、BindingSource 组 件 和 TableAdapter 组 件 (如 图 22-19 所 示 )。 
至 此 ， 我 们 就 可 以 运行 应 用 程序 并 且 可 以 看 到 ， 网 格 已 经 填充 了 Inventory 表 的 记录 ， 当 然 ， 这 并 
不 神奇 。IDE 已 经 为 我 们 编写 了 大 量 代码 并 建立 了 网 格 控件 。 下 面 让 我 们 深入 探讨 这 些 自动 生成 的 代码 。 


MainForm.cs[Design >X 














9 一 se 
Wi inventoryDataSat Py inventoryBindingSource 器 inventoryTableAdapter 


图 22-19 运行 了 数据 源 配置 向 导 之 后 的 Windows Forms 项 目 
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22.10.2 ”生成 的 App.config 文 件 


如 果 研 究 解决 方案 资源 管理 器 ， 就 会 发 现 我 们 的 项 目 现在 包含 了 App.config 文 件 ， 其 中 包括 一 个 
名 字 有 点 奇怪 的 <connectionStrings> 元 素 ， 如 下 所 示 : 
<?xm] version="1.0" encoding="utf-8" ?> 
<configuration> 
<configSections> 
</configSections> 
<connectionStrings> 
<add name="DataGridViewDataDesigner.Properties.Settings.AutoLotConnectionString" 
connectionString= 
"Data Source=(local)\SQOLEXPRESS; 
Initial Catalog=AutoLot;Integrated Security=True" 
providerName="System.Data.SqlClient” /> 
</connectionStrings> 
</configuration> 


自动 生成 的 数据 适配器 对 象 ( 稍 后 会 详细 介绍 ) 使 用 DataGridViewDataDesigner.Properties. 
Settings.AutoLotConnection string 这 个 值 。 


22.10.3” 强 类 型 的 DataSet 


除了 配置 文件 ， 向 导 工 具 还 生成 了 强 类 型 的 Dataset。 它 扩展 了 Dataset， 公 开 了 一 些 成 员 ， 这 些 
成 员 允 许 你 使 用 更 为 直观 的 对 象 模 型 与 数据 库 进 行 交互 。 例如 , 强 类 型 的 Dataset 对 象 包含 直接 映射 到 
数据 库 表 名 的 属性 。 因 此 ， 可 以 使 用 Inventory 属 性 直接 获取 行 和 列 ， 而 不 必 使 用 Tables 属 性 访问 表 的 
集合 了 。 首 先 ， 通 过 选择 Solution Explorer 中 的 项 目 图 标 并 且 单 击 View Class Diagram 按 钮 来 向 我 们 的 
项 目 插入 一 个 新 的 类 图 文件 。 注 意 ， 向 导 根 据 我 们 的 输入 新 建 了 一 个 InventoryDataSet 类 。 这 个 类 定 
义 了 很 多 成 员 ， 其 中 最 重要 的 就 是 一 个 叫 Inventory 的 属性 ( 如 图 22-20 所 示 )。 
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图 22-20 ”数据 源 配置 向 导 创 建 了 一 个 强 类 型 的 Dataset 
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如 果 我 们 在 Solution Explorer 中 双击 InventoryDataSet.xsd 文 件 ， 就 会 加 载 Visual Studio Dataset 设 计 
器 ( 稍 后 会 说 这 个 设计 器 的 详细 内 容 )。 如 果 右 击 设计 器 的 任何 地 方 并 且 选 择 View Code 选 项 ， 就 会 发 
现 如 下 所 示 的 空 的 分 部 类 定义 : 


public partial class InventoryDataSet { 


如 果 需 要 , 可 以 在 这 个 分 部 类 中 添加 自 定义 成 员 。 但 是 真正 的 行为 发 生 在 设计 器 维护 的 Inventory- 
DataSet.Designer.cs 文 件 中 。 在 Solution Explorer 中 打开 该 文件 ,会 发 现 InventoryDataSet 扩 展 了 DataSet 
父 类 。 考 虑 如 下 加 上 注释 的 分 部 代码 : 

// 这 是 设计 器 生成 的 所 有 代码 

-a partial class InventoryDataSet : global::System.Data.DataSet 


// InventoryDataTable 类 型 的 成 员 变 量 
private InventoryDataTable tableInventory; 


// 每 一 个 构造 函数 调用 了 一 个 叫做 InitClass() 的 辅助 方法 
public InventoryDataSet() 


{ 

”this.InitClass(); 

和 

// InitClass() 准 备 了 DataSet 并 且 把 InventoryDataTable 添 加 到 了 Tables 集 合 中 


private void InitClass() 


this.DataSetName = "InventoryDataSet"; 
this.Prefix = ""; 
this.Namespace = "http://tempuri.org/InventoryDataSet .xsd"; 
this.EnforceConstraints = true; 
this.SchemaSerializationMode = 
global::System.Data.SchemaSerializationMode.IncludeSchema; 

this.tableInventory = new InventoryDataTable(); 
base.Tables.Add(this.tableInventory); 

} 


// 只 读 的 Inventory 属 性 返回 了 InventoryDataTable 成 员 变 量 
public InventoryDataTable Inventory 


get { return this.tableInventory; } 
} 
注意 ， 强 类 型 的 DataSet 包 含 强 类 型 的 DataTable 成 员 变量 ， 其 类 名 为 InventoryDataTable。 强 类 型 


DataSet 类 的 构造 函数 调用 一 个 私有 的 初始 化 方法 Initclass()， 会 将 这 个 强 类 型 DataTable 的 实例 添加 到 
DataSet 的 Tables 集 合 中 。 最 后 ， 注 意 Inventory 属 性 的 实现 返回 InventoryDataTable 成 员 变 量 。 


22.10.4” 强 类 型 的 DataTable 


现在 返回 类 图 文件 ， 打 开 InventoryDataSet 图 标 下 的 Nested Types 节 点 ， 可 以 发 现 强 类 型 的 Data- 
Table 类 InventoryDataTable 和 强 类 型 的 DataRow 类 InventoryRow。 
InventoryDataTable 类 ( 和 我 们 刚才 研究 的 强 类 型 Dataset 中 成 员 变量 的 类 型 一 样 ) 根据 物理 
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Inventory 表 的 列 名 定义 了 一 组 属性 ( CarIDColumn、ColorColumn、MakeColumn 和 PetNameColumn )、 自 定 
义 索引 器 以 及 获取 当前 记录 数 的 Count 属 性 。 

最 有 趣 的 是 ,这 个 强 类 型 的 DataTable 类 定义 了 一 组 方法 , 允许 我 们 使 用 强 类 型 成 员 ( 手动 导航 Rows 
和 Columns 索 引 器 的 更 佳 方法 ) 在 表 中 插入 、 定 位 和 删除 行 。 

例如 ,AddInventoryRow() 可 以 向 内 存 中 的 表 添 加 新 的 记录 行 , FindByCarID() 可 以 根据 表 的 主键 进 
行 查找 ，RemoveInventoryRow() 可 以 从 强 类 型 的 表 中 移 除 一 行 ( 如 图 22-21 所 示 )。 
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图 22-21 强 类 型 DataSet 柑 套 在 强 类 型 的 DataTable 中 


22.10.5 ” 强 类 型 的 DataRow 


同样 内 髋 在 强 类 型 Dataset 中 的 强 类 型 DataRow 类 扩展 了 DataRow 类 ， 并 公开 了 一 些 直 接 映 射 到 
Inventory 表 架构 的 属性 。 同 样 ， 数 据 设计 器 工具 生成 了 一 个 方法 ( IsPetNameNul1() )， 检 查 某 列 是 否 
有 值 ( 如 图 22-22 所 示 )。 
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图 22- 22 强 类 ao 


22.10.6” 强 类 型 的 数据 适配器 


使 用 数据 源 配置 向 导 的 一 个 非常 大 的 优势 就 是 能 让 我 们 的 断 开 连接 类 型 有 很 多 强 类 型 ， 因 为 手工 
创建 这 些 类 是 很 无 聊 的 (但 也 是 完全 有 可 能 的 )。 这 个 向 导 还 生成 了 自 定 义 的 数据 适配器 对 象 ， 可 以 
以 强 类 型 的 方式 填充 和 更 新 InventoryDataSet 和 InventoryDataTable 对 象 。 在 可 视 化 类 设计 器 中 找到 
InventoryTableAdapter ， 并 查看 ls 加 2 3 所 未 。 
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图 22-23 ” 自 定 义 的 数据 适配器 操作 强 类 型 的 DataSset 和 DataTable 
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自动 生成 的 InventoryTableAdapter 类 型 维护 SqlCommand 对 象 ( 可 以 使 用 CommandCollection 属 性 来 
访问 它 ) 的 集合 ， 每 一 个 都 填充 了 一 组 SqlParameter 对 象 。 此 外 ， 自 定义 的 数据 适配器 提供 了 一 组 属 
性 来 提取 底层 的 连接 、 事务 以 及 数据 适配器 对 象 , 还 有 一 组 属性 用 来 获取 表示 每 一 个 命令 类 型 的 数组 。 


22.10.7 “完成 Windows Forms 应 用 程序 


如 果 研 究 表单 派生 类 型 的 Load 事 件 处 理 程序 ( 即 如 果 查 看 MainForm.cs 的 代码 并 且 找 到 
MainFormLoad() 方 法 )， 就 会 发 现 自 定义 数据 适配器 的 Fil1() 方 法 在 启动 的 时 候 就 被 调用 ,并且 传人 由 
自 定义 DataSet 维 护 的 自 定义 DataTable: 


private void MainForm Load(object sender, EventArgs e) 


this.inventoryTableAdapter.Fill(this.inventoryDataSet.Inventory); 


我 们 可 以 使 用 相同 的 自 定义 数据 适 配 絮 对 象 来 更 新 网 格 。 使 用 一 个 Button 控 件 ( 叫做 btnUp- 
dateInventory ) 更 新 表单 的 UI。 接 着 处 理 Click 事 件 并 且 在 事件 处 理 程序 中 编写 如 下 代码 : 


private void btnUpdateInventory Click(object sender, EventArgs e) 
try 


{ 
// 这 会 把 Inventory 表 中 的 任何 修改 发 回 数据 库 进 行 处 理 
this.inventoryTableAdapter.Update(this.inventoryDataSet.Inventory); 


catch(Exception ex) 


MessageBox.Show(ex.Message); 


// 为 网 格 获取 新 的 数据 
this.inventoryTableAdapter.Fill(this.inventoryDataSet.Inventory); 


有 

再 一 次 运行 应 用 程序 ， 增 加 、 删 除 或 更 新 显示 在 网 格 中 的 记录 ， de 如 果 我 们 
再 次 运行 程序 ， 就 会 发 现 我 们 的 改动 生效 并 且 被 处 理 了 。 

该 示例 告诉 我 们 DataGridview 控 件 设 计 器 是 多 么 有 帮助 。 它 带 来 的 强 类 型 数据 为 我 们 生成 了 大 量 
必要 的 数据 库 逻 辑 。 一 个 明显 的 问题 是 ,这些 代码 与 使 用 它们 的 窗口 紧密 相连 。 理 想 情 况 下 ， 这 些 代 
码 应 该 属于 AutoLotDAL.dll 程 序 集 ( 或 其 他 数据 访问 库 ),。 但 你 可 能 想 知道 如 何在 Class Libarary 项 目 中 
使 用 DataGridView 的 向 导 所 生成 的 代码 ， 因 为 默认 情况 下 没有 窗 体 设计 器 。 








源 代码 ”DataGridViewDataDesigner 项 目的 源 代码 位 于 Chapter 22 子 目录 下 。 








22.11 将 强 类 型 的 数据 库 代码 隔离 到 类 库 中 


幸好 我 们 可 以 从 任何 类 型 的 项 目 (基于 UI 或 其 他 ) 中 启动 Visual Studio 的 数据 设计 工具 ， 无 须 在 
项 目 之 间 复 制 和 粘贴 大 量 的 代码 。 向 AutoLotDAL.dll 添 加 更 多 功能 即 可 看 到 这 一 点 。 
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将 本 章 前 面 创建 的 AutoLotDAL(Version Two) 项 目 所 在 的 文件 夹 整 个 复制 到 硬盘 的 新 位 置 , 并 将 文 
件 夹 重 命名 为 AutoLotDAL(Version Three)。 接 下 来 ， 单 击 Visual Studio 的 File 一 Open Project/Solution... 
菜单 选项 ， 打 开 AutoLotDAL(Version Three) 目 录 下 的 AutoLotDAL .sln 文 件 。 

通过 Project 一 Add New Item 菜 单项 在 项 目 中 插入 一 个 新 的 Dataset 类 ( 叫做 AutoLotDataSet.xsd ) 
(要 快速 找到 DataSet 项 目 类 型 ， 可 以 选择 New Item 对 话 框 的 Data 节 ， 如 图 22-24 所 示 )。 
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图 22-24 搬入 新 的 强 类 型 的 DataSet 


这 就 会 打开 一 个 空 的 DataSet 设 计 器 界面 。 此 时 ,使 用 服务 器 资源 管理 器 连接 某 个 数据 库 ( 你 应 该 
已 经 有 AutoLot 的 连接 了 ), 并 且 将 每 一 个 希望 生成 的 数据 库 对 象 拖 到 界面 上 。 从 图 22-25 中 ,可 以 看 到 
AutoLot 的 每 一 个 自 定 义 方面 ， 并 且 它 们 的 关系 被 自动 实现 ( 这 里 就 不 拖 CreditRisk 表 了 )。 
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图 22-25” 自 定 义 的 强 类 型 类 型 ， 这 次 在 类 库 项 目 中 
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22.11.1 查看 生成 的 代码 


DataSet 设 计 器 所 创建 的 代码 ， 与 前 面 的 Windows Forms 示 例 中 DataGridView 向 导 所 创建 的 代码 完 
全 相同 。 只 不 过 这 次 我 们 生成 了 Inventory 、Customers 和 0Orders 表 ， 以 及 GetpPetName 存 储 过 程 ， 因 此 有 
了 更 多 的 生成 类 。 基本 上 , 每 个 拖 忠 到 设计 器 界面 上 的 数据 库 表 都 将 得 到 强 类 型 的 DataSet, 以 及 其 内 
部 的 DataTable 、DataRow 和 数据 适配器 类 。 

强 类 型 的 DataSet 、DataTable 、DataRow 类 将 位 于 项 目 ( AutoLotDAL ) 的 根 命名 空间 中 。 自 定义 的 
表 适 配器 将 位 于 内 罕 的 命名 空间 中 。 你 可 以 打开 Visual Studio View 菜 单 下 的 Class View 工 具 , 非常 容易 
地 查看 所 有 生成 的 类 型 ( 如 图 22-26 所 示 )。 
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图 22-26 ”AutoLot 数 据 库 自动 生成 的 强 类 型 数据 


为 完备 起 见 ， 你 可 能 希望 使 用 Visual Studio 的 Properties 编 辑 器 ( 详 见 第 14 章 )， 将 AutoLotDAL.dll 
的 版 本 设置 为 3.0.0.0。 
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22.11.2 用 生成 的 代码 选择 数据 


此 时 ， 我们 可 以 在 需要 与 AutoLot 获 据 库 通信 的 .NET 应 用 程序 中 使 用 这 些 强 类 型 数据 。 为 了 确保 
你 已 经 理解 了 基本 机 制 ， 创 建 一 个 控制 台 应 用 程序 StronglyTypedDataSetConsoleClient。 然 后 ， 添 加 对 
于 最 新 版 的 AutoLotDAL.dll 的 引用 ， 并 在 初始 的 C# 代 码 文件 中 引入 AutoLotDAL 和 AutoLotDAL. 


AutoLotDataSetTableAdapters 命 名 空间 。 


下 面 的 Main() 方 法 使 用 InventoryTableAdapter 对 象 获 取 Inventory 表 中 的 所 有 数据 。 注 意 ,你 没有 
必要 指定 连接 字符 串 ， 因 为 它 已 经 成 为 强 类 型 对 象 模型 的 一 部 分 了 。 填 充 数据 表 后 ,使 用 辅助 方法 


PrintInventory() 打 印 结果 。 注 意 ， 对 于 强 类 型 的 DataTable， 你 完 


作 “ 普 通 ” 的 DataTable 那 样 进行 操作 : 
class Program 


static void Main(string[] args) 


7 


全 可 以 像 使 用 Rows 和 Columns 集 合 操 


Console.WriteLine("***** Fun with Strongly Typed DataSets *****\n"); 


AutoLotDataSet.InventoryDataTable table = 
new AutoLotDataSet.InventoryDataTable(); 


InventoryTableAdapter dAdapt = new InventoryTableAdapter(); 


dAdapt .Fill(table); 


PrintInventory(table); 
Console.ReadLine(); 


} 


static void PrintInventory(AutoLotDataSet.InventoryDataTable dt) 


// 打印 列 名 


for (int curCol = 0; curCol «< dt.Columns.Count; curCol++) 


Console.Write(dt.Columns[curCol].ColumnName + "\t"); 


Console.WriteLine("\Nn----------- 


// 打印 数据 
for (int curRow = 0; curRow < dt.Rows.Count; curRow++) 


for (int curCol = 0; curCol < dt.Columns.Count; curCol++) 
Console.Write(dt.Rows[curRow][curCol].ToString() + "\t"); 


Console.WritelLine(); 
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22.11.3 ”用 生成 的 代码 插入 数据 


现在 假设 你 要 用 这 个 强 类 型 的 对 象 模型 插入 新 的 记录 。 下 面 的 辅助 方法 向 当前 的 Inventory- 
DataTable 中 添加 两 个 新 行 ， 然 后 使 用 数据 适配器 更 新 数据 库 。 第 一 行 通过 配置 强 类 型 DataRow 手 工 添 
加 ， 第 二 行 通过 传递 所 需 的 列 数 据 添 加 ， 该 列 数据 用 来 在 后 台 自 动 创 建 DataRow: 
public static void AddRecords(AutoLotDataSet.InventoryDataTable tb， 
InventoryTableAdapter dAdapt) 
让 
// 从 表 中 获取 新 的 强 类 型 的 行 


AutoLotDataSet.InventoryRow newRow = tb.NewInventoryRow(); 


// 使 用 一 些 示 例 数据 填充 该 行 
newRow.CarID = 999; 
newRow.Color = "Purple"; 
newRow.Make = "BMW"; 
newRow.PetName = "Saku"; 


// 插入 新 行 
tb.AddInventoryRow(newRow) ; 


// 使 用 重 载 的 Add 方 法 添加 另 一 个 行 
tb.AddInventoryRow(888, "Yugo", "Green", "Zippy"); 


// 更 新 数据 库 
dAdapt .Update(tb); 


Catch(Exception ex) 
Console. WritelLine(ex.Message); 


} 
Main() 方 法 调用 该 方法 ， 用 这 些 新 的 记录 更 新 数据 库 : 


static void Main(string[] args) 


// 添加 行 ， 更 新 并 再 次 打印 
AddRecords (table, dAdapt); 
table.Clear(); 

dAdapt .Fill(table); 
PrintInventory(table); 
Console.ReadLine(); 


} 


22.11.4 用 生成 的 代码 删除 数据 


使 用 强 类 型 的 对 象 模型 删除 数据 同样 很 简单 。 强 类 型 的 DataTable 中 包含 自动 生成 的 FindByXXX() 
方法 ( 其 中 XXXX 为 主键 列 的 名 称 ) 根据 主键 返回 正确 的 ( 强 类 型 的 ) DataRow。 下 面 的 辅助 方法 将 删 
除 刚刚 创建 的 两 行 : 


private static void RemoveRecords(AutoLotDataSet.InventoryDataTable tb, 
InventoryTableAdapter dAdapt) 
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try 


AutoLotDataSet.InventoryRow rowToDelete = tb.FindByCarID(999); 

dAdapt .Delete(rowToDelete.CarID, rowToDelete.Make, 
rowToDelete.Color, rowToDelete.PetName); 

rowToDelete = tb.FindByCarID(888); 

dAdapt .Delete(rowToDelete.CarID, rowToDelete.Make, 
rowToDelete.Color, rowToDelete.PetName); 


da ex) 
Console. WriteLine(ex.Message); 
} 
} 
如 果 在 Main() 方 法 中 调用 该 方法 并 重新 打印 该 表 ， 那 么 将 不 再 显示 两 条 测试 记录 。 
说 明 如 果 运 行 该 应 用 程序 两 次 并 且 每 次 都 调用 AddRecord() 方法， 将 得 到 违反 约束 错误 
(VOILATION CONSTRAINT ERROR )， 因 为 AddRecord() 方 法 每 次 都 试图 插入 同样 的 CarID 主 


键 值 ( 所 以 我 们 才 将 数据 访问 逻辑 放 到 try/catch 里 )。 要 想 让 该 示例 更 灵活 , 应 该 使 用 Console 
类 ， 让 客户 输入 数据 。 


22.11.5 用 生成 的 代码 调用 存储 过 程 


让 我 们 来 看 看 男 一 个 使 用 强 类 型 对 象 模型 的 示例 。 在 该 示例 中 ， 我 们 创建 一 个 调用 GetPetName 存 储 
过 程 的 方法 。 当 AutoLot 数 据 库 的 数据 适配器 被 创建 时 , 有 一 个 特殊 的 类 QueriesTableAdapter。 顾名思义 ， 
它 可 以 用 来 在 关系 数据 库 中 调用 存储 过 程 。 在 Main() 中 调用 下 面 的 辅助 方法 将 显示 指定 的 汽车 名 称 : 


public static void CallstoredProc() 
try 


QueriesTableAdapter q = new a 
Console.Write("Enter ID of car to look up: 

string carID = Console.ReadLine(); 

string carName = ""; 

q.GetPpetName(int.Parse(carID), ref carName); 
Console.WriteLine("CarID {0} has the name of {1}", carID, carName); 


Catch(Exception ex) 
Console. WriteLine(ex.Message); 


} 

现在 ,我 们 知道 了 如 何 使 用 强 类 型 的 数据 库 类 型 ， 以 及 如 何 把 它们 包装 到 单独 的 类 库 中 。 关 于 这 
个 对 象 模型 ， 还 有 很 多 方面 没有 介绍 ， 但 如 果 感 兴趣 你 可 以 自行 研究 。 在 本 章 最 后 ， 你 将 学 习 如 何 对 
ADO.NET Dataset 对 象 使 用 LINQ 查 询 。 


源 代 码 StronglyTypedDataSetConsoleClient 项 目的 源 代 码 位 于 Chapter 22 子 目录 下 。 
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22.12 LINQ to DataSet 


我 们 在 本 章 中 学 习 了 3 种 不 同 的 操作 DataSset 数 据 的 方式 : 
口 使 用 Tables 、Rows 和 Columns 集 合 ; 

口 使 用 数据 表 读 取 器 ; 

口 使 用 强 类 型 数据 类 。 


在 使 用 DataSet 和 DataTable 等 类 型 的 索引 器 时 ， 可 以 直接 以 弱 类 型 的 方式 与 数据 交互 。 记 住 这 种 
方法 要 求 我 们 将 数据 视 为 表格 ， 例 如 : 


static void PrintDataWithIndxers(DataTable dt) 


// 打印 DataTable 
for (int curRow = 0; curRow < dt.Rows.Count; curRow++) 


for (int curCol = 0; curCol «< dt.Columns.Count; curCol++) 
Console.Write(dt.Rows[curRow][curCol].ToString() + "\t"); 
Console.WritelLine(); 
} 
DataTable 类 型 还 提供 了 CreateDataReader() 方 法 ， 将 Dataset 中 的 数据 视 为 可 顺序 处 理 的 线性 的 
行 。 这 使 得 你 可 以 在 非 连接 的 DataSet 中 使 用 连接 的 数据 读 取 器 编程 模型 : 
static void PrintDataWithDataTableReader(DataTable dt) 
// 获取 DataTableReader 类 型 


DataTableReader dtReader = dt.CreateDataReader(); 
while (dtReader.Read()) 


for (int i = 0; i «< dtReader.FieldCount; i++) 
Console.Write("{0}\t", dtReader.GetValue(i)); 
Console.WriteLine(); 


} 
dtReader.Close(); 


最 后 , 我 们 可 以 使 用 强 类 型 的 Dataset 来 生成 代码 库 , 该 代码 库 允许 你 使 用 映射 到 关系 数据 库 各 个 
列 名 的 属性 与 对 象 中 的 数据 进行 交互 。 使 用 强 类 型 的 对 象 ， 可 以 编写 下 面 这 样 的 代码 : 


static void AddRowWithTypedDataSet() 


InventoryTableAdapter invDA = new InventoryTableAdapter(); 
AutoLotDataSet.InventoryDataTable inv = invDA.GetData(); 
inv.AddInventoryRow(999, "Ford", "Yellow", "Sal"); 
invDA.Update(inv); 

} 


尽管 每 种 方法 都 有 其 用 武之 地 ， 但 LINQ to DataSet API 提 供 了 一 种 使 用 LINQ 查 询 表 达 式 来 操纵 
DataSetAPI 的 选择 。 
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说 明 ”我们 使 用 LINQ to DataSet API 只 对 数据 适配器 返回 的 DataSet 对 象 执行 LINQ 查 询 ， 而 不 是 对 数 
据 库 引擎 本 身 直接 应 用 LINQ 查 询 。 第 23 章 将 介绍 LINQ to Entity 和 ADO.NET Entity Framework， 
它 可 以 以 LINQ 查 询 来 表示 SQL 查询 。 


ADO.NET DataSet ( 及 其 相关 的 类 型 ， 如 DataTable 和 DataView ) 并 不 具备 成 为 LINQ 查 询 目标 的 基础 
结构 。 例 如 ， 下 面 的 方法 (使 用 了 AutoLotDisconnectedLayer 命 名 空间 中 的 类 型 ) 将 导致 编译 时 错误 : 


static void LinqOverDataTable() 
{ 
// 获取 数据 的 DataTable 
InventoryDALDisLayer dal = new InventoryDALDisLayer( 
@"Data Source=(local)\SQOLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 
DataTable data = dal.GetAllInventory(); 





// 对 DataSet 应 用 LINQ 查 询 
Var moreData = from c in data where (int)c["CarID"] > 5 select c; 


} 

编译 Linq0verDataTable() 方 法 ,编译 器 将 通知 你 DataTable 类 型 需要 提供 查询 模式 的 实现 。 这 与 对 
未 实现 IEnumerable<T> 的 对 象 执 行 LINQ 查 询 的 过 程 一样 ，ADO.NET 对 象 必 须 转 换 为 兼容 的 类 型 。 要 
理解 这 些 ， 需 要 先 研 究 System.Data.DataSetExtensions.dll 的 类 型 。 


22.12.1 DataSet Extensions 库 的 作用 


Visual Studio 项 目 默认 引用 了 System.Data.DataSetExtensions.dll 程 序 集 ， 它 用 少量 的 新 类 型 扩展 了 
System.Data 命 名 空间 ( 如 图 22-27 所 示 )。 


Object Browser 石 xX 
Browse: My Solution 
<Search> 
bp wa AutoLotDAL 2 
b LingToDataSetApp 
b ws Microsoft,CSharp 
DP a mscordb 
Ds System 
b sa System Core 
bp sm System.Data 
System.Data,DataSetExtensions i 
4 {} System.Data | : 
by Bs DataRowComparer | 
! b DataRowComparer<TRow> 3 
| 本 DataRowfxtensions | Assembly System.Data.DataSetExtensions 
| by $s DataTableExtensions | Ca\program Files (x86)\Reference Assemblies\Microsoft 
| b ts EnumerableRowCollection | \Framework\ NETFrameworkva.5 
| b % EnumerableRewCollection<TRow> 1 \System.Data.DataSetExtensions.dll 
b hs EnumerableRowCollectionExtensions | 
b Hs OrderedEnumerableRowCollection< TRow> | 
b Be TypedTasbleBass<T> | I 
| b He TypedTableBaseExtensions 
bp sm System.Xmi - 








图 22-27 ”System.Data.DataSetExtensions.dll 程 序 集 
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最 常用 的 两 个 类 为 DataTableExtensions 和 DataRowExtensions。 它 们 使 用 一 些 扩 展 方 法 扩展 了 
DataTable 和 DataRow 的 功能 ( 见 第 12 章 )。 另 一 个 关键 的 类 是 TypedTableBaseExtensions， 它 也 定义 了 
一 些 扩 展 方法 ， 可 以 用 来 对 强 类 型 Dataset 对 象 内 部 的 DataTable 执 行 LINQ 查 询 。System.Data. 
DataSetExtensions.dll 程 序 集中 的 其 他 成 员 都 是 纯粹 的 基础 结构 ， 不 要 在 代码 库 中 直接 使 用 它们 。 


22.12.2 ”获取 与 LINQ 兼 容 的 DataTabjle 


现在 让 我 们 来 看 看 如 何 使 用 这 个 Dataset 扩 展 。 假 设 我 们 有 一 个 新 的 C# 控 制 台 应 用 程序 ， 名 为 
LinqToDataSetApp。 添加 最 新 版 (3.0.0.0 ) 的 AutoLotDAL.dll 程 序 集 , 用 以 下 逻辑 更 新 初始 的 代码 文件 : 

using System; 

// 强 类 型 数据 容器 所 在 的 位 置 

using AutoLotDAL; 


// 强 类 型 数据 适配器 所 在 的 位 置 
using AutoLotDAL.AutoLotDataSetTableAdapters; 


namespace LinqToDataSetApp 
class Program 
static void Main(string[] args) 
Console.WriteLine("***** LINQ over DataSet *****\n"); 


// 获取 包含 AutoLot 数 据 库 中 当前 Inventory 的 强 类 型 DataTable 
AutoLotDataSet dal = new AutoLotDataSet(); 
InventoryTableAdapter da = new InventoryTableAdapter(); 
AutoLotDataSet. InventoryDataTable data = da.GetData(); 


// 在 下 面 调 用 那些 方法 


Console.ReadLine(); 
} 
} 
} 


当 你 希望 将 ADO.NET DataTable ( 包括 强 类 型 的 DataTable ) 转换 为 LINQ 兼 容 的 对 象 时 ， 必 须 调 
用 DataTableExtensions 类 型 中 定义 的 AsEnumerable() 扩 展 方 法 。 它 返回 包含 DataRows 集 合 的 
EnumerableRowCollection 对 象 。 

然后 ,你 可 以 使 用 EnumerableRowCollection 类 型 用 基本 的 DataRow 语 法 ( 如 索引 器 语法 ) 来 操作 每 
一 行 。 考 虑 下 面 这 个 Program 类 的 新 方法 ， 它 使 用 强 类 型 的 DataTable， 获 取 数 据 可 枚 举 的 副本 ， 并 打 
印 每 个 CarID 的 值 : 

static void PrintAl1CarIDs(DataTable data) 


// 获取 DataTable 可 枚 举 的 副本 
EnumerableRowCollection enumData = data.AsEnumerable(); 


// 打印 汽车 的 ID 
foreach (DataRow r in enumData) 
Console.WriteLine("Car ID = {0}", r["CarID"]); 
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这 里 并 没有 使 用 LINQ 查 询 。 但 关键 是 这 里 的 enumData 对 象 可 以 成 为 LINQ 查 询 表 达 式 的 目标 。 再 
次 注意 ,EnumerableRowCollection 包 含 DataRow 对 象 的 集合 , 因为 我 们 对 每 个 子 对 象 都 使 用 了 类 型 索引 
器 ,来 打印 CarID 列 的 值 。 

在 大 多 数 情况 下 ， 我 们 没有 必要 声明 一 个 EnumerableRowCollection 类 型 的 变量 来 保存 
AsEnumerabjle() 的 返回 值 ， 而 是 可 以 在 查询 表达 式 内 部 调用 该 方法 。 以 下 是 Program 类 中 一 个 更 有 趣 的 
方法 ， 它 从 所 有 汽车 颜色 为 红色 的 (如果 Inventory 表 中 没有 红色 的 汽车 ， 则 可 以 更 改 该 LINQ 查 询 ) 
DataTable 中 获取 CarID + Makes 的 投影 : 

static void ShowRedCars(DataTable data) 

// 对 Color = Red 的 行 ， 投 影 包含 ID/ 颜 色 的 结果 集 
Var cars = he in data.AsEnumerable() 


(string)car["Color"] == "Red" 
select new 


ID = (int)car["CarID"], 
Make = (string)car["Make"] 


3 
Console.WriteLine("Here are the red cars we have in stock:"); 
foreach (var item in cars) 


Console.WriteLine("-> CarID = {0} is {1}", item.ID, item.Make); 


} 


22.12.3 ”DataRowExtensions.Field<T>() 扩 展 方法 的 作用 


当前 LINQ 查 询 表达 式 一 个 不 尽 如 人 意 的 地 方 是 ， 我 们 在 获取 结果 集 时 使 用 了 大 量 的 转换 操作 和 
DataRow 索 引 器 , 如 果 试 图 转换 不 兼容 的 数据 类 型 , 将 会 导致 运行 时 异常 。 要 在 查询 中 注入 一 些 强 类 型 ， 
可 以 使 用 DataRow 类 型 的 Field<T>() 扩 展 方法 。 这 么 做 可 以 增强 查询 的 类 型 安全 ， 因 为 数据 类 型 的 兼容 
性 将 在 编译 时 进行 检查 。 考 虑 如 下 的 更 新 : 


Var cars = from car in data.AsEnumerable() 
where 
car.Field<string>("Color") == "Red" 
select new 


ID = car.Field<int>("CarID"), 
Make = car.Field<string>("Make") 
在 本 例 中 ,我 们 调用 Field<T>()， 指 定 表示 列 实际 数据 类 型 的 类 型 参数 。 该 方法 的 参数 为 列 名 本 
身 。 由 于 作 了 额外 的 编译 时 检查 , 所 以 处 理 EnumerableRowCollection 的 最 佳 实践 是 使 用 Field<T>() (而 
不 是 DataRow 索 引 器 )。 
除了 调用 AsEnumerable() 方 法 ， 整 个 LINQ 查 询 的 格式 与 第 13 章 介绍 的 基本 相同 。 因 此 ， 没 有 必要 
在 此 重复 不 同 LINQ 操 作 的 细节 了 。 如 果 和 希望 看 到 更 多 的 示例 ,可 以 查看 .NET Framework 4.5 SDK 文 档 
中 的 “LINQ to DataSet Examples” 话 题 。 
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22.12.4 ”从 LINQ 查 询 中 生成 新 的 DataTable 


如 果 不 使 用 投影 ， 也 可 以 基于 LINQ 查 询 的 结果 生成 新 的 DataTable 数 据 。 当 结果 集 的 实际 类 型 可 
以 表示 为 IEnumerable<T> 时 ， 可 以 调用 CopyToDataTable() 扩 展 方 法 ， 如 下 例 所 示 : 
static void BuildDataTableFromOuery(DataTable data) 


var cars = from car in data.AsEnumerable() 
where 
Car.Field<int>("CarID") > 5 
select car; 


// 使 用 该 结果 集 来 构建 新 的 DataTable 

DataTable newTable = cars.CopyToDataTable(); 

// 打印 DataTable 

for (int curRow = 0; curRow < newTable.Rows.Count; curRow++) 


for (int curCol = 0; curCol < newTable.Columns.Count; curCol++) 
Console.Write(newTable.Rows[curRow][curCol].ToString().Trim() + "\t"); 


Console.WritelLine(); 


说 明 还 可 以 使 用 AsDataView<T>() 扩 展 方法 将 LINQ 查 询 转 换 为 DataView 类 型 。 


当 你 将 LINQ 查 询 的 结果 作为 数据 绑 定 操作 的 源 时 ， 你 会 发 现 这 项 技术 非常 有 帮助 。Windows 
Forms ( 以 及 ASPNET 或 WPF 网 络 控件 ) 中 的 DataGridyview 支 持 DataSource 属 性 。 你 可 以 像 下 面 这 样 绑 
定 LINQ 结 果 : 


// 假设 myDataGrid 为 基于 GUI 的 网 格 对 象 
myDataGrid.DataSource = (from car in data.AsEnumerable() 
where 
car.Field<int>("CarID") > 5 
select car).CopyToDataTable(); 


现在 完成 了 对 于 ADO.NET 非 连接 层 的 介绍 。 使 用 这 些 API， 可 以 从 关系 数据 库 中 获取 、 处 理 并 返 
回 数据 ， 而 数据 库 连 接 的 打开 时 间 则 尽 可 能 短 。 


源 代码 ”LinqgOverDataSetApp 示 例 的 源 代码 位 于 Chapter 22 子 目录 下 。 


22.13 小结 


本 章 深 入 探讨 了 ADO.NET 断 开 连 接 层 的 细节 。 我 们 已 经 看 到 了 ， 断 开 连 接 层 的 核心 是 DataSet。 
这 个 类 型 是 许多 表 、 可 选 关 系 、 约 束 以 及 表达 式 在 内 存 中 的 表现 。 在 本 地 数据 表 之 间 构 建 关 系 的 魅力 
在 于 ， 从 远程 数据 库 断 开 的 情况 下 我 们 可 以 以 编程 方式 在 在 表 之 间 切 换 。 
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在 本 章 中 ， 我 们 还 研究 了 数据 适配器 类 型 的 作用 。 使 用 这 个 类 型 ( 以 及 相关 的 SelectCommand、 
InsertCommand、UpdateCommand 和 DeleteCommand 属 性 ),， 适 配器 就 可 以 同步 原始 数据 库 源 和 Dataset。 同 
样 ， 我 们 学 习 了 如 何 利用 由 Visual Studio 的 DataSet 设 计 器 工具 生成 的 强 类 型 对 象 ， 通 过 强大 的 手动 方 
式 来 使 用 Dataset 的 对 象 模 型 。 

最 后 介绍 了 一 种 LINQ 技 术 LINQ to DataSet。 它 能 获得 Dataset 可 查询 的 副本 ,接收 格式 化 的 LINQ 


查询 。 


ADO.NET 之 三 ; Entity 
Framework . 





一 二 两 章 介 绍 了 ADO.NET 编 程 模型 的 底层 机 制 一 连接 层 和 断 开 连 接 层 。 从 最 初 发 布 的 平台 

月 J 始 ，NET 程 序 员 就 是 用 这 些 方法 ( 以 一 种 相对 简单 的 方式 ) 来 操作 关系 型 数据 。 不 过 ， 微 软 
在 .NET 3.5 Service Pack 1 中 为 ADO.NET API 引 入 了 一 个 全 新 的 组 件 ， 称 为 Entity Framework ( 简称 EF )。 

EF 的 首要 目标 是 使 用 直接 映射 到 应 用 程序 中 业务 对 象 的 对 象 模 型 与 关系 型 数据 库 进行 交互 。 例 如， 
它 没 有 将 数据 视 为 行 和 列 的 集合 ， 而 是 将 其 视 为 强 类 型 对 象 ( 称 为 实体 ) 的 集合 。 这 些 实体 也 可 用 于 
LINQ, 你 可 以 使 用 第 12 章 所 学 过 的 LINQ 语 法 来 进行 查询 。 EF 运行 时 引擎 会 将 你 的 LINQ 查 询 转 换 为 正 
确 的 SQL 查询 。 

本 章 将 介绍 EF 编 程 模型 。 你 将 学 习 各 种 基本 概念 ， 包 括 对 象 服务 、 实 体 客 户 端 、LINQ to Entity 
和 Entity SQL。 你 还 将 学 习 到 十 分 重要 的 *.edmx 文 件 的 格式 及 其 在 Entity Framework API 中 的 作用 。 然 
后 还 将 学 习 如 何 使 用 Visual Studio 或 EMD 生 成 工具 ( edmgen.exe ) 的 命令 行 来 生成 *.edmx 文 件 。 

阅读 完 本 章 之 后 ， 你 将 得 到 AutoLotDAL.dll 的 最 终 版 本 ， 并 将 学 习 如 何在 Windows Form 桌 面 应 用 
程序 中 绑 定 实体 对 象 。 


23.1 Entity Framework 的 作用 


ADO.NET 的 连接 层 和 断 开 连接 层 提供 了 一 个 架构 ,可 以 通过 连接 、 命 令 、 数 据 读 取 咒 、 数 据 适 配 
器 和 Dataset 对 象 来 进行 查询 、 插 入 、 更 新 和 删除 数据 等 操作 。 尽 管 这 是 一 个 十 分 优秀 的 架构 , 但 它 还 
是 会 迫使 我 们 以 一 种 与 物理 数据 库 结 构 紧 耦 合 的 方式 来 处 理 数据 。 例 如 在 使 用 连接 层 时 ,我 们 通常 在 
数据 读 取 器 中 指定 列 名 来 遍历 每 条 记录 。 而 如 果 使 用 断 开 连接 层 , 则 将 会 对 DataSet 容 器 中 的 DataTable 
对 象 的 行 和 列 的 集合 进行 遍历 。 

如 果 在 断 开 连接 层 中 使 用 强 类 型 的 Dataset 或 数据 适配器 ,那么 带 来 的 编程 方面 的 抽象 性 是 很 有 帮 
助 的 。 首 先 ， 强 类 型 的 DataSet 使 用 类 的 属性 来 表示 表 数 据 。 其 次 ， 强 类 型 的 表 适 配器 支持 封装 了 构造 
底层 SQL 语句 的 方法 。 如 第 22 章 的 AddRecords() 方 法 : 

public static void AddRecords(AutoLotDataset. InventoryDataTable tb， 

InventoryTableAdapter dAdapt) 


人 
// 从 表 中 得 到 强 类 型 的 新 行 
AutoLotDataSet.InventoryRow newRow = tb.NewInventoryRow(); 
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// 用 示例 数据 填充 行 
newRow.CarID = 999; 
newRow.Color = "Purple"; 
newRow.Make = "BMW"; 
newRow.PetName = "Saku"; 


// 插入 新 行 
tb.AddInventoryRow(newRow); 


// 使 用 重 载 的 Add 方 法 添加 新 行 
tb.AddInventoryRow(888， "Yugo", "Green", "Zippy"); 


// 更 新 数据 库 
dAdapt .Update(tb); 


如 果 在 断 开 连 接 层 中 使 用 LINQ to DataSet, 情况 会 变 得 更 好 。 你 可 以 对 内 存 中 的 数据 使 用 LINQ 查 
询 来 得 到 新 的 记录 集 ， 然 后 再 将 其 映射 到 单独 的 对 象 ， 如 新 的 DataTable、List<T>、Dictionary<K,V> 
或 数组 ， 如 下 所 示 : 


static void BuildDataTableFromQuery(DataTable data) 


var cars = from car in data.AsEnumerable() 
where car.Field<int>("CarID") > 5 select car; 


// 试用 该 数据 集 来 构建 新 的 DataTable 
DataTable newTable = cars.CopyToDataTable(); 


// 操作 DataTable 


LINQ to DataSet 是 非常 有 用 的 ， 但 要 记 住 我 们 使 用 LINQ 查 询 的 目标 是 得 到 数据 库 中 返回 的 数据 ， 
而 不 是 数据 库 引 擎 本 身 。 理 想 情 况 下 ， 我 们 和 希望 构建 一 个 LINQ 查 询 并 将 其 直接 发 送 给 数据 库 引擎 进 
行 处 理 ， 然 后 返回 强 类 型 的 数据 ( 这 正 是 ADO.NET Entity Framework 能 够 做 到 的 )。 

不 管 是 使 用 ADO.NET 的 连接 层 还 是 断 开 连接 层 , 你 都 必须 十 分 留意 后 端 数据 库 的 物理 结构 。 你 必 
须 了 解 每 个 数据 表 的 架构 ， 能 够 编写 复杂 的 SQL 查 询 与 表 数 据 进 行 交互 ， 等 等 。 这 会 迫使 你 编写 十 分 
宛 长 的 C# 代 码 ， 因 为 C# 本 身 无 法 直接 用 于 数据 库 架 构 。 

更 糟 的 是 ，DBA 在 构建 物理 数据 库 时 考虑 更 多 的 是 数据 库 的 结构 ， 如 外 键 、 视 图 、 存 储 过 程 。 而 
且 出 于 安全 性 和 可 扩展 性 的 角度 考虑 , 数据 库 会 变 得 更 加 复杂 。 这 同样 会 使 与 数据 存储 进行 交互 的 C# 
代码 腾 肿 不 堪 。 

ADO.NET Entity Framework ( EF ) 是 一 种 编程 模型 ， 旨 在 减少 数据 库 结 构 与 面向 对 象 编 程 结构 之 
间 的 差异 。 使 用 EF ， 你 不 用 编写 SQL 代码 就 能 与 关系 型 数据 库 交 互 。( 如 果 你 愿意 的 话 。) 并 且 , 在 对 
强 类 型 类 进行 LINQ 查 询 时 ，EF 还 会 在 运行 时 生成 正确 的 SQL 语句 。 


说 明 术语 LINQ to Entity 是 指 对 ADO.NET EF 实体 对 象 使 用 LINQ 查 询 。 
相 比 更 新 数据 库 时 使 用 一 些 SQL 查 询 来 查找 、 更 新 ， 再 将 其 发 送 回 数据 库 进 行 处 理 ， 使 用 EF 可 以 


简单 地 修改 对 象 的 属性 ， 并 保存 其 状态 。EF 在 运行 时 将 自动 更 新 数据 库 。 
对 于 微软 来 说 ，ADO.NET Entity Framework 只 是 数据 访问 API 的 另 一 种 途径 ， 其 目的 并 非 是 取代 
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连接 层 和 断 开 连接 层 。 不 过 当 你 使 用 了 EF 一 段 时 间 之 后 会 很 快 发 现 , 相 比 原始 的 SQL 查询 和 行列 集合 ， 
你 会 更 喜欢 这 种 富 对 象 模型 。 

但 是 ,在 .NET 项 目 中 这 三 种 方法 都 会 有 不 少 机 会 。 在 某 些 情况 下 ，EF 模 型 会 使 代码 库 显 得 复杂 。 
例如 ,在 构建 一 个 只 与 一 张 数据 库 表 通 信 的 内 部 应 用 程序 时 ， 你 也 许 会 使 用 连接 层 来 操作 一 些 相 关 的 
存储 过 程 。 大 型 应 用 程序 ( 特别 是 开发 团队 熟练 掌握 LINQ 时 )， 使 用 EF 将 从 中 受益 。 和 其 他 新 技术 一 
样 ， 你 需要 决定 如 何 ( 以 及 何 时 ) 使 用 ADO.NET EF 来 完成 手头 的 工作 。 


说 明 ”你 也 许 想起 了 .NET 3.5 中 引入 的 一 个 数据 库 编 程 API 一 一 LINQ to SQL。 该 API 在 概念 上 ( 以 及 
编程 结构 上 ) 与 ADO.NET EF 接近 。 虽 然 LINQ to SQL 还 没有 正式 死亡 ， 不 过 微软 官方 的 说 法 
是 希望 用 户 致力 于 EF， 而 不 是 LINQ to SQL。 


23.1.1 实体 的 作用 


前 面 所 提 到 的 强 类 型 类 称 为 实体 。 实 体 是 将 物理 数据 库 映 射 到 业务 领域 的 概念 模型 。 这 种 模型 的 
正式 名 称 为 实体 数据 模型 (EDM )。 它 是 一 组 映射 到 物理 数据 库 的 客户 端 类 ， 但 是 这 些 实体 没有 必要 
与 数据 库 架 构 的 命名 约定 完全 一 致 。 你 完全 可 以 根据 需要 调整 实体 类 ，EF 运 行 时 将 把 这 些 唯 一 的 名 字 
映射 到 正确 的 数据 库 架 构 。 

例如 ， 我 们 使 用 如 图 23-1 所 示 的 数据 库 架 构 在 AutoLot 数 据 库 中 创建 简单 的 Inventory 表 。 





Inventory _ 
| 时 CaiD 
| Make 

Color 


PetName 


图 23-1 ”AutoLot 数 据 库 中 Inventory 表 的 结构 


如 果 为 AutoLot 数 据 库 的 Inventory 表 生成 EDM ( 稍 后 将 介绍 如 何 生成 )， 默 认 情 况 下 实体 的 名 称 
为 Inventory。 但 是 你 也 可 以 将 类 名 该 为 Car 并 定义 不 同名 称 的 属性 ， 这 些 属 性 将 映射 到 Inventory 表 的 
各 个 列 。 这 种 松 耦 合意 味 着 可 以 改变 实体 使 其 与 业务 领域 更 加 接近 。 图 23-2 显 示 了 一 个 实体 类 。 


上 

| 电 AutolIDNumber 

| pb MakeOfCar 

| ££ ColorOfCar 

| PP NicknameOfCar 

| 国 Navigation properties 


图 23-2 ”实体 Car 在 客户 端 对 Inventory 架 构 进行 了 修改 
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说 明 在 大 多 数 情况 下 ， 客 户 端 实体 类 的 名 称 都 与 关系 型 数据 库 表 名 相同 。 但 你 总 是 可 以 修改 它 的 
名 称 使 其 与 业务 环境 更 相符 。 





我 们 稍 后 会 用 EF 构建 完整 的 示例 。 但 现在 ， 先 考虑 下 面 的 Program 类 ， 它 使 用 car 实 体 类 ( 和 一 个 
与 之 相关 联 的 AutoLotEntities 类 ) 向 AutoLot 的 Inventory 表 中 添加 一 行 新 的 数据 。AutoLotEntites 类 称 
为 对 象 下 上 文 ， 它 的 作用 是 与 物理 数据 库 进 行 交互 ( 稍 后 将 学 习 更 详细 的 内 容 ): 


class Program 








static void Main(string[] args) 


// 从 生成 的 配置 文件 中 自动 读 取 连接 字符 囊 


using (AutoLotEntities context = new AutoLotEntities()) 


// 使 用 实体 向 Inventory 表 中 添加 一 行 新 的 记录 
context.Cars.AddObject(new Car() { AutoIDNumber = 987, CarColor = "Black", 
MakeOfCar = "Pinto", 
NicknameOfCar = "Pete" }); 
context.SaveChanges(); 


} 
} 
客户 端 用 什么 来 代表 Inventory 表 ( 这 里 是 类 car ) 并 且 将 其 映射 到 表 中 的 各 列 ， 是 取决 于 EF 运行 
时 的 。 你 会 注意 到 这 里 没有 任何 形式 的 SQL INSERT 语 句 ， 你 只 需要 新 建 一 个 Car 对 象 并 将 其 添加 到 上 
下 文 对 象 的 Cars 属 性 这 个 集合 中 ， 然 后 再 保存 更 改 。 训 无 疑问 ， 当 使 用 Visual Studio 的 Server Explorer 
查看 表 中 的 数据 时 ， 会 发 现 多 了 一 行 新 记录 ( 如 图 23-3 所 示 )。 





Inventory: Query(m,..sqlexpress.AutoLot) xX 
[cD Make Color PetName 
| 116 Fcrd White Foofoo 
| 32 VW Black Zippy 
83 Ford Rust Rusty 
| 872 Saab Black Mel 
| 888 Yugo Yellow Clunker 
[ye7 pinto Black pete 
| 1000 BMAW Black Bimmer 
| 1011 BMW Green Hank 
| ‘2911 BMAW Pink Pinky 
| 12345 Yugo Green Zippy 
| 米 ‘NULL NuUtL NULL NULL 
ll4 4 6 of1l0 >》 池 大 


图 23-3 ”保存 上 下 文 之 后 的 结果 
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上 面 的 示例 没有 什么 神奇 可 言 。 在 后 台 ，EF 为 我 们 创建 一 个 数据 库 连 接 、 生 成 一 条 正确 的 SQL 语 
名 ， 等 等 。 为 我 们 处 理 这 些 细节 是 EF 的 最 大 优势 。 现 在 我 们 来 看 看 EF 是 如 何 实现 这 些 核心 服务 的 。 


23.1.2 Entity Framework 的 基础 知识 


EF API 是 以 前 面 两 章 所 介绍 的 ADO.NET 为 基础 的 。 和 其 他 ADO.NET 交 互 方式 一 样 ，Entity 
Framework 使 用 一 个 ADO.NET 数 据 提供 程序 来 与 数据 存储 进行 交互 。 所 不 同 的 是 ， 在 能 够 与 EF API 交 
互 之 前 ， 必 须 更 新 数据 提供 程序 使 其 支持 新 的 服务 。 微 软 SQL Server 数 据 提供 程序 已 经 对 底层 结构 进 
行 了 必要 的 更 新 以 支持 System.Data.Entity.dll 程 序 集 。 








说 明 很 多 第 三 方 数据 库 ( 如 Oracle 和 MySQL ) 提供 了 支持 EF 的 数据 提供 程序 。 详 情 可 以 咨询 你 的 数据 
库 提 供 商 或 登录 www.sqlsummit.com/dataprov.htm 米 查看 已 知 的 ADO.NET 数 据 提供 程序 。 





除了 在 微软 SQL Server 数 据 提供 程序 增加 了 必要 的 内 容 以 外 ，System.Data.Entity.dll 程 序 集 还 包含 
了 各 种 命名 空间 来 解释 EF 服务 本 身 。EF API 的 两 个 关键 部 分 为 对 象 服务 和 实体 客户 端 。 

1. 对 象 服务 的 作用 

对 象 服务 是 EF 的 一 部 分 , 它 在 代码 中 对 客户 端 实体 进行 控制 。 例 如 ， 对 象 服务 跟踪 你 对 实体 的 更 
改 ( 如 将 汽车 的 颜色 由 绿色 改 为 蓝 色 )、 管 理 实体 间 的 关系 〈 如 查找 用 户 Steve Hagen 的 所 有 订单 ) 并 
提供 将 更 改 保 存 到 数据 库 的 方法 ， 以 及 用 XML 或 二 进 制 序列 化 服务 对 实体 状态 进行 持久 化 的 方法 。 

就 编程 方面 而 言 ， 对 象 服务 层 对 所 有 扩展 Entity0bject 基 类 的 类 进行 管理 。 正 如 你 所 想 的 那样 ， 
Entity0bject 是 EF 编程 模型 中 所 有 实体 类 的 基 类 。 例如 ,如果 查找 上 例 中 Car 实体 的 继承 链 , 你 会 发 现 
Car 是 一 个 Entity0bject ( 如 图 23-4 所 示 )。 


:CEASS VI 生生 全 人生 全 全 条 全 全 全 全 人 向 和 人 
渭 ， < 
<Search> 


4 Rs Car 


< 呈 Base Types 


p 和 Customer 


@， ome 

©, ReportpropertyChangedistring) 
@, ReportPropertyChanging(string) 
hb EntityKey 

hk EntityState 





SOLUTION EXPL... TEAM EXPLORER CLASS VIEW | 


图 23-4 ”EF 的 对 象 服务 层 将 管理 所 有 继承 自 Entity0bject 的 类 
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2. 实体 客户 端的 作用 

EF API 的 另 一 个 主要 部 分 是 实体 客户 端 层 , 它 使 用 基本 的 ADO.NET 数 据 提供 程序 来 建立 数据 库 连 
接 、 基 于 实体 状态 和 LINQ 查 询 生 成 SQL 语句 、 将 数据 库 数 据 映 射 到 实体 , 以 及 处 理 其 他 在 不 使 用 Entity 
Framework 时 常见 的 细节 问题 。 

你 可 以 在 System.Data.EntityClient 命 名 空间 中 浏览 实体 客户 端 层 的 功能 。 该 命名 空间 包含 一 些 
类 , 可 以 将 EF 概念 ( 如 LINQ to Entity 查 询 ) 映射 到 ADO.NET 数 据 提供 程序 。 这 些 类 ( 如 EntityCommand 
和 EntityConnection ) 与 ADO.NET 数 据 提供 程序 中 的 类 惊人 地 相似 。 例 如 ， 图 23-5 演 示 了 实体 客户 端 
层 是 如 何 扩展 与 其 他 提供 程序 中 相同 的 抽象 基 类 的 ( 如 DbCommand 和 DbConnection， 更 详细 的 内 容 请 参 
阅 第 21 章 )。 





AutoLotDAL_EF,edmx [AutoLotDAL_EF] Object Browser HX ee 
‘Browse: My Solution "i ,|e i 和 
<Search> -器 这 
4 {} System.Data.EntityClient I: 名 Cancelf 和 
4 本 Entitycommanal 人 CreateDbParameter0 | 
2 困 Base Types @ CreateParameter) EE 
>》 $s DbCommand @ EntityCommandistring, System.Data, Ent 3 

4 es EntityConnection @ EntityCormmandfstring System.Data. Ent 

< 圈 Base Types @ EnttyCommandfstring} 


b $s DbConnection ® EntityCommandO 
4 ts EntityConnectionStringBuilder @, ExecuteDbDataReader(System.Data.Com 
| 4 辆 Base Types @ ExecuteNonQuery) 


i 
| 
| 
| >》 Hs DbConnectionStringBuilder . @ ExecuteReader(System, Data.CommandB ~ | 








| 4 8 EntityDataReader TRY 上 | 
| 4 呈 Base Types | | public sealed class EntityCommand : | 
| b ts DbDataReader | System.Data.Common.DbCommand || 
| “0 IDataRecord Member of System.Data.EntityClient Er 
| b *0 lxtendedDataRecord a 
| 4 Hs EntityParameter Summary: 

| 4 上 Base Types Represents a command to be executed 

| b He Dbparameter against an Entity Data Model {EDM}. 

| “0 IDataPparameter 

| by *© IJDbDataparameter 3 Exceptions: 


~ de EN 


图 23-5 ”实体 客户 端 层 将 实体 命令 映射 到 基本 的 ADO.NET 数 据 提供 程序 


实体 客户 端 层 一 般 在 后 台 运 行 ， 但 如 果 你 想 完 全 控制 它 的 工作 (如 生成 SQL 查询 和 处 理 数 据 库 返 
回 的 数据 )， 也 可 以 直接 对 其 进行 操作 。 

如 果 你 需要 更 大 程度 地 控制 实体 客户 端 基于 LINQ 查 询 创 建 SQL 语句 的 方式 ， 你 可 以 使 用 Entity 
SQL。Entity SQL 是 直接 作用 于 实体 的 与 数据 库 无 关 的 SQL 方言 。 一 旦 创建 了 一 个 Entity SQL 查询 ， 它 
将 被 直接 发 送 给 实体 客户 端 服务 ( 也 可 以 是 对 象 服务 )， 并 被 转换 为 符合 基本 数据 提供 程序 的 SQL 语 
句 。 本 章 不 会 太 深入 地 介绍 Entity SQL， 只 是 稍 后 会 演示 一 些 使 用 了 这 种 新 的 基于 SQL 的 语法 示例 。 

如 果 你 需要 更 大 程度 地 控制 获取 记录 集 的 操作 方式 ， 你 可 以 不 使 用 数据 库 结 果 在 实体 对 象 上 的 自 
动 映射 , 而 是 使 用 EntityDataReader 类 手动 处 理 这 些 数据 。 毫 无 疑问 ,EntityDataReader 和 SqlDataReader 

只 允许 对 数据 流 进行 只 进 的 、 只 读 的 处 理 。 稍 后 你 将 看 到 关于 这 种 方法 的 示例 。 
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3. *.edmx 文 件 的 作用 

截止 到 目前 ， 我们 所 介绍 的 实体 是 指 客户 端的 类 ， 其 具有 实体 数据 模型 的 功能 。 尽 管 客户 端 实体 
最 终 被 映射 为 正确 的 数据 库 表 ， 但 实体 类 的 属性 名 和 数据 表 的 列 名 之 间 却 并 非 是 紧 耦 合 的 。 

为 了 使 Entity Framework API 能 够 将 实体 类 数据 正确 映射 到 数据 库 表 数 据 , 你 需要 定义 适当 的 映射 
逻辑 。 在 所 有 数据 模型 驱动 的 系统 中 ， 实 体 、 真 正 的 数据 库 以 及 映射 层 都 会 被 划分 为 3 个 相关 的 部 分 : 
概念 模型 、 逻 辑 模型 和 物理 模型 。 

口 概念 模型 定义 了 实体 以 及 它们 之 间 的 关系 ( 如 果 有 的 话 )。 

口 逻辑 模型 将 实体 和 关系 ( 通过 外 键 约束 ) 映射 到 表 。 

口 物理 模型 通过 指定 的 存储 细节 ( 如 表 架 构 、 表 分 割 和 索引 ) 来 表示 特定 的 数据 引擎 的 能 力 。 

在 EF 的 世界 里 ， 这 三 层 均 存放 在 基于 XML 格式 的 文件 里 。 当 使 用 Visual Studio 集 成 的 Entity 
Framework 设 计 器 时 ， 会 得 到 一 个 以 *.edmx 为 扩展 名 的 文件 (EDM 为 entity data model )。 该 文件 包含 实 
体 、 物 理 数 据 库 的 XML 描述 , 并 且 介绍 了 如 何在 概念 模型 和 物理 模型 之 间 映 射 这 些 信 息 。 在 本 章 的 第 
一 个 示例 中 ， 你 将 看 到 *.edmx 文 件 的 格式 。( 马 上 你 就 会 看 到 这 个 示例 。) 

当 使 用 Visual Studio 编 译 基于 EF 的 项 目 时 ，*#.edmx 文 件 将 生成 3 个 独立 的 文件 : 用 于 概念 模型 数 
据 的 *.csdl、 用 于 物理 模型 的 *.ssdl 和 用 于 映射 层 的 *.msl。 然 后 这 3 个 基于 XML 的 文件 将 以 二 进 制 资 
源 的 形式 绑 定 到 应 用 程序 中 。 编译 之 后 ,，.NET 程 序 集中 将 包含 代码 库 中 所 调用 的 EF API 的 所 有 必要 
数据 。 

4. 0bjectContext 和 和 0bjectset<T> 类 的 作用 

EF 的 最 后 一 个 难点 是 0bjectContext 类 , 它 是 System.Data.0bjects 命 名 空间 的 一 员 。 在 生成 *.emdx 
文件 时 , 你 将 得 到 映射 到 数据 库 表 的 实体 类 和 一 个 继承 自 0bjectContext 的 类 。 该 类 通常 用 于 对 象 服务 
与 实体 客户 端 之 间 的 交互 。 

0bjectContext 为 子 类 提供 了 大 量 的 核心 服务 ， 包 括 保存 所 有 更 新 的 功能 〈 用 于 数据 库 更 新 )、 调 
整 连接 字符 串 、 删 除 对 象 、 调 用 存储 过 程 、 处 理 其 他 底层 细节 。 表 23-1 描 述 了 0bjectContext 类 的 部 分 
成 员 ( 注意 ， 在 调用 SaveChanges() 方 法 之 前 ， 大 部 分 成 员 都 将 保留 在 内 存 中 )。 


表 23-1 objectContext 的 常用 成 员 


ObjectContext 的 成 员 售 尺 
AcceptAllChanges() 接受 对 对 象 上 下 文中 的 实体 对 象 所 做 的 所 有 改变 
AddObject() 向 对 象 上 下 文中 添加 一 个 对 象 
Delete0bject() 对 一 个 要 删除 的 对 象 进行 标记 
ExecuteFunction<T>() 执行 数据 库 中 的 一 个 存储 过 程 
ExecuteStoreCommand() 直接 向 数据 库 发 送 一 条 SQL 命令 
GetObjectByKey() 通过 主键 在 对 象 上 下 文中 查询 一 个 对 象 
SaveChanges() 向 数据 库 提交 所 有 更 新 
CommandTimeout 该 属性 为 所 有 对 象 上 下 文 操作 获取 或 设置 以 秒 记 的 超时 值 
Connection 该 属性 返回 当前 对 象 上 下 文 使 用 的 连接 字符 串 


SavingChanges 当 对 象 上 下 文 向 数据 存储 保存 更 改 时 将 触发 该 事件 
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ObjectContext 的 派生 类 作为 一 个 容器 ， 管 理 那些 存储 在 Objectset<T> 集 合 中 的 实体 对 象 。 例 如 ， 
如 果 为 AutoLot 数 据 库 的 Inventory 表 生成 *edmx 文 件 ， 你 (默认 情况 下 ) 最 终 将 得 到 一 个 
AutoLotEntities 类 。 该 类 包含 一 个 Inventories 属 性 (注意 这 里 是 复数 形式 )， 它 封装 了 一 个 
0bjectSet<Inventory> 类 型 的 数据 成 员 。 如 果 为 AutoLot 数 据 库 的 0rders 表 创建 一 个 EDM，AutoLot- 
Entites 类 将 定义 另 一 个 0rders 属 性 ， 它 封装 了 一 个 0bjectSet<0rder> 类 型 的 成 员 变 量 。 表 23-2 显 示 了 
System.Data.0bjects.0bjextSet<T> 的 一 些 常用 成 员 。 


表 23-2 0bjectSet<T> 的 常用 成 员 





0bjectSet<T> 的 成 员 含义 
Addobject() 向 集合 中 插入 一 个 新 的 实体 对 象 
Create0bject<T>() 创建 指定 实体 类 型 的 实例 
DeleteObject 标记 一 个 要 删除 的 对 象 


当 获 取 了 对 象 上 下 文中 正确 的 属性 后 ， 就 可 以 调用 ObjectsetxT> 的 这 些 成 员 了 。 再 次 考虑 本 章 前 
面 提 到 的 示例 代码 : 
using (AutoLotEntities context = new AutoLotEntities()) 
// 使 用 实体 向 Inventory 表 中 添加 一 条 新 的 记录 
context.Cars.AddObject(new Car() { AutoIDNumber = 987, CarColor = "Black", 
MakeOfCar = "Pinto", 


NicknameOfCar = "Pete” }); 
context.SaveChanges(); 


这 里 的 AutoLotEntities 继 承 自 0bjectContext。Cars 属 性 用 来 访问 Objectset<Car> 变 量 。 使 用 该 引 
用 插入 一 个 新 的 Car 实 体 对 象 ， 并 通知 0bjectContext 将 所 有 更 改 保存 到 数据 库 。 

可 以 对 0bjectSet<T> 使 用 LINQ to Entity 查 询 。 这 是 因为 0bjectSsetxT> 支 持 第 12 章 中 所 介绍 的 那些 
扩展 方法 。 此 外 ,0bjectSet<T> 还 从 它 的 直接 父 类 0bjectQuery<T> 中 继承 了 大 量 的 功能 , 后 者 代表 一 个 
强 类 型 的 LINQ (或 Entity SQL ) 查询 。 

5 汇总 

图 23-6 显 示 了 EF API 的 组 织 架 构 。 在 创建 第 一 个 Entity Framework 示 例 之 前 , 我们 先 来 思考 一 下 这 
幅 图 。 

图 23-6 乍 看 上 去 似乎 很 复杂 ， 其 实 不 然 。 例 如 下 面 的 场景 : 你 对 上 下 文中 的 实体 编写 了 一 个 LINQ 
查询 ， 该 查询 被 传递 给 对 象 服务 ， 对 象 服务 将 LINQ 命 令 转 换 为 实体 客户 端 可 以 理解 的 树 。 然 后 ， 实 
体 客 户 端 将 树 转换 为 符合 ADO.NET 提 供 程 序 的 SQL 语句 。 提 供 程序 返回 一 个 数据 读 取 器 ( 如 一 个 
DbDataReader 的 派生 对 象 )， 客 户 端 服 务 使 用 该 读 取 器 ( EntityDataReader ) 将 数据 传人 对 象 服务 。 最 
终 C# 代 码 库 所 得 到 的 是 实体 数据 的 枚 举 ( IEnumerable<T> )。 

还 有 一 种 情况 ， 如 果 你 的 C# 代 码 库 希望 对 客户 端 服务 创建 的 发 送 到 数据 库 的 SQL 语句 进行 更 多 地 控 
制 ， 你 可 以 编写 C# 代 码 直 接 将 Entity SQL 传递 给 实体 客户 端 或 对 象 服务 。 最 终 得 到 的 也 是 一 个 


IEnumerable<T>。 
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Ut 
: ITEnumerablex<T> 
对 象 服务 
命令 树 
Ek 
实体 客户 端 数据 提供 器 
命令 树 
DbDataReader 
ADO.NET 数 据 提供 器 


物理 数据 库 










ntityDataReader 







图 23-6 ADO.NET Entity Framework 的 主要 组 件 


在 这 两 种 情况 下 , 你 都 必须 使 客户 端 服务 理解 *.edmx 文 件 中 的 XML 数 据 ， 即 如 何 将 数据 库 原子 映 
射 到 实体 。 最 后 要 记 住 的 是 ， 客 户 端 (如 C# 代 码 库 ) 还 可 以 使 用 EntityDataReader 直 接 从 实体 客户 端 
获取 数据 。 


23.2 创建 和 分 析 EDM 


我 们 已 经 对 ADO.NET Entity Framework 的 功能 和 工作 方式 有 了 很 深入 的 了 解 ， 现 在 来 看 一 个 完整 
的 示例 。 简 便 起 见 ， 我 们 将 创建 一 个 只 允许 访问 AutoLot 库 中 Inventory 表 的 EDM。 在 理解 了 这 些 基础 
知识 之 后 ， 你 可 以 为 整个 AutoLot 库 创建 EDM， 并 在 图 形 界面 中 显示 这 些 数据 。 

1. 生成 *.edmx 文 件 

新 建 一 个 名 为 InventoryEDMConsoleApp 的 控制 台 应 用 程序 。 在 使 用 Entity Framework 时 ， 第 一 个 
步骤 就 是 创建 由 *.edmx 文 件 定义 的 概念 、 逻 辑 、 物 理 模型 数据 。 可 以 使 用 NET Framework 4.5 SDK 命 
令 行 工具 EdmGen.exe 来 创建 *.edmx 文 件 。 打 开 Developer Command Prompt 并 输入 如 下 指令 : 

EdmGen.exe -? 

你 会 发 现 一 个 指令 选项 的 列表 ， 你 可 以 使 用 这 些 选 项 为 一 个 已 有 的 数据 库 生 成 必要 的 文件 ; 还 
有 一 些 选项 可 以 用 来 根据 已 知 的 实体 文件 生成 新 的 数据 库 。 表 23-3 列 出 了 EdmGen.exe 的 一 些 常 用 
选项 。 
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表 23-3 ”常用 的 EdmGen.exe 命 令 行 标记 





EdmGen.exe 选 项 含 义 
/mode:FullGeneration 为 指定 的 数据 库 生成 *.ssdl、*.msl1、*#.csdl 文 件 和 客户 端 实体 
/project: 用 来 生成 代码 和 文件 的 基本 名 称 ， 通 常 为 提取 数据 的 数据 库 名 称 ( 可 简写 为 /p: ) 
/connectionstring: 用 来 与 数据 库 交互 的 连接 字符 串 ( 可 简写 为 /c: ) 
/language: 指定 生成 的 代码 为 C# 还 是 VB 
/pluralize 只 用 英语 语法 规则 ， 对 实体 集合 名 、 实 体 类 型 名 以 及 导航 属性 自动 单数 化 或 复数 化 


对 于 .NET 4.0 来 说 ，EF 编 程 模型 支持 领域 先行 的 编程 ， 这 人 允许 我 们 先 创建 实体 ( 典型 的 面向 对 象 
技术 ) 然后 生成 全 新 的 数据 库 。 在 本 章 对 ADO.NET EF 的 介绍 中 , 我 们 将 不 使 用 这 种 模型 先行 的 思想 ， 
也 不 会 使 用 EdmGen.exe 生 成 客户 端 实体 模型 ， 而 是 使 用 Visual Studio 中 的 图 形 化 EDM 设 计 器 。 

单 击 Project 一 Add New Item... 菜 单项 ,插入 一 个 新 的 ADO.NET 实 体 数据 模型 项 InventoryEDM. 
edmx( 记 住 要 选择 Data 节 点 ， 如 图 23-7 所 示 )。 





i 
Search Installed Femplates 
Type: Visual Cz tems 


A project tem fof cresting an ADO.NET 
Entity Data Model, 


图 23-7 ”为 项 目 插入 一 个 新 的 ADO.NET EDM 项 


单 击 Add 按 钮 启动 Entity Model Data 向 导 。 该 向 导 第 一 个 步骤 是 让 你 选择 是 从 已 有 数据 库 生 成 
EDM， 还 是 定义 一 个 空 模型 ( 为 模型 先行 开发 提供 的 支持 ) 。 选 择 Generate from database 选 项 ， 单 击 
Next 按 钮 ( 如 图 23-8 所 示 )。 

在 向 导 的 第 二 个 步骤 中 可 以 选择 数据 库 。 在 下 拉 列 表 中 将 列 出 所 有 在 Visual Studio Server Explorer 
中 已 有 的 数据 库 连接 。 如 果 下 拉 列 表 中 没有 ， 可 以 单 击 New Connection 按 钮 。 接 下 来 选择 AutoLot 数 据 
库 ， 然 后 选择 在 ( 自动 生成 的 ) App.config 文 件 中 保存 连接 字符 串 数据 ( 如 图 23-9 所 示 ) 。 
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:> 


What should the model contain? 


| 国 国 


Empty model 





Creates an entity model from a database, Object-layer code is generated from the model, This option also 
tets you specify the database connection, settings for the model, and database objects to inciude in the 
model, 





希 :， Choose Your Data Connection 


Which data connection should your appjication use to Connect to the database? 
[manuandrew-pe\sqlexpress.AutoLot.dbo 








Entity conmection string: 


metadata=res://*/InventoryEDM2.csdilresy//*/InventoryEDM2.ssdl] 


res/ /InventoryEDM2.msi:provider= System.Data.SqlClient:provider connection stfing= "data source= 
{local)\SQLEXPRESS;initial catalog=AutoL ot;integrated 


security= True;MultipleActiveResultSets=TrueApp=EntityFramework” 





i 7 
本 Save entity connection settings in App.Config as: 


AutoLotEntities 





图 23-9 ”选择 要 生成 EDM 的 数据 库 
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在 单 击 Next 按 钮 之 前 ， 先 检查 一 下 连接 字符 串 的 格式 : 


metadata=res://*/InventoryEDM.csdl|res://*/InventoryEDM.ssdl|res://*/InventoryEDM.ms]l; 
provider=System.Data.SqlClient;provider connection string= 
"Data Source=(local)\SQOLEXPRESS; 
Initial Catalog=AutoLot;Integrated Security=True;Pooling=False" 


由 于 机 器 配置 不 同 ， 连 接 也 会 有 所 区 别 。 注 意 这 里 的 metadata 标 记 ， 它 用 来 标识 概念 文件 、 物 理 
文件 、 映 射 文件 等 戏 入 的 XML 资源 数据 的 名 称 。 ( 前 面 曾经 介绍 过 ，*.edmx 文 件 在 编译 时 将 被 拆 分 成 
3 个 独立 的 文件 ， 这 些 文件 中 的 数据 将 以 二 进 制 资 源 的 形式 能 人 到 程序 集中 。) 

在 向 导 的 最 后 一 个 步骤 中 ， 可 以 从 数据 库 中 选择 要 生成 EDM 的 项 。 在 本 例 中 我 们 只 关注 Inventory 
表 ( 如 图 23-10 所 示 )。 








| Which database objects do you want to include in your modeB 
2] | 
Yl 的 dbo : 
[TY CreditRisks | 
门人 Customers | 
| [VE Inventory i 
| 3 Orders 
| 2 sysdiagrams 
Py Views 
Ny Stored Procedures and Functions 

























ee de pn A 


中 Pluralize or singularize generated object names 





"| v Include foreign key columns in the model 
Import selected stored procedures and functions into the entity model 







| Model Namespace: 
AutoLotModel 

















图 23-10 选择 数据 库 项 


现在 ， 单 击 Finish 按 钮 生成 EDM 数 据 。 

2. 改造 实体 数据 

完成 向 导 之 后 ，IDE 将 打开 EDM 设 计 器 ， 可 以 看 到 一 个 单独 的 实体 Inventory。 使 用 Entity Data 
Model Browser 窗 口 可 以 浏览 设计 器 中 任意 实体 的 结构 ( 打开 View 一 Other Windows 菜 单 选项 )。 代 表 
Inventory 数 据 库 表 的 概念 模型 位 于 Entity Types 文 件 夹 下 ( 如 图 23-11 所 示 )， 而 该 数据 库 的 物理 模型 位 
于 Store 节 点 下 ， 其 具体 名 称 取决 于 数据 库 本 身 的 名 称 ( 本 例 中 为 AutoLotModel.Store )。 

默认 情况 下 ,实体 的 名 称 取决 于 原始 的 数据 库 对 象 的 名 称 。 但 概念 模型 中 实体 的 名 称 是 没有 约束 
的 。 你 可 以 更 改 实体 名 称 及 其 属性 的 名 称 ， 即 在 设计 器 中 选中 一 项 ， 然 后 在 Visual Studio 的 Properties 
窗口 中 修改 Name 属 性 的 值 。 接 下 来 ,我 们 将 Inventory 实 体 改 名 为 Car ,将 PetName 属 性 改名 为 CarNickname 
( 如 图 23-12 所 示 )。 


768 第 23 章 ADO.NET 之 三 : Entity Framework 





InventoryEDM.edmx [InventoryEDM]” 中 X Object Brows 


和 MODEL 
Type here to search 


4 + InventoryEDM.edmx 
4 着 Diacrams 





图 23-11 Entity 设计 器 和 Model Browser 窗 口 


路 食 
; Concurrency Mode None 

. Default Value (None) 
b Documentation 
Entity Key 
~ Fixed Length 

Getter 

Max Length 


Name 








The name of the property. 


图 23-12 ”在 Properties 窗 口中 修改 实体 








$I 
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这 时 ， 概 念 模 型 如 图 23-13 中 所 示 。 


| 5 properties 
时 CarD 
Make 
有 Colcr 

hE CarNickname 


= Navigaticn 








0 3 


图 23-13 ”客户 端 模 型 ， 为 匹配 业务 领域 而 进行 了 改造 


在 设计 器 中 选择 整个 Car 实 体 ， 再 查看 Properties 窗 口 。 你 会 发 现 Entity Set Name 字 段 也 从 Inven- 
tories 改 为 Cars (如 图 23-14 所 示 )。Entity Set 的 值 是 很 重要 的 ， 因 为 它 与 数据 上 下 文 类 的 属性 名 相 
对 应 ， 而 且 可 以 用 于 修改 数据 库 。0bjectContext 派 生 类 的 这 个 属性 封装 了 一 个 0bjectSet<T> 成 员 
变量 。 

编译 应 用 程序 , 然后 刷新 代码 库 ， eal edmx 文 件数 据 生 成 的 *.csdl 、*.msdl、*.ssdl 文 件 。 


: PROPERTIES < 2 
| AutoLotModel.Car EntityType 


gi a 
ACCess Public 
Base Type {None) 

多 Documentation 


Fil Color 
Name 


‘EntitySetName a | 
.The name of the EntitySet that contains instances of 
| the slty, 





图 23-14 sp hootara nh 性 名 称 


3. 查看 映射 

修改 了 数据 之 后 ， 你 可 以 通过 Mapping Details 窗 口 ( 打开 View 一 Other Windows... 菜 单项 ) 来 浏览 
概念 层 和 物理 层 之 间 的 映射 。 如 图 23-15 所 示 , 树 左 侧 的 节点 代表 物理 层 中 的 数据 名 称 , 而 右 侧 节点 代 
表 概 念 模型 的 名 称 。 
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2» MAPPING DETANS = CAR Cemetary 





B Column Operator Value/ Property 
下 4 Tables 
4 Maps to inventory | 
| <Add a Condition> | 
4 盯 Coilumn Mappings 

短 ] CadD :int 4 给 CadD :Int32 

四 Make : varchar 4 而 Make: String 

四 Cotor: varchar 4 而 Color: String 





是 |PetName: varchar CaNicknane :Sting 二 
图 <Add a Tabile or View> 





ERROR LIST OUTPUT MAPPING DETAILS 


图 23-15 ”Mapping Details 窗 口 显示 了 概念 模型 和 物理 模型 的 映射 


4. 查看 生成 的 *.edmx 文 件 的 数据 

现在 我 们 来 看 看 EDM 向 导 为 我 们 生成 了 什么 。 在 Solution Explorer 中 右 击 InventoryEDM.edmx 文 
件 ， 选择 Open With... 菜 单项 。 在 弹出 的 对 话 框 中 选择 XML (Texb Editor 选 项 。 这 样 我 们 就 可 以 在 EDM 
设计 器 中 查看 实际 的 XML 数据 。 该 XML 文档 的 结构 位 于 <edmx:Edmx> 根 元 素 内 。 

该 根 元 素 包 含 两 个 子 元 素 。<edmx:Runtime> 包 含 应 用 程序 在 运行 时 使 用 的 元 数据 ，<Designer> 包 


含 Visual Studio 在 开发 时 使 用 的 元 数据 。 
在 tedmx:Runtime> 元 素 内 包含 三 个 子 元 素 , 分 别 描述 物理 存储 模型 、 逻 辑 C# 对 象 模型 以 及 它们 之 


间 的 映射 。 我 们 先 来 看 看 存储 模型 元 数据 。 


《<1-- SSDL 内 容 --> 
<edmx: StorageModels> 
<Schema Namespace="AutoLotModel.Store" Alias="Self" 
Provider="System.Data.SqlClient" 
ProviderManifestToken="2008" 
xmlns:store= 
"http://schemas.microsoft.com/ado/2007/12/edm/EntityStoreSchemaGenerator" 
xmlns="http://schemas.microsoft.com/ado/2009/02/edm/ssdl"> 
<EntityContainer Name="AutoLotModelStoreContainer"> 
<EntitySet Name="Inventory" EntityType="AutoLotModel.Store.Inventory" 
store:Type="Tables" Schema="dbo" /> 
</EntityContainer> 
<EntityType Name="Inventory"> 
<Key> 
<PropertyRef Name="CarID" /> 
</Key> 
<Property Name="CarID" Type="int" Nullable="false" /> 
<Property Name="Make" Type="varchar" Nullable="false" MaxLength="50" /> 
<Property Name="Color" Type="varchar" Nullable="false" MaxLength="50" /> 
<Property Name="PetName" Type="varchar" MaxLength="50" /> 
</EntityType> 
</Schema> 
</edmx:StorageModels> 


注意 ,Schema> 节 点 中 定义 了 ADO.NET 数 据 提 供 程序 的 名 称 , 在 与 数据 库 ( System.Data.SqlClient ) 
通信 时 会 用 到 这 些 信息 。<EntityType> 节 点 标记 了 物理 数据 库 表 的 名 称 以 及 表 中 各 列 的 名 称 。 
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*.edmx 文 件 中 下 一 个 重要 的 部 分 是 cedmx:ConceptualModels> 元 素 ， 它 定义 了 更 改过 的 客户 端 实 
体 。 注 意 ，Cars 实 体 定义 了 CarNickname 属 性 ， 这 是 我 们 在 设计 器 中 修改 过 的 : 


《1--CSDL 内 容 --> 
<edmx:ConceptualModels> 
《Schema Namespace="AutoLotModel" Alias="Self" 
xmlns:annotation="http://schemas.microsoft.com/ado/2009/02/edm/annotation" 
xmlns="http://schemas.microsoft.com/ado/2008/09/edm"> 
<EntityContainer 
Name="AutoLotEntities" annotation:LazyLoadingEnabled="true"> 
<EntitySet Name="Cars" EntityType="AutoLotModel.Car”" /> 
</EntityContainer> 
<EntityType Name="Car"> 
<Key> 
<PropertyRef Name="CarID" /> 
</Key> 
<Property Name="CarID" Type="Int32" Nullable="false" /> 
<Property Name="Make" Type="String" Nullable="false" MaxLength="50" 
Unicode="false" FixedLength="false" /> 
<Property Name="Color" Type="String" Nullable="false" MaxLength="50" 
Unicode="false" FixedLength="false" /> 
<Property Name="CarNickname" Type="String" MaxLength="50" 
Unicode="false" FixedLength="false" /> 
</EntityType> 
</Schema> 
</edmx:ConceptualModels> 


这 之 后 是 映射 层 ，Mapping Details 和 窗口 (以 及 EF 运行 时 ) 使 用 映射 层 来 联系 概念 模型 和 物理 模型 
的 名 称 : 


<1-- C-S 映 射 内 容 --> 
<edmx:Mappings> 
<Mapping Space="C-S" 
xmlns="http://schemas.microsoft.com/ado/2008/09/mapping/cs"> 
<EntityContainerMapping StorageEntityContainer="AutoLotModelStoreContainer" 
CdmEntityContainer="AutoLotEntities"> 
<EntitySetMapping Name="Cars"> 
<EntityTypeMapping TypeName="AutoLotModel .Car"> 
<MappingFragment StoreEntitySet="Inventory"> 
<ScalarProperty Name="CarID" ColumnName="CarID" /> 
<ScalarProperty Name="Make" ColumnName="Make" /> 
<ScalarProperty Name="Color" ColumnName="Color" /> 
<ScalarProperty Name="CarNickname" ColumnName="PetName" /> 
</MappingFragment> 
</EntityTypeMapping> 
</EntitySetMapping> 
</EntityContainerMapping> 
</Mapping> 
</edmx:Mappings> 


*.edmx 文 件 的 最 后 一 部 分 是 <Designer> 元 素 ，EF 运 行 时 并 不 使 用 这 些 数据 。 查 看 该 数据 你 会 发 现 
它 包含 了 一 些 指令 ，Visual Studio 使 用 这 些 指令 在 可 视 的 设计 器 界面 上 显示 实体 。 

确保 项 目 至 少 被 编译 过 一 次 ， 然 后 单 击 Solution Explorer 中 的 Show All Files 按 钮 。 然 后 打开 
obj\Debug 文 件 夹 ， 进 入 edmxResourcesToEmbed 子 目录 。 在 该 目录 下 你 会 发 现 基 于 整个 *.edmx 文 件 而 
生成 的 3 个 XML 文件 (如 图 23-16 所 示 )。 

这 些 文件 中 的 数据 将 以 二 进 制 的 形式 租 入 到 程序 集中 。 因 此 ，.NET 应 用 程序 具备 所 有 用 于 理解 
EDM 中 概念 、 物 理 和 映射 层 的 信息 。 
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Solution ‘InventoryEDMConsoleApp' (1 project) 
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nventoryEDMConsoleApp.exe 
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赤子 
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图 23-16 ”使 用 *.edmx 文 件 生成 3 个 独立 的 XML 文 件 


5. 查看 生成 的 源 代码 

你 已 经 准备 好 用 EDM 来 编写 一 些 代 码 了 。 但 在 这 之 前 你 应 该 检查 一 下 生成 的 C# 代 码 。 打 开 Class 
View 窗 口 ， 展 开 默 认 的 命名 空间 。 你 会 发 现 除了 program 类 以 外 ，EDM 向 导 还 生成 了 一 个 实体 类 ( 被 
更 名 为 Car ) 以 及 AutoLotEntities 类 。 

如 果 回 到 Solution Explorer 展 开 InventoryEDM.edmx 节 点 ， 你 会 发 现 一 个 用 于 IDE 维 护 的 文件 
InventoryEDM.Designer.cs。 和 其 他 用 于 IDE 维 护 的 文件 一 样 ， 你 不 能 直接 编辑 该 文件 ， 因 为 在 每 次 
编译 时 IDE 都 会 重新 创建 该 文件 。 但 你 可 以 双击 来 浏览 它 的 内 容 。 

AutoLotEntites 类 扩展 了 EF 编程 模型 的 入 口 点 0bjectContext 类 。AutoLotEntities 的 构造 函数 提供 
了 多 种 方式 来 输入 连接 字符 串 数据 。 默 认 的 构造 函数 将 自动 从 App.config 文 件 读 取 连接 字符 串 数据 : 

public partial class AutoLotEntities : ObjectContext 

public AutoLotEntities() : base("name=AutoLotEntities", "AutoLotEntities") 
k this.ContextOptions.LazyLoadingEnabled = true; 
OnContextCreated(); 


注意 , AutoLotEntites 类 的 Cars 属 性 封装 了 0bjectSet<Car> 数 据 成 员 。, 你 可 以 使 用 该 属性 访问 EDM 
模型 ， 来 间接 修改 后 台数 据 库 : 
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public partial class AutoLotEntities : ObjectContext 


”public ObjectSet<Car> Cars 
{ 
get 
{ 
if ((_Cars == null)) 
_Cars = base.CreateObjectSet<Car> ("Cars"); 


return (Cars; 


private ObjectSet<Car> Cars; 





说 明 ”你 还 会 在 0bjectContext 派 生 类 中 看 到 一 些 以 AddTo 开 头 的 方法 ， 可 以 用 来 向 0bjectSet<T> 成 员 
变量 中 添加 新 的 实体 。 不 过 推荐 的 方法 是 使 用 通过 强 类 型 属性 得 到 的 0bjectSet<T> 成 员 。 


最 后 在 设计 器 代码 文件 中 还 有 一 个 有 趣 的 东西 就 是 Car 实 体 类 。 实 体 类 中 的 大 部 分 代码 都 是 构成 概 
念 模型 的 属性 集合 。 每 个 属性 的 set 逻 辑 都 调用 了 EF API 的 Structural0bject.SetValidValue() 静 态 方法 。 

并 且 ，set 逻 辑 中 的 代码 还 会 将 实体 状态 的 改变 通知 给 EF 运行 时 。 这 是 十 分 重要 的 ， 因 为 
0bjectContext 必 须知 道 这 些 改变 ， 并 将 它们 更 新 到 物理 数据 库 。 

此 外 , set 的 逻辑 中 还 调用 了 两 个 分 部 方法 。C# 分 部 方法 提供 了 在 应 用 程序 中 处 理 更 改 通知 的 简单 
方式 。 如 果 没 有 实现 分 部 方法 ， 编 译 器 将 忽略 这 个 调用 。 下 面 是 Car 实 体 类 的 CarNickname 属 性 的 实现 

public partial class Car : EntityObject 


”public global: :System.Sstring CarNickname 
get 
return CarNickname; 
Set 


OnCarNicknameChanging(value); 
ReportPropertyChanging("CarNickname"); 

_CarNickname = StructuralObject.SetValidValue(value, true); 
ReportPropertyChanged("CarNickname"); 
OnCarNicknameChanged(); 


private global::System.String CarNickname; 
partial void OnCarNicknameChanging(global::System.String value); 
partial void OnCarNicknameChanged(); 


6. 强化 生成 的 代码 
设计 器 生成 的 所 有 的 类 都 使 用 partial 关 键 字 声明 , 这 允许 我 们 在 多 个 C# 代 码 文件 中 实现 这 些 类 。 
这 在 使 用 EF 编 程 模型 时 是 非常 有 用 的 ， 因 为 这 意味 着 你 可 以 为 实体 类 添加 “真正 ”的 方法 ， 从 而 更 好 
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地 对 业务 领域 进行 建 模 。 

在 本 例 中 ,我们 重 写 car 实 体 类 的 Tostring() 方 法 ， 返 回 一 个 格式 化 的 字符 串 来 描述 实体 的 状态 。 
我 们 还 完成 了 部 分 方法 OnCarNicknameChanging() 和 OnCarNicknameChanged() 的 定义 ,可 以 完成 简单 的 通 
知 操作 。 我 们 在 新 的 Car.cs 文 件 中 定义 的 部 分 类 声明 如 下 : 

public partial class Car 

public override string Tostring() 
// 由 于 PetName 列 可 能 为 空 字符 囊 ， 因 此 提供 默认 值 “**No Name**” 
return string.Format("{0} is a {1} {2} with ID {3}.", 
this.CarNickname ?? "**No Name**", 
this.Color, this.Make, this.CarID); 
} 
partial void OnCarNicknameChanging(global::System.String value) 
Console.WriteLine("\t-> Changing name to: {0}", value); 
partial void OnCarNicknameChanged() 
Console.WriteLine("\t-> Name of car has been changed!"); 

} 

友情 提示 : 在 实现 这 些 方法 之 后 ， 你 得 到 的 通知 是 指 实体 类 的 属性 已 经 被 修改 或 将 要 被 修改 ， 而 
不 是 指 物理 数据 库 已 经 被 修改 。 如 果 你 需要 知道 物理 数据 库 是 否 被 修改 , 可 以 使 用 ObjectContext 派 生 
类 的 SavingChanges 事 件 处 理 程序 。 
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现在 我 们 可 以 写 一 些 与 EDM 交 互 的 代码 了 。 修 改 Program 类 ， 在 Main() 方 法 中 调用 两 个 辅助 方法 。 
其 中 一 个 辅助 方法 使 用 概念 模型 打印 Inventory 数 据 库 表 的 所 有 记录 ， 另 一 个 辅助 方法 向 Inventory 表 
中 插入 一 条 新 的 记录 ， 如 下 所 示 : 


class Program 
static void Main(string[] args) 


Console.WriteLine("***** Fun with ADO.NET EF *****\n"); 
AddNewRecord( ); 

printAllInventory(); 

Console.ReadLine(); 


private static void AddNewRecord() 


{ 
// 向 AutoLot 数 据 库 的 Inventory 表 添加 一 条 记录 
using (AutoLotEntities context = new AutoLotEntities()) 


try 


{ 
// 对 新 的 记录 进行 硬 编码 ， 仅 供 测 试 
context.Cars.AddObject(new Car() { CarID = 2222， 
Make = "Yugo", Color = "Brown" }); 
context .SaveChanges(); 
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catch(Exception ex) 
Console.WritelLine(ex.InnerException.Message); 


} 
} 


private static void PrintAllInventory() 


// 选择 AutoLot 中 Inventory 表 的 所 有 记录 ， 并 使 用 Car 实 体 类 的 自 定义 Tostring() 方 法 打印 其 数据 
using (AutoLotEntities Context = new AutoLotEntities()) 


foreach (Car c in context.Cars) 
Console.WritelLine(c); 


} 
} 


在 前 面 你 看 到 过 类 似 的 代码 ， 不 过 现在 你 应 该 已 经 更 清楚 其 工作 原理 了 。 每 个 辅助 方法 都 创建 了 
一 个 0bjectContext 派 生 类 ( AutoLotEntities ) 实例 。 并 使 用 强 类 型 的 Cars 属 性 来 与 0bjectSet<Car> 字 
段 进 行 交 互 。 在 对 Cars 属 性 进行 枚 举 时 ， 将 会 间接 向 ADO.NET 数 据 提 供 程序 提交 一 条 SQL SELECT 语 
句 。 在 使 用 0bjectSet<Car> 的 Addobject() 方 法 插入 新 的 car 对 象 然后 调用 上 下 文 的 SaveChanges() 方 法 
时 ， 你 实际 上 执行 了 一 条 SQL INSERT 语 句 。 

1. 删除 记录 

当 你 想 在 数据 库 中 删除 某 条 记录 时 ， 首 先 要 在 objectsetcT> 中 找到 正确 的 项 ， 这 可 以 使 用 
Get0bjectByKey() 方 法 ， 并 传递 一 个 EntityKey 对 象 ( 位 于 System.Data 命 名 空间 )。 假 设 已 经 在 C# 代 码 
文件 中 引入 了 该 命名 空间 ， 辅 助 方法 的 代码 如 下 : 

private static void RemoveRecord() 


{ 
// 通过 主键 查找 要 删除 的 汽车 


using (AutoLotEntities context = new AutoLotEntities()) 


// 为 查找 的 实体 定义 主键 
EntityKey key = new EntityKey("AutoLotEntities.Cars", "CarID", 2222); 


// 查找 实体 ， 如 果 存 在 的 话 将 其 删除 

Car carToDelete = (Car)context.GetObjectByKey(key); 
if (carToDelete != null) 

{ 


context.DeleteObject(carToDelete); 
context .SaveChanges(); 


} 
} 





说 明 无 论 是 好 是 坏 , 调用 Get0bjectByKey() 会 在 删除 对 象 之 前 访问 一 次 数据 库 。 

注意 , 在 创建 EntityKey 对 象 时 , 你 需要 使 用 一 个 string 对 象 通知 构造 函数 使 用 ObjectContext 派 生 
类 的 哪个 0bjectSset<T>。 第 二 个 参数 也 是 string， 表 示 实 体 类 中 标记 为 主键 的 属性 名 称 。 构 造 函 数 的 
最 后 一 个 参数 是 主键 的 值 。 找 到 要 删除 的 对 象 后 ,调用 上 下 文 的 Delete0bject() 方 法 ,然后 保存 更 改 。 
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2. 更 新 记录 
更 新 记录 也 是 很 简单 的 。 先 定位 对 象 ， 设 置 其 属性 值 ， 然 后 保存 更 改 ， 如 下 所 示 : 


private static void UpdateRecord() 


攻 
// 通过 主键 查找 要 更 新 的 汽车 
using (AutoLotEntities context = new AutoLotEntities()) 


// 为 查找 的 实体 定义 主键 
EntityKey key = new EntityKey("AutoLotEntities.Cars", "CarID", 2222); 


// 获取 实体 ， 更改 并 保存 
Car carToUpdate = (Car)context.GetObjectByKey(key); 
if (carToUpdate != null) 


carToUpdate.Color = "Blue"; 
context.SaveChanges(); 


} 
} 


这 个 方法 看 上 去 有 点 奇怪 , 但 如 果 你 意识 到 Get0bjectByKey() 方 法 返回 的 实体 对 象 是 0bjectSet<T> 
字段 中 一 个 某 个 对 象 的 引用 的 话 ， 就 不 会 再 有 这 种 疑虑 了 。 在 你 设置 属性 改变 实体 状态 的 时 候 ， 你 也 
在 更 改 内 存 中 的 同一 个 对 象 。 





说 明 和 ADO.NET 的 DataRow 对 象 一 样 ， 任 何 Entity0bject 的 子 类 ( 即 所 有 实体 类 ) 都 包含 一 个 
EntityState 属 性 。 对 象 上 下 文 使 用 该 属性 来 判断 该 实体 是 否 被 修改 、 删 除 、 拆 分 ( detach )， 
等 等 。 这 是 使 用 这 种 编程 模型 的 默认 设置 ， 当 然 你 可 以 根据 需要 手动 进行 修改 。 





3. 用 LINQ to Entites 进 行 查询 

到 目前 为 止 ， 我 们 已 经 通过 一 些 关于 对 象 上 下 文 和 实体 对 象 的 示例 学 习 了 如 何 进行 查询 、 插 人、 
更 新 和 删除 。 这 都 是 很 有 用 的 ， 但 其 实 EF 在 和 LINQ 查 询 一 起 使 用 的 时 候 才 会 更 强大 。 如 果 打 算 使 用 
LINQ 来 更 新 或 删除 记录 ， 你 就 无 需 再 手动 创建 一 个 Entitykey 对 象 。 考 虑 下 面 这 个 修改 后 的 
RemoveRecord() 方 法 ， 它 将 不 会 按照 预期 那样 工作 : 

private static void RemoveRecord() 


{ 
// 通过 主键 查找 要 删除 的 汽车 
using (AutoLotEntities context = new AutoLotEntities()) 


// 判断 实体 是 否 存在 


var carToDelete = from c in context.Cars where c.CarID == 2222 select cj; 
if (carToDelete != null) 


context.DeleteObject(carToDelete); 
context.SaveChanges(); 


J 
} 
3 
这 段 代码 可 以 通过 编译 , 但 在 调用 Delete0bject() 方 法 时 会 抛 出 运行 时 异常 。 理 由 是 LINQ 查 询 返 
回 的 是 0bjectQuery<T> 对 象 ， 而 不 是 car 对象。 要 记 住 使 用 LINQ 查 询 定 位 实体 时 ， 得 到 的 是 一 个 
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0bjectQuery<T> 对 象 ， 它 代表 能 够 返回 所 需 数据 的 查询 。 要 执行 查询 ( 并 返回 car 实 体 )， 就 必须 调用 
查询 对 象 的 某 个 方法 ， 如 FirstorDefault()。 示 例如 下 : 


var carToDelete = 
(from c in context.Cars where c.CarID == 2222 select c).FirstOrDefault(); 


通过 调用 objectQueryxT> 的 FirstOrDefault() 可 以 找到 所 需 的 项 ， 而 如 果 没 有 ID 为 2222 的 Car， 那 
么 默认 的 值 为 nul1。 

由 于 在 第 13 章 已 经 学 习 了 大 量 的 LINQ 表 达 式 ， 再 举 几 个 例子 应 该 就 足够 了 : 

private static void FunWithLINQQueries() 


using (AutoLotEntities context = new AutoLotEntities()) 


// 获取 新 数据 的 投影 

Var colorsMakes = from item in context.Cars select 
new { item.Color, item.Make }; 

foreach (var item in colorsMakes) 


Console.WritelLine(item); 


// 只 获取 CarID < 1000 的 记录 

var idsLessThan1000 = from item in context.Cars 
where item.CarID < 1000 select item; 

foreach (var item in idsLessThan1000) 


Console.Writeline(item); 


} 
} 
虽然 这 些 查 询 的 语法 很 简单 ， 但 要 记 住 每 当 你 对 对 象 上 下 文 执 行 一 次 LINQ 查 询 时 都 会 访问 一 次 
数据 库 。 当 你 希望 对 数据 执行 LINQ 查 询 并 得 到 一 个 单独 的 副本 时 ， 你 需要 使 用 ToList<T>()、 
ToArray<T>()、ToDictionary<K,V>() 等 扩展 方法 来 立即 执行 这 些 查 询 。 下 面 的 代码 修改 了 前 面 的 方法 ， 
它 执行 一 个 等 价 的 SELECT * 语 句 ， 将 实体 缓存 到 数组 中 ， 然 后 使 用 LINQ to Object 对 数组 进行 操作 : 
using (AutoLotEntities context = new AutoLotEntities()) 
// 获取 Inventory 表 中 的 所 有 数据 
// 也 可 以 写成 


//var allData = (from item in context.Cars select ite).ToArray(); 
var allData = context.Cars.ToArray(); 


// 获取 新 数据 的 投影 
var colorsMakes = from item in allData select new { item.Color, item.Make }; 


// 只 获取 CarID < 1000 的 记录 
var idsLessThan1000 = from item in allData where 
item.CarID < 1000 select item; 


如 果 EDM 中 包含 多 个 相关 的 表 , 使 用 LINQ to Entity 将 更 有 吸引 力 , 稍 后 将 看 到 这 方面 的 示例 。 不 
过 这 个 示例 将 暂时 告 一 段落 。 我 们 来 看 看 与 对 象 上 下 文 交 互 的 其 他 两 种 方式 。 

4. 使 用 Entity SQL 进 行 查询 

可 以 肯定 的 是 ， 大 部 分 时 间 你 都 会 使 用 LINQ 来 查询 0bjectSet<T>。 实 体 客 户 端 会 将 你 的 LINQ 查 
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询 转换 成 适合 的 SQL 语句 ， 并 将 其 传递 给 数据 库 进行 处 理 。 但 如 果 你 想 对 查询 的 格式 有 更 多 的 控制 ， 
可 以 使 用 Entity SQL。 

Entity SQL 是 一 门 可 用 于 实体 的 类 SQL 查询 语言 。 虽 然 Entity SQL 语句 的 格式 与 传统 的 SQL 语句 十 
分 类 似 , 但 他 们 其 实 是 不 同 的 。Entity SQL 有 独特 的 语法 ， 这 是 因为 查询 的 对 象 是 实体 而 不 是 物理 数 
据 库 。 与 LINQ to Entity 查 询 类 似 ，Entity SQL 查询 也 将 生成 “真正 ”的 SQL 查询 。 

本 章 只 介绍 一 个 简单 的 示例 ， 而 不 会 深入 介绍 创建 Entity SQL 命令 的 细节 ， 更 详细 的 内 容 请 参 
阅 .NET Framework 4.5 SDK 文 档 。 考 虑 下 面 的 方法 ， 它 创建 了 一 个 Entity SQL 语句 ， 用 来 查找 
0bjectset<Car> 集 合 中 所 有 黑色 的 轿车 : 


private static void FunWithEntitySQL() 
using (AutoLotEntities context = new AutoLotEntities()) 


// 构建 一 个 包含 Entity SQL 语法 的 字符 串 
string query = "SELECT VALUE car FROM AutoLotEntities.Cars "+ 
"AS car WHERE car.Color='black'"; 


// 现在 基于 该 字符 串 构建 一 个 ObjectQuery<Ty> 
var blackCars = context.CreateQuery<Car> (query); 
foreach (var item in blackCars) 


Console.WritelLine(item); 


} 
} 


注意 ， 我 们 将 一 个 格式 化 的 Entity SQL 语句 作为 参数 传递 给 了 对 象 上 下 文 的 CreateQueryxT> 方 法 。 

5. 使 用 实体 客户 端的 数据 阅读 器 对 象 

当 使 用 LINQ to Entity 或 Entity SQL 时 ， 得 到 的 数据 将 被 自动 映射 为 实体 类 ， 这 要 感谢 实体 客户 端 
服务 。 通 常情 况 下 这 就 是 我 们 想 要 的 ， 然 而 你 还 可 以 使 用 EntityDataReader 在 结果 集合 映射 到 实体 对 
象 之 前 拦截 它们 ， 并 进行 手工 处 理 。 

下 面 看 到 的 是 本 示例 最 后 一 个 辅助 方法 ， 它 使 用 了 System.Data.EntityClient 命 名 空间 下 的 一 些 
成 员 ,， 通过 一 个 命令 对 象 和 数据 阅读 器 ,手工 建立 了 一 个 数据 连接 。 这 段 代 码 与 第 21 章 中 的 类 似 ， 最 
大 的 不 同 是 这 里 使 用 了 Entity SQL， 而 不 是 “普通 的 ”SQL。 

private static void FunWithEntityDataReader() 

i 


using (EntityConnection cn = new EntityConnection("name=AutoLotEntities")) 
cn.Open(); 


// 构建 一 个 Entity SQL 查询 
string query = “SELECT VALUE car FROM AutoLotEntities.Cars AS car"; 


// 创建 一 个 命令 对 象 


using (EntityCommand cmd = cn.CreateCommand()) 
cmd.CommandText = query; 


// 最 后 ， 获 取 数 据 阅读 器 并 处 理 得 到 的 记录 
using (EntityDataReader dr = 
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cmd .ExecuteReader(CommandBehavior.SequentialAccess)) 
while (dr.Read()) 
{ 


Console.WriteLine("***** RECORD 六 沙沙 冰冰 " ) ; 
Console.WriteLine("ID: {0}", dr["CarID"]); 
Console.WriteLine("Make: {0}", dr["Make"]); 
Console.WritelLine("Color: {0}", dr["Color"]); 
Console.WriteLine("Pet Name: {0}", dr["CarNickname"]); 
Console.WritelLine(); 


} 
} 
} 
} 
} 


很 好 ! 这 个 初步 的 示例 将 对 你 理解 Entity Framework 的 细节 大 有 神 益 。 如 前 所 述 ， 如 果 EDM 包 含 
关联 的 数据 表 将 会 更 加 有 趣 。 接 下 来 我 们 就 来 学 习 这 方面 的 内 容 。 


源 代码 ”InventoryEDMConsoleApp 示 例 的 源 代码 位 于 Chapter 23 子 目录 下 。 
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接 下 来 我 们 将 学 习 如 何 创 建 包含 AutoLot 数 据 库 大 部 分 内 容 和 GetPetName 存 储 过 程 的 EDM。 我 强烈 建 
议 你 复制 一 份 第 22 章 创建 的 AutoLotDAL(Version Three)， 并 将 其 命名 为 AutoLotDAL(Version Four)。 

在 Vusial Studio 中 打开 最 新 版 的 AutoLotDAL 项 目 ,插入 一 个 新 的 ADO.NET Entity Data Model 项 并 
将 其 命名 为 AutoLotDAL _EF.edmx。 在 向 导 的 第 三 步 中 , 我 们 选择 Inventory、0rders、Customers 表 (这 
里 暂时 没 必要 选择 CreditRisks 表 )， 以 及 自 定义 的 存储 过 程 ( 如 图 23-17 所 示 )。 


Tr 








图 一 Choose Your Database Objects and Settings 


Which database objects do you want to imcludein your modeP 
1 | EE Tables 
4 MI dbo 
FE CreditRisks 
YY Custemers 





TE Inventory 
EY Orders 
可 sysdiagrams 
| Phy Views 
| 。 Ty Stored Procedures and Functions 
| | i dbo 
站] fn_diagramobjects 
四 | 癌 sp_akerdiagram 





1 Pluralize Si generated object names 
Include foreign key columns in the medel 
ET Import selected stored procedures and functions into the entity model 
Model Namespace: 
AutoLotModel 








图 23-17 包含 AutoLot 数 据 库 大 部 分 内 容 的 *.edmx 文 件 
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与 第 一 个 EDM 示 例 所 不 同 的 是 ， 这 次 我 们 不 必修 改 实体 类 的 名 称 及 其 属性 。 无 论 何 时 打开 Model 
Browser 窗 体 ， 除 了 自 定义 存储 过 程 外 ， 还 可 以 看 到 所 有 实体 ( 如 图 23-18 所 示 )。 


5 MODEL BROWSER :3 


Type here to search 


4 so AutoLotDAL EF.edmx 
4 睛 Diagrams 
5 二 Diagraml 
4 吧 AutoLotModel 
4 叮 Entity Types 





GetpetNarnael 
EntityContainer: AutoLotEntities 
入 AutoLotModelStore 





OR CLASSWEN MODEL BROW,... 


图 23-18 ”导入 的 模型 数据 


23.4.1 ”导航 属性 的 作用 


观察 EDM 设 计 器 会 发 现 已 经 包含 所 有 选中 的 表 了 ,并 且 实 体 类 的 Navigation Properties 节 点 下 还 多 
了 新 的 条 目 (如 图 23-19 所 示 )。 


AutoLotDAL EF edme [Diagmml] bX es ~ 
Od ee 





必 mHR， 


图 23-19 ”导航 属性 
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顾名思义 ， 导 航 属性 使 我 们 可 以 在 Entity Framework 编 程 模型 中 实现 JOIN 操作 ( 无需 复杂 的 SQL 
语句 )。 为 了 说 明 这 些 外 键 关 系 ，*.edmx 文 件 中 的 每 个 实体 现在 都 增加 了 新 的 XML 数据 ,来 说 明 这 些 
实体 是 如 何 通过 键 数据 进行 关联 的 。 如 果 你 想 直接 看 到 这 些 标记 ， 可 以 在 XML 编辑 器 中 打开 *#.edmx 
文件 。 你 也 可 以 在 Model Browser 窗 口 的 Associations 文 件 夹 下 查看 相同 的 信息 ( 如 图 23-20 所 示 )。 


2 MODEL BROWSER “nieanss 疙 各 





Type here to search 





4 a AutoLotModel 
4 盯 Entity Types 


| 加 上 KK Orders Customeed 
图 FK_Orders inventory 
4 国 Function Imports 
” 国 GetPetName 
四 EntityContainer; AutoLotEntities 
| 坪 AutoLotModetStore 








1 





ee ODEL 8.. 





图 23-20 查看 实体 关系 


如 果 你 愿意 ， 可 以 将 这 个 新 库 的 版 本 号 改 为 4.0.0.0( 使 用 Properties 窗 口 Applications 选 项 卡 中 的 
Assembly Information 按 钮 ),。 编译 修改 后 的 AutoLotDAL.dll 程 序 集 , 然后 将 其 移动 到 第 一 个 客户 端 应 用 
程序 中 。 


源 代码 ”AutoLotDAL (Version 4 ) 的 源 代 码 位 于 Chapter 23 子 目录 中 。 


23.4.2 ”在 LINQ to Entity 查 询 中 使 用 导航 属性 


接 下 来 我 们 将 学 习 如 何在 LINQ to Entity 查 询 中 使 用 导航 属性 ( 导航 属性 也 可 用 于 Entity SQL, 不 
过 本 书 不 会 深入 展开 这 个 话题 )。 在 将 数据 绑 定 到 Windows Forms GUI 之 前 ,我 们 先 创 建 一 个 控制 台 应 
用 程序 AutoLotEDMClient， 并 添加 System.Data.Entity.dll 和 最 新 版 的 AutoLotDAL.dll 的 引用 。 

下 一 步 ， 打 开 AutoLotDAL ( Version Four ) 项 目 中 的 App.config 文 件 (使 用 Project 一 Open... 一 File 
菜单 项 )， 将 连接 字符 串 复制 到 当前 配置 文件 ( 如 果 项 目 中 还 没有 App.config， 可 以 通过 Project 一 Add 
Existing Item 添 加 整个 文件 )。 同 时 ， 在 初始 的 C# 代 码 文件 中 引入 AutoLotDAL 命 名 空间 。 

然后 ， 向 Orders 物 理 表 添 加 一 些 新 的 记录 ， 并 且 要 保证 某 个 客户 有 多 个 订单 。 打 开 Visual Studio 
的 Server Explorer， 向 Orders 表 添加 几 条 新 记录 , 确保 某 个 客户 有 2 个 以 上 的 订单 。 例如 , 在 图 23-21 中 ， 
编号 为 #4 的 客户 有 2 个 订单 ， 分 别 是 汽车 #1992 和 #83。 
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| Or Cre nt rnin benress Autol ol DH | 
Orders: Query(manu...qlexpress.AutoLot) 3 





i4 4 5 of5| > 诗 汽 


图 23-21 一 个 客户 有 多 个 订单 


现在 在 Program 中 添加 一 个 辅助 方法 ( 在 Main() 中 调用 )。 该 方法 使 用 导航 属性 来 获取 某 个 客户 订 
单 中 的 所 有 Inventory 对 象 : 


private static void PrintCustomerOrders(string custID) 
int id = int.Parse(custID); 
using (AutoLotEntities context = new AutoLotEntities()) 


var carsOnOrder = from 0o in context.Orders 

where 0.CustID == id select o.Inventory; 
Console.WriteLine("\nCustomer has {0} orders pending:", carsOnOrder.Count()); 
foreach (var item in carsOnOrder) 


Console.WritelLine("-> {0} {1} named {2}.", 
item.Color, item.Make, item.PetName); 
} 


} 


运行 应 用 程序 ,输出 结果 如 下 (注意 ,在 Main() 中 调用 PrintCustomer0rders() 时 传 入 的 客户 ID 为 4 ): 





六 冰冰 冰冰 Navigation Properties 六 冰冰 冰冰 
Please enter customer ID: 4 


Customer has 2 orders pending: 
-> Pink Saab named Pinky. 
-> Rust Ford named Rusty. 





在 本 例 中 ， 我 们 先 查 找 上 下 文中 CustID 为 指定 值 的 Customer 实 体 。 找 到 之 后 ， 导 航 到 Inventory 表 
查找 订单 中 的 汽车 。LINQ 查 询 的 返回 值 是 一 个 Inventory 对 象 的 枚 举 ， 然 后 使 用 标准 的 foreach 循 环 进 


23.4.3 ”调用 存储 过 程 


如 果 在 AutoLotDAL EMD 中 需要 调用 GetPetName 存 储 过 程 ， 可 以 使 用 如 下 所 示 的 两 种 方法 之 一 。 
完整 的 代码 清单 如 下 所 示 : 
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private static void Cal1StoredProc() 
using (AutoLotEntities context = new AutoLotEntities()) 


// 方法 在 
ObjectpParameter input = new ObjectParameter("carID", 83); 
ObjectParameter output = new ObjectParameter(" petName" ，typeof(string)); 


// 调用 上 下 文 的 ExecuteFunction 方 法 
context .ExecuteFunction("GetPetName", input, output); 


// 方法 #2 
// 或 使 用 上 下 文中 强 类 型 的 方法 
context.GetPetName(83, output); 


Console.WritelLine("Car #83 is named {0}", output.Value); 
} 
} 


在 这 段 代码 中 可 以 看 到 ,第 一 个 方法 是 调用 对 象 上 下 文 的 ExecuteFunction() 方 法 ,存储 过 程 的 名 53 
称 由 一 个 字符 串 指定 ， 参 数 由 0bjectpParameter 类 型 的 对 象 表示 。0bjectParameter 类 型 位 于 
System.Data.0bjects 命 名 空间 ， 要 记得 在 C# 代 码 文件 中 引用 该 命名 空间 。 

而 第 二 个 方法 ( 同样 请 看 上 面 的 代码 ) 是 在 对 象 上 下 文中 使 用 强 类 型 的 名 称 。 该 方法 要 简单 一 些 ， 
所 输入 的 参数 ( 如 carID ) 为 强 类 型 数据 ， 而 不 是 0bjectParameter 对 象 。 


源 代码 ”AutoLotEDMClient 示 例 的 源 代码 位 于 Chapter 23 子 目录 下 。 


23.5 “将 数据 实体 绑 定 到 Windows Forms GUI 


要 介绍 ADO.NET Entity Framework 的 这 一 部 分 ,我 们 首先 创建 一 个 简单 的 示例 。 在 该 示例 中 ， 我 
们 将 实体 对 象 绑 定 到 Windows Forms GUI 中 。 如 本 章 前 面 所 述 ， 你 还 可 以 将 数据 绑 定 操作 用 于 WPF 和 
ASPNET 项 目 。 

我 们 创建 一 个 名 为 AutoLotEDM GUI 的 Windows Forms 应 用 程序 ， 将 原始 窗 体 名 称 改 为 
MainForm.cs。 然 后 添加 对 System.Data.Entity.dll 和 最 新 版 的 AutoLotDAL.dll 的 引用 。 最 后 修改 这 个 新 项 
目 中 的 App.config 文 件 ， 添 加 到 AutoLotDAL ( Version Four ) 的 连接 字符 串 ， 并 在 窗 体 的 主 代码 文件 中 
引入 AutoLotDAL 命 名 空间 。 

现在 在 窗 体 设计 器 中 添加 一 个 DataGridView 对 象 ， 将 其 名 称 改 为 gridInventory。 重 命名 之 后 ， 选 
择 内 置 的 grid 编 辑 器 ( 右上 方 的 小 箭头 ), 在 Choose Data Source 下 拉 框 中 添加 项 目的 数据 源 ( 如 图 23-22 
所 示 )。 
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eee 
MainForm.cs [Design]* 室 









> Other Data Sources 





4 Add Projoft Data Source 
Select a data source under “Other Data 
Sources' to connect to data. 















图 23-22 设计 Windows Forms DataGridView 控 件 


在 本 例 中 , 我 们 并 不 是 直接 绑 定数 据 库 , 而 是 绑 定 实体 类 , 因此 选择 Object 选项 ( 如 图 23-23 所 示 )。 


by 








| Sharepcint 





Lets you choose objects that can later be used to generate data-bound controls. 





图 23-23 ” 绑 定 强 类 型 对 象 


在 最 后 一 个 步 又 中 , 选中 AutoLotDAL.dlI 下 的 Inventory 表 ， 如 图 23-24 所 示 ( 如 果 没 有 看 到 该 项 ， 
则 很 可 能 是 忘记 了 添加 对 该 库 的 引用 )。 
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| 图 一 Select the Data Objects 
| 站 


Expand the referenced assemblies and namespaces to select your objects. ff an object is missing from a referenced 
assembly, cancel the wizard and rebuild the project that contains the object. 


What objects do you want to bind to? 





| 刁 罗 AutoLotEDM_GUI 
| 4 ed AutoLotDAL 
Tt AutoLotConnectedLayer 
4 畏 (1) AutoLotDAL 
“| AutoLotDataSet 
辣 才 AutoLotEntities 
“| 才 % Customer 


四 和 $ Order NR 


EE {} AutoLotDAL.AutoLotDataSetTableAdapters 
回 {} AutoLotDisconnectedLayer 











到 Hide system assemblies 





图 23-24 选择 Inventory 表 


单 击 Finish 按 钮 ， 你 将 看 到 grid 显 示 了 Inventory 实 体 类 的 各 个 属性 ,包括 那些 导航 属性 。 
完成 之 后 ， 添 加 一 个 Button 控 件 ， 并 改名 为 btmUpdate。 这 时 你 的 设计 器 将 如 图 23-25 所 示 。 





MainForm.cs [Design] 闪闪 





f 
| 


Pi inyentoryBindingSource 


图 23-25 ”最终 UI 
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添加 数据 绑 定 代码 


现在 如 果 再 添加 一 些 代 码 ， 你 的 grid 就 可 以 显示 任意 数量 的 Inventory 对 象 。 代 码 再 简单 不 过 了 ， 
这 要 归功 于 EF 的 运行 时 引擎 。 为 MainForm 类 的 FormClosed、Load 事 件 ( 使 用 Properties 窗 口 ) 和 Button 
控件 的 Click 事 件 添加 处 理 程 序 ， 代 码 片段 如 下 : 


public partial class MainForm : Form 
AutoLotEntities context = new AutoLotEntities(); 
public MainForm() 


InitializeComponent(); 


private void MainForm Load(object sender, EventArgs e) 


// 将 0bjectSet<Inventory> 集 合 绑 定 到 grid 
gridInventory.DataSource = context.Inventories; 


private void btnUpdate Click(object sender, EventArgs e) 


context .SaveChanges(); 
MessageBox.Show("Data saved!"); 


private void MainForm FormClosed(object sender, FormClosedEventArgs e) 
context.Dispose(); 

} } 

这 就 你 需要 做 的 全 部 工作 ! 运行 该 应 用 程序 ， 你 可 以 向 grid 添 加 新 的 记录 、 选 中 一 行 然后 删除 ， 
或 修改 已 存在 的 行 。 对 象 上 下 文 为 查询 、 更 新 、 插 入 自动 生成 了 所 有 必要 的 SQL 语句 , 因此 单 击 Update 
按钮 时 ，Inventory 数 据 库 将 自动 更 新 。 以 下 是 上 例 的 几 个 关键 之 处 。 

口上 下 文 在 整个 应 用 程序 中 都 保持 已 分 配 状态 。 

口 调用 context .Inventories 将 执行 SQL 语句 ， 把 所 有 Inventory 表 中 的 数据 提取 到 内 存 中 。 

口 上 下 文 会 跟踪 脏 的 实体 ， 这 样 在 执行 SaveChanges() 时 才 知 道 要 执行 什么 样 的 SQL 语句 。 

口 执行 完 SsaveChanges() 之 后 ， 实 体 将 变 为 干净 的 。 


23.6 ”展望 .NET 数据 访问 API 的 未 来 


在 这 三 章 中 ， 我 们 介绍 了 三 种 使 用 ADO.NET 操 纵 数据 的 方法 ， 即 连接 层 、 断 开 连 接 层 和 Entity 
Framework。 每 种 方法 都 有 各 自 的 优点 ， 很 多 应 用 程序 都 会 使 用 其 中 的 一 部 分 。 要 知道 ， 我 们 只 是 对 
ADO.NET 技 术 中 的 所 有 话题 进行 了 粗浅 的 介绍 。 要 深入 了 解 本 书 介绍 的 这 些 话 题 ( 以 及 相关 内 容 )， 
我 推荐 参考 .NET Framework 4.5 SDK 文 档 的 “Data and Modeling” 主 题 。 其 中 还 包含 了 大 量 代 码 示例 
(如 图 23-26 所 示 )。 


So 
;CONTENTS Gree 和 
Filter Contents Fe 


4 .NET Framework Development Guide 
>》 ,NET Fremework Application Essentials 
4 ADO.NET 站 
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b Securing ADOJNET Applications | 
> Data Type Mappings im ADO.NET | 
b DataSets, DataTables, and DataViews 
b Retrieving and Modifying Data in ADO.NET 
» ADO.NET Entity Framework 
b Class Library 
Entity Data Model 
$ SQL Server and ADO.NET 
$ Oracleand ADOJNET 
> Transaction Processing 
> WCF Data Services 
Ss XML Documents and Data 
HNGQ Portal 


CONTENTS INDEX FAVDRITES SEARCH 


图 23-26 .NET Framework 文 档 Data and Modeling 部 分 


23.7 小 结 


本 章 通过 介绍 Entity Framework 的 作用 ， 结 束 了 前 面 使 用 ADO.NET 数 据 库 编程 的 学 习 。EF 人 允许 你 
对 更 接近 于 业务 领域 的 概念 模型 进行 编程 。 你 可 以 随意 改造 实体 , 而 EF 运行 时 将 确保 这 些 改 变 的 数据 
被 映射 到 正确 的 物理 表 数 据 。 

你 学 习 了 *.edmx 文 件 的 作用 ( 及 其 内 容 )， 以 及 如 何 使 用 Visual Studio IDE 生 成 这 些 文件 。 同 时 ， 
你 还 学 习 了 如 何 将 存储 过 程 映射 到 概念 层 中 的 功能 ( function )、 如 何 对 物理 模型 使 用 LINQ 查 询 、Entity 
SQL 的 作用 ， 以 及 如 何 使 用 EitityDataReader 最 快捷 地 获取 数据 。 

本 章 的 最 后 描述 了 一 个 简单 的 示例 ， 在 Windows Forms 应 用 程序 环境 中 将 实体 类 绑 定 到 图 形 用 户 
界面 。 在 学 习 Windows Presentation Foundation 和 ASPNET 时 你 还 将 看 到 其 他 将 实体 绑 定 到 GUI 应 用 程 
序 的 示例 。 








LINQ to XML 简介 / 











reli 你 一 定 会 遇 到 很 多 要 操作 XML 数据 的 情况 。 桌 面 应 用 程序 和 基于 Web 的 应 
用 程序 配置 文件 使 用 XML 存储 信息 。ADO.NET 的 Dataset 可 以 方便 地 将 数据 保存 ( 或 加 载 ) 
为 XML。Windows Presentation Foundation 、Silverlight 和 Windows Workflow Foundation 都 使 用 基于 XML 
的 语法 (XAML ) 来 分 别 表示 桌面 UI、 浏 览 器 UI 和 工作 流 。 甚 至 Windows Communication Foundation 
也 将 很 多 设置 保存 为 格式 良好 的 XML。 

尽管 XML 无 处 不 在 ， 但 对 一 个 不 是 很 熟悉 众多 XML 相关 技术 ( XPath、XQuery、XSLT 、DOM、 
SAX， 等 等 ) 的 人 来 说 ， 对 XML 进行 编程 历来 都 是 十 分 烦琐 的 。 自 .NET 平 台面 世 以 来 ， 微 软 就 提供 
了 一 个 特殊 的 程序 集 System.Xml.dll 来 专门 对 XML 文档 进行 编程 。 这 个 二 进 制 文件 提供 了 大 量 命名 空间 
和 类 型 来 应 对 不 同 的 XML 编程 技术 ， 和 一 些 .NET 特 有 的 XML API， 如 XmlReader/XmlwWriter 类 。 

如 今 , 大 多 数 .NET 程 序 员 选 择 使 用 LINQ to XML API 来 与 XML 数据 进行 交互 。 正 如 你 将 在 本 章 中 
所 看 到 的 那样 ，LINQ to XML 编程 模型 允许 你 在 代码 中 捕获 XML 数据 的 结构 ， 并 提供 了 极其 简单 的 方 
式 来 创建 、 操 作 、 加 载 和 保存 XML 数据 。 你 不 仅 可 以 使 用 LINQ to XML 以 非常 简单 的 方式 创建 XML 
文档 ， 而 且 还 可 以 对 LINQ 查 询 表 达 式 进行 组 合 ， 来 快速 查询 文档 中 的 信息 。 


24.1 两 个 XML API 的 故事 


当 .NET 平 台面 世 的 时 候 ， 程 序 员 可 以 使 用 System.Xml.dll 程 序 集中 的 类 型 来 操作 XML 文档 。 使 用 
该 程序 集 下 的 命名 空间 和 类 型 可 以 在 内 存 中 生成 XML 数据 并 保存 到 硬盘 中 。 同 样 System.Xml.dll 程 序 
集 还 提供 了 一 些 类 型 用 于 将 XML 文件 加 载 到 内 存 、 检 索 一 个 XML 文档 中 的 特定 节点 、 验 证 文档 是 否 
符合 某 个 架构 ( schema ) 以 及 其 他 常用 编程 任务 。 


因为 编程 模型 与 XML 文档 本 身 没 有 任何 关联 。 例 如 ， 假 设 我 们 需要 在 内 存 中 创建 一 个 XML 文件 并 将 
其 保存 到 文件 系统 。 如 果 使 用 System.Xml.dll 中 的 类 型 ， 代 码 将 会 如 下 所 示 (创建 一 个 名 为 
LinqToXmlFirstLook 的 控制 台 应 用 程序 项 目 ， 并 添加 System.Xm1 命 名 空间 ): 

private static void BuildXmlDocWithDOM() 


// 在 内 存 中 新 建 一 个 Xml 文档 


XmlDocument doc = new XmlDocument(); 


// 用 根 元 素 <Inventory> 填 充 文 档 
XmlElement inventory = doc.CreateElement("Inventory"); 
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// 现在 创建 一 个 <Car> 子 元 素 ， 它 包含 一 个 ID 特性 
XmlElement car = doc.CreateElement("Car"); 
car.SetAttribute("ID", "1000"); 


// 创建 <Car> 元 素 中 的 数据 

XmlElement name = doc.CreateElement("PetName"); 
name.InnerText = "Jimbo"; 

XmlElement color = doc.CreateElement("Color"); 
color.InnerText = "Red"; 

XmlElement make = doc.CreateElement("Make"); 
make.InnerText = "Ford"; 


// 将 cPetName>、<Color>、<Make> 添 加 到 <Car> 元 素 
car.AppendChild(name); 
car.AppendChild(color); 
car.AppendChild(make); 


// 将 Car> 元 素 添加 到 《Inventoryy> 元 素 
inventory.AppendChild(car); 


// 将 完整 的 XML 插入 到 XmlDocument 对 象 并 保存 文件 
doc.AppendChild(inventory); 
doc.Save("Inventory.xml"); 


} 
在 调用 该 方法 时 ， 你 可 以 看 到 生成 的 Inventory.xml 文 件 ( 位 于 \bin\Debug 目 录 下 )， 它 包含 的 数据 
如 下 : 


<Inventory> 
<Car ID="1000"> 
<PetName>Jimbo</PetName> 
<Color>Red</Color> 
<Make>Ford</Make> 
</Car> 
</Inventory> 


虽然 这 种 方法 可 以 正常 工作 , 但 还 是 存在 一 些 不 足 。 首先 ，System.Xml.dll 的 编程 模型 是 微软 所 实 
现 的 W3C 文 档 对 象 模 型 (DOM ) 规范 。 在 该 模型 下 ，XML 文 档 是 自 下 而 上 创建 的 。 首 先 创建 文档 ， 
然后 创建 子 元 素 ， 最 后 将 元 素 添加 到 文档 中 。 在 用 代码 实现 它们 时 ， 你 需要 编写 大 量 函 数 调用 
XmlDocument 、XmlElement 等 类 。 

本 例 用 了 16 行 代码 (不 含 注释 ) 来 创建 这 个 极其 简单 的 XML 文档 。 如 果 使 用 System.Xml.dll 程 序 
集 来 创建 更 复杂 的 文档 ， 最 终 的 代码 会 更 多 。 尽 管 可 以 使 用 各 种 循环 或 条 件 结构 来 创建 节点 从 而 使 代 
码 得 到 精简 ， 但 事实 上 代码 体 还 是 无 法 与 最 终 的 XML 树 产 生 任何 视觉 上 的 关联 。 


24.1.1 更 优秀 的 DOM 一 一 LINQ to XML 


LINQ to XML API 是 另 一 种 创建 、 操 作 和 查询 XML 文档 的 方式 。 它 相 比 System.Xxml 的 DOM 模 型 使 
用 了 更 多 函数 式 的 方法 。 你 不 必 将 单独 的 元 素 组 合成 XML 文档， 不 必 使 用 一 组 函数 来 更 新 XML 树 ， 
你 只 需要 编写 如 下 所 示 的 自 上 而 下 的 代码 : 
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private static void BuildXmlDocWithLINQOToXml() 


// 使 用 更 加 函数 式 的 方式 创建 XML 文档 
XElement doc = 
new XElement("Inventory", 
new XElement("Car", new XAttribute("ID", "1000"), 
new XElement("PetName", "Jimbo"), 
new XElement("Color", "Red"), 
new XElement("Make", "Ford") 
) 
); 


// 保存 到 文件 
doc.Save("InventoryWithLINO.xm]"); 


这 段 代 码 使 用 了 System.Xml.Linq 命 名 空间 下 的 一 组 新 类 型 ， 如 XElement 和 XAttribute。 如 果 调 用 
这 段 代 码 ， 你 会 发 现 它 创 建 了 与 前 面 的 例子 相同 的 XML 数据 ， 但 却 少 了 很 多 不 必要 的 麻烦 。 请 注意 ， 
通过 一 些 精心 的 缩 进 , 代码 与 输出 的 XML 文 档 的 整体 结构 完全 相同 。 这 是 非常 有 用 的 , 而 且 它 还 比 前 
面 的 例子 少 了 很 多 代码 (根据 代码 的 放置 情况 ， 差 不 多 节省 了 10 行 代码 ! )。 

这 段 代码 没有 使 用 任何 LINQ 查 询 表达 式 ， 而 只 是 使 用 了 System.Xm1.Linq 命 名 空间 下 的 一 些 类 型 
来 生成 一 个 在 内 存 中 的 XML 文档 ， 随 后 将 其 保存 到 文件 中 。 我 们 将 LINQ to XML 视 为 一 个 更 有 效 、 更 
优秀 的 DOM。 正 如 你 将 在 本 章 后 面 所 看 到 的 ，System.Xml.Linq 中 的 类 都 是 支持 LINQ 的 ， 它 们 都 可 以 
作为 同 种 类 的 LINQ 查 询 的 目标 ， 正 如 第 12 章 中 所 学 到 的 那样 。 

随 着 对 LINQ to XML 学 习 的 深入 , 你 肯定 会 发 现 它 比 .NET 中 原来 的 XML 库 要 易 用 得 多 。 在 新 项 目 
中 使 用 System.Xml.dll 的 可 能 性 被 大 幅 降 低 ， 但 这 并 不 意味 着 你 不 会 再 使 用 原来 库 中 的 命名 空间 。 


24.1.2 ”更 优秀 的 LINQ to XML 一 一 VB 字面 量 语法 


在 使 用 C# 正 式 开始 学 习 LINQ to XML 之 前 ， 我 想 简单 地 提 一 句 ，Visual Basic 语 言 对 该 API 的 函数 
式 使 用 达到 了 更 高 的 级 别 。 在 VB 中 我 们 可 以 使 用 XML 字面 量 ， 它 允许 你 在 代码 中 直接 将 XElement 指 
定 为 内 联 的 XML 标记 流 。 假 设 存在 一 个 VB 项 目 ， 你 可 以 创建 下 面 的 方法 : 


Public Class XmlLiteralExample 
Public Sub MakeXmlFileUsingLiterals() 
”注意 ， 我 们 可 以 将 XML 数据 内 联 到 XElement 中 
Dim doc As XElement = _ 
<Inventory> 
<Car ID="1000"> 
<PetName>Jimbo</PetName> 
<Color>Red</Colory> 
<Make>Ford</Make> 
</Car> 
</Inventory> 


”保存 至 文件 
doc.Save("InventoryVBStyle.xml") 
End Sub 
End Class 
在 VB 编译 器 处 理 XML 字 面 量 时 ， 会 将 XML 数据 映射 为 正确 的 LINQ to XML 对 象 模型 。 实 际 上 ， 


在 VB 项 目 中 使 用 LINQto XML 时 ，IDE 已 经 知道 了 XML 字面 量 语法 仅仅 是 相关 代码 的 速记 符号 。 如 图 
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24-1 所 示 ,在 </Inventory> 结 束 标记 之 后 使 用 点 操作 符 所 得 到 的 成 员 与 在 强 类 型 的 XElement 之 后 使 用 点 
操作 符 得 到 的 成 员 完 全 相同 。 

尽管 本 书 是 关于 C# 编 程 语言 的 ， 但 几乎 所 有 开发 者 都 认为 VB 对 XML 的 支持 简直 令 人 拍案 叫绝 。 
即使 你 是 那 种 无 法 使 用 BASIC 家 族 语言 进行 日 常 开 发 的 程序 员 ， 我 还 是 希望 你 能 通过 .NET Framework 
4.5 SDKT 了 解 一 下 VB 字面 量 语法 。 你 会 发 现 你 能 够 将 XML 数 据 处 理工 作 与 专用 的 *.dll 相 分 离 ， 而 这 正 
是 VB 的 功劳 。 


XmiliteralExample.vb” 二 X Object Browser 


让 - 

sy XmlLliteralExample ~ ® MakeXmifileUsingLiterals ~ 

Public Class XmliiteralExample 李 

局 Public Sub en < 

”Notice that we can injine XML data | 

”te an XElement. 

Dim doc As XElement = _ | 

- <Inventory> | 
三 | <Car ID="1888"> 

<PetName > Jimbo</PetName> | 

<Color>Red<*/Color> | 

<Make>Ford< /Make> | 

<ACary> | | 

fe <Car> | 

<Make >Yugo< /Make> | 

</Car> | 引 

</Inventory>. | 





doc.Savet( "Invento [本 
End Sub 9 @ 7 
‘End Class 本 <> 


®@ AddAfterSelf 
龟 AddAnnotation 
B AddBeforeSelf 
@ AddFirst 


Am “ 


图 24-1 VB XML 字面 量 语法 是 LINQ to XML 对 象 模 型 的 速记 符号 


24.2 System.Xml.Linq 命名 空间 的 成 员 


有 些 让 人 吃惊 的 是 ，LINQ to XML 的 核心 程序 集 ( System.Xml.Linq.dll ) 只 在 三 个 不 同 的 命名 空间 
下 定义 了 很 少 的 类 型 。 这 三 个 命名 空间 是 System.Xml.Linq、System.Xml.Schema、System.Xml.xPath( 如 
图 24-2 所 示 )。 

核心 的 命名 空间 System.Xml.Linq 包 含 了 一 组 非常 易于 管理 的 类 ,它们 代表 一 个 XML 文 档 的 不 同方 
面 (元 素 、 属 性 、XML 命 名 空间 、XML 注 释 、 处 理 指 令 等 )， 如 表 24-1 所 示 。 


792 第 24 章 LINQtoXML 简介 


Object Browser 1 X 





<Search> 


有 a 二 System.Xml.Ling | 村 
.4 
b de Edtensions 
》 昌 上 LoadOptions 
》 中 ReaderOptions 
pp SaveOptions 
可 XAttrnibute 
by hs XCData 
by By XComment 
by De XContainer 
| bv Be XDeclaration 
| by We XDocument 
| b- te XDocimentType 


| 如 XElement | 

| by ts XName : | 

| by We XNamespace namespace System.Xmli.Ling | 
b 如 XNode i Member of System.Xml.Ling 


I 
| b Hr XNodeDocumentOrderComparer 
| b By XNodeFqualityComparer 

| bp We XObject 

四 XObjectChange 

b XObjectChangefventArgs 

bp Wo XProcessinglnstruction 

b Ws XStreamingElement 








b XTexd 
bp {FF System.Xml.Schema 
by {} Systern.Xml.XPpath [本 
图 24-2 ”System.XmlLinq.dll 中 的 命名 空间 
表 24-1 选择 System.Xm1l.Linq 命 名 空间 的 成 员 
System.Xm1l.Linq 的 成 员 含义 
XAttribute 表示 一 个 XML 元 素 的 XML 特性 
XCData 表示 XML 文档 中 的 CDATA 部 分 。CDATA 中 的 信息 不 必 遵 循 XML 的 语法 规则 ( 如 脚 
本 代码 ) 
XComment 表示 一 个 XML 注释 
XDeclaration 表示 一 个 XML 文 档 中 的 公开 声明 
XDocument 表示 一 个 XML 文档 的 全 部 内 容 
XElement 表示 一 个 XML 文档 中 的 特定 元 素 ， 包 含 根 元 素 
XName 表示 一 个 XML 元 素 或 XML 特性 的 名 称 
XNamespace 表示 一 个 XML 命名 空间 
XNode 表示 XML 树 中 节点 ( 元素、 注释 、 文 件 类 型 、 处 理 指令 或 文本 节点 ) 的 抽象 概念 
XProcessingInstruction 表示 一 个 XML 处 理 指令 


XStreamingElement 表示 一 个 支持 延迟 流 输 出 的 XML 树 
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图 24-3 显 示 了 这 些 关键 类 型 的 继承 链 。 


中 Kmilineinfo 

















图 24-3 LINQ to XML 核心 类 的 层次 结构 


24.2.1 LINQ to XML 的 轴 方 法 


除了 这 些 X* 类 ，System.Xm1.Linq 中 还 定义 了 一 个 名 为 Extensions 的 类 ， 它 定义 了 一 组 针对 
IEnumerable<T> 的 扩展 方法 ， 其 中 T 为 XNode 或 XContainer 的 子 类 。 表 24-2 列 出 了 一 些 需要 注意 的 重要 的 
扩展 方法 ( 如 你 所 见 ， 这 些 方法 在 使 用 LINQ 查 询 时 是 十 分 有 用 的 )。 


表 24-2 LINQ to XML 的 Extensions 类 的 Select 成 员 


Extensions 的 成 员 含 义 
Ancestors<T>() 返回 经 过 筛选 的 元 素 集合 ， 其 中 包含 源 集合 中 每 个 节点 的 上 级 
Attributes() 返回 源 集合 中 经 过 筛选 的 每 个 元 素 的 特性 集合 
DescendantNodes<T>() 返回 集合 中 每 个 文档 和 元 素 的 子 代 节点 的 集合 
Descendants<T> 返回 经 过 筛选 的 元 素 集合 ， 其 中 包含 源 集合 中 每 个 元 素 和 文档 的 子 元 素 
Elements<T> 返回 源 集合 中 每 个 元 素 和 文档 的 子 元 素 的 集合 
Nodes<T> 返回 源 集合 中 每 个 文档 和 元 素 的 子 节点 的 集合 
Remove() 将 源 集合 中 的 每 个 特性 从 其 父 节 点 中 移 除 
Remove<T>() 将 源 集合 中 出 现 的 所 有 特定 节点 移 除 


顾名思义 ， 这 些 方法 允许 在 一 个 已 加 载 的 XML 树 中 进行 查询 ， 以 查找 元 素 、 特 性 以 及 他 们 的 值 。 
总 的 来 说 ， 这 些 方法 被 称 为 轴 方 法 (axis method )， 或 简称 轴 ( axes )。 这 些 方法 可 以 直接 用 来 处 理 节 
点 树 的 一 部 分 ， 也 可 以 用 来 创建 更 复杂 的 LINQ 查 询 。 
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说 明 抽象 的 XContainer 类 支持 很 多 与 Extensions 方 法 的 名 称 相 同 的 方法 。 由 于 XContainer 是 
XElement 和 XDocument 的 父 类 ， 因 此 它们 都 支持 全 部 的 功能 。 


本 章 将 介绍 几 个 使 用 这 些 轴 方 法 的 示例 ， 以 下 是 一 个 快速 示例 : 


private static void DeleteNodeFromDoc() 


XElement doc = 
new XElement("Inventory", 
new XElement("Car", new XAttribute("ID", "1000"), 
new XElement("PetName", "Jimbo"), 
new XElement("Color", "Red"), 
new XElement("Make", "Ford") 
) 
); 
// 从 树 中 删除 PetName 元 素 


doc.Descendants("PetName").Remove(); 
Console.WriteLine(doc); 


调用 该 方法 后 ， 你 将 看 到 如 下 所 示 的 “修剪 ”后 的 XML 树 : 





<Inventory> 
<Car ID="1000"> 
<Color>Red</Color> 
<Make>Ford</Make> 
</Car> 
</Inventory> 





24.2.2 ”奇妙 的 XName 和 XNamespace 


如 果 查 看 LINQ to XML 轴 方法 ( 或 XContainer 中 的 同名 成 员 ) 的 签名 ， 你 会 发 现 这 些 方法 要 求 你 
指定 一 个 XName 对 象 。 例 如 下 面 XContainer 中 定义 的 Desendants() 方 法 的 签名 : 

public IEnumerable<XElement> Descendants(XName name) 

XName 是 很 神奇 的 , 因为 你 永远 不 需要 在 代码 中 直接 使 用 它 。 事实 上 , 由 于 该 类 没有 公共 构造 函数 ， 
因此 无 法 创建 一 个 XName 对 象 ， 如 下 所 示 : 


// 错误 | 不 能 创建 XName 对 象 
doc.Descendants(new XName("PetName")).Remove(); 


如 果 查 看 XName 的 正式 定义 , 你 就 会 发 现 该 类 定义 了 一 个 自 定义 隐 式 转换 操作 符 ( 参考 第 11 章 关于 
自 定 义 转 换 操作 符 的 定义 )， 它 会 将 一 个 简单 的 System.String 映 射 到 正确 的 XName 对 象 ; 
// 我 们 将 在 后 台 创 建 一 个 XName 


doc.Descendants("PetName").Remove(); 


说 了 明 XNamespace 类 同样 支持 隐 式 字符 串 转 换 。 
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这 么 做 的 好 处 是 可 以 在 使 用 这 些 轴 方 法 时 用 文本 值 来 表示 元 素 或 特性 ( attriubute ) 的 名 称 ， 并 人 允 
许 LINQ to XML API 将 string 数 据 映射 到 所 需 的 对 象 类 型 。 





源 代 码 “LinqToXmlFirstLook 示 例 的 源 代 码 位 于 Chapter 24 子 目录 下 。 


24.3 使 用 XElement 和 XDocument 


让 我 们 继续 通过 一 个 新 的 控制 台 应 用 程序 ConstructingXmlDocs 来 研究 LINQ to XML。 在 原始 代码 
中 引入 System.Xml.Linq 命 名 空间 。 正 如 已 经 介绍 的 那样 ， 在 LINQ to XML 编 程 模型 中 ，XDocument 表 
示 整 个 XML 文 档 。 它 可 以 用 来 定义 一 个 根 元 素 及 其 包含 的 所 有 元 素 、 处 理 指 令 和 XML 声 明 。 下 面 是 
另 一 个 使 用 XDocument 构 建 XML 数 据 的 示例 : 


static void CreateFullXDocument() 


XDocument inventoryDoc = 
new XDocument( 
new XDeclaration("1.0", "utf-8", "yes"), 
new XComment("Current Inventory of cars!"), 
new XProcessingInstruction("xml-stylesheet", 
"href='MyStyles.css' title='Compact' type='text/css'"), 
new XElement("Inventory", 
new XElement("Car", new XAttribute("ID", "1"), 
new XElement("Color", "Green"), 
new XElement("Make", "BMW"), 
new XElement("PetName", "Stan") 


new XElement("Make", "Yugo"), 
new XElement("PetName", "Melvin") 


) 
好 


// 保存 到 磁盘 
inventoryDoc.Save("SimpleInventory.xml"); 


请 注意 XDocument 对 象 的 构造 函数 实际 上 是 其 他 LINQ to XML 对 象 组 成 的 树 。 这 里 所 调用 的 构造 函 
数 的 第 一 个 参数 为 XDeclaration， 然 后 是 一 个 object 型 的 参数 数组 ( C# 参 数 数组 允许 传递 以 逗号 分 隔 
的 参数 列表 ， 它 们 将 被 打包 成 一 个 数组 ): 

public XDocument(System.Xml.Linq.XDeclaration declaration, params object[] content) 


如 果 在 Main() 方 法 中 调用 该 方法 ,将 在 SimpleInventory.xml 文 件 中 看 到 如 下 数据 : 





<?xml] version="1.0" encoding="utf-8" standalone="yes"?> 
<!--Current Inventory of cars!--> 
<?xml-stylesheet href='MyStyles.css' title='Compact' type='text/css'?> 
<Inventory> 
<Car ID="1"> 
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<Color>Green</Color> 
<Make>BMW< /Make> 
<PetName>Stan</PetName> 

</Car> 

<Car ID="2"> 
<Color>Pink</Color> 
<Make>Yugo</Make> 
<PetName>Melvin</PetName> 

</Car> 

</Inventory> 





事实 上 对 于 任何 XDocument 来 说 ， 默 认 的 XML 声明 使 用 utf-8 编 码 ，XML 版 本 为 1.0，standalone 特 
性 为 "yes"。 因 此 ,删除 XDeclaration 对 象 的 创建 将 得 到 完全 相同 的 数据 。 由 于 差不多 每 个 文档 都 需要 


同样 的 声明 ，XDeclaration 并 不 是 很 常用 。 
如 果 不 需 要 定义 处 理 指 令 或 自 定义 XML 声 明 , 你 可 以 不 使 用 XDocument 而 简单 地 使 用 XElement。 记 住 ， 
XElement 可 以 用 来 表示 XML 文 档 的 根 元 素 以 及 所 有 子 对 象 。 因 此 ， 可 以 像 下 面 这 样 生成 一 个 库存 列表 : 


static void CreateRootAndChildren() 


XElement inventoryDoc = 
new XElement("Inventory", 
new XComment("Current Inventory of cars!"), 
new XElement("Car", new XAttribute("ID", "1"), 
new XElement("Color", "Green"), 
new XElement("Make", "BMW"), 
new XElement("PetName", "Stan") 


)， 

new XElement("Car", new XAttribute("ID", "2"), 
new XElement("Color", "Pink"), 
new XElement("Make", "Yugo"), 
new XElement("PetName", "Melvin") 


); 


// 保存 到 磁盘 
inventoryDoc.Save("SimpleInventory.xml"); 


} 
除了 为 一 个 不 存在 的 样式 表 自 定义 了 处 理 指令 外 ， 其 余 的 输出 结果 基本 一 致 : 





<?xml version="1.0" encoding="utf-8"?> 
<Inventory> 
<!--Current Inventory of cars!--> 
Ca ID="4"> 
<Color>Green</Color> 
<Make>BMW< /Make> 
<PetName>Stan</PetName> 
</Car> 
<Car ID="2"> 
<Color>Pink</Color> 
<Make>Yugo</Make> 
<PetName>Melvin</PetName> 
</Car> 
</Inventory> 
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24.3.1 ”从 数组 和 容器 中 生成 文档 


目前 我 们 已 经 通过 固定 的 硬 编码 方式 构建 了 XML 文 档 , 而 更 常见 的 情况 是 通过 从 数组 ADO.NET 
对 象 、 文 件数 据 等 诸如 此 类 的 数据 源 中 读 取 数据 来 生成 XElement( 或 XDocument )。 使 用 一 组 标准 的 “for 
循环 ”来 将 数据 移动 到 LINQ to XML 对 象 模型 ， 是 一 种 将 内 存 中 的 数据 映射 为 新 的 XElement 的 方法 。 
尽管 这 是 可 行 的 ， 但 还 是 不 如 在 LINQ 查 询 中 直接 艇 人 XElement 的 构造 函数 简便 。 

假设 有 一 个 匿名 类 的 数组 ( 这 里 只 是 为 了 精简 代码 ,实际 上 可 以 为 任何 数组 .List<T> 和 其 他 容器 )， 
可 以 用 下 面 的 代码 将 数据 映射 到 XElement: 


static void MakeXElementFromArray() 


// 创建 一 个 匿名 类 型 的 数组 
var people = new[] { 
new { FirstName 
new { FirstName 
new { FirstName 
new { FirstName 


多 


"Mandy"，Age = 32}, 
"Andrew", Age = 40 }, 
"Dave", Age = 41 }, 
"Sara", Age = 31} 


XElement peopleDoc = 
new XElement("People", 
from c in people select new XElement("Person", new XAttribute("Age", c.Age), 
new XElement("FirstName", c.FirstName)) 


; 
Console.WritelLine(peopleDoc); 


这 里 的 peopleDoc 对 象 使 用 LINQ 查 询 定义 了 根 元 素 <People>。 该 LINQ 查 询 根 据 people 数 组 的 每 一 
项 创建 新 的 XElement。 如 果 你 觉得 这 种 区 入 的 查询 有 点 不 易 阅 读 ， 那 么 完全 可 以 像 下 面 这 样 来 断 行 : 


static void MakeXElementFromArray() 


// 创建 匿名 类 型 的 数组 

var people = new[] { 
new { FirstName 
new { FirstName 
new { FirstName 
new { FirstName 


3 


"Mandy", Age = 32}, 
"Andrew", Age = 40 }, 
"Dave", Age = 41 }, 
"Sara", Age = 31} 


Ll 


var arrayDataAsXElements = from c in people 
select 
new XElement("Person", 
new XAttribute("Age", c.Age), 
new XElement("FirstName", c.FirstName)); 


XElement peopleDoc = new XElement("People", arrayDataAsXElements); 
Console.WriteLine(peopleDoc ) ; 


总 之 ， 输 出 结果 如 下 : 





《People> 
<Person Age="32"> 
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<FirstName>Mandy</FirstName> 

</Person> 

<Person Age="40"> 
<FirstName>Andrew</FirstName> 

</Person> 

<Person Age="41"> 
<FirstName>Dave</FirstName> 

</Person> 

<Person Age="31"> 
<FirstName>Sara</FirstName> 

</Person> 

</People> 





24.3.2 ”加 载 和 解析 XML 内 容 


XElement 和 XDocument 都 支持 Load() 和 pParse() 方 法 ， 可 以 从 包含 XML 数据 的 string 对 象 或 外 部 
XML 文件 中 获取 XML 对 象 模 型 。 考 虑 下 面 这 段 演 示 了 这 两 个 方法 的 代码 : 


static void ParseAndLoadExistingXml() 


// 从 string 中 构建 XElement 
string myElement = 
@"<Car ID ='3'> 
<Color>Yellow</Color> 
<Make>Yugo</Make> 
</Car>"; 
XElement newElement = XElement.Parse(myElement); 
Console.WriteLine(newElement); 
Console.WritelLine(); 


// 加 载 SimpleInventory.xml 文 件 
XDocument myDoc = XDocument.Load("SimpleInventory.xml"); 
Console.WritelLine(myDoc); 


源 代码 。” ConstructingXmlDocs 示 例 的 源 代码 位 于 Chapter 24 子 目录 下 。 


24.4 在 内 存 中 操作 XML 文档 


到 目前 为 止 ， 我 们 介绍 了 使 用 LINQ to XML 创建 、 保 存 、 解 析 和 加 载 XML 数 据 的 不 同方 法 。 接 下 
来 要 关注 的 LINQ to XML 方面 是 如 何 使 用 LINQ 查 询 和 LINQ to XML 轴 方 法 来 导航 一 个 指定 的 文档 ， 对 
该 文档 进行 定位 并 更 改 XML 树 中 指定 的 项 。 

为 此 , 我 们 需要 创建 一 个 Windows Form 应 用 程序 来 显示 保存 在 硬盘 中 的 XML 文 档 中 的 数据 。GUI 
允许 用 户 输 入 新 节点 的 数据 ， 并 将 其 添加 到 同一 个 XML 文 档 中 。 最 后 ,将 为 用 户 提 供 一 些 方 法 , 使 用 
少量 的 LINQ 查 询 在 文档 中 执行 搜索 。 
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说 明 ”由 于 已 经 在 第 12 章 中 构建 了 很 多 LINQ 查 询 , 我 不 想 在 此 再 列举 更 多 的 查询 了 。 如 果 你 想 看 到 更 
多 的 LINQto XML 示例 ， 可 以 浏览 .NETFramework 4.5 SDK 文 档 中 的 “查询 XML 树 ”这 个 主题 。 


24.4.1 构建 LINQ to XML 应 用 程序 的 UI 


创建 一 个 名 为 LinqToXmlWinApp 的 Windows Form 应 用 程序 并 将 初始 的 Forml.cs 文 件 名 改 为 
MainForm.cs ( 在 Solution Explorer 中 )。 该 窗 体 的 GUI 非常 简单 。 在 窗 体 左 边 有 一 个 TextBox 控 件 ( 名 为 
txtInventory )， 其 Multiline 属 性 为 true，ScrollBars 属 性 为 Both。 

除 此 之 外 ， 还 有 一 组 简单 的 TextBox 控 件 〈 分 别 为 txtMake 、txtColor 和 txtPetName ) 和 一 个 按钮 
btnAddNewItem， 用 户 可 以 通过 这 些 控件 向 XML 文档 中 添加 一 条 新 的 条 目 。 最 后 ， 还 有 一 组 控件 (一 
个 名 为 txtMakeToLookUp 的 TextBox 和 一 个 名 为 btnLookUpColors 的 Button ) 用 来 查询 XML 文档 中 指定 的 
节点 。 图 24-4 显 示 了 界面 的 布局 。 








Look up Colors for Make 







Make to Look Up 





图 24-4 ”LINQ to XML 应 用 程序 的 GUI 


为 每 个 按钮 的 Click 事 件 生成 事件 处 理 程序 , 同样 还 有 窗 体 本 身 的 Load 事 件 。 稍 后 我 们 将 实现 这 些 
事件 处 理 程序 。 


24.4.2 引入 Inventory.xml 文 件 


在 本 书 的 代码 下 载 中 该 示例 的 解决 方案 代码 里 包含 一 个 Inventoryxml 文 件 。 它 的 根 元 素 
<Inventory> 下 包含 一 些 条 目 。 选 择 Project 一 Add Existing Item 菜 单 选 项 将 该 文件 引入 到 项 目 中 。 当 查看 
数据 时 你 会 发 现在 根 元 素 下 定义 了 一 些 <Car> 元 素 ， 它 们 的 定义 与 下 面 的 类 似 : 
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<Car carID ="0"> 
<Make>Ford</Make> 
<Color>Blue</Color> 
<PetName>Chuck</PetName> 
</Car> 


在 继续 下 面 的 步骤 之 前 ， 要 确保 在 Solution Explorer 中 选择 了 该 文件 ， 然 后 使 用 Properties 窗 体 将 
Copy to Output Directory 属 性 设置 为 Copy Always。 这 可 以 保证 在 编译 应 用 程序 时 在 \bin\Debug 文 件 夹 下 
部 署 这 些 数据 。 


24.4.3 ”定义 LINQ to XML 辅助 类 


我 们 在 LinqToXml0bjectModel 项 目 中 新 建 一 个 类 , 用 来 分 离 LINQ to XML 数据 。 该 类 将 定义 一 些 静 
态 方法 来 封装 LINQ to XML 逻辑 。 首 先 ， 定 义 一 个 方法 ， 根 据 Inventory.xml 文 件 的 内 容 返 回填 充 好 的 
XDocument 文 档 (需要 在 新 建 的 文件 中 引入 System.Xm1.Linq 和 System.Windows.Forms 命 名 空间 ): 
public static XDocument GetXmlInventory() 


try 


XDocument inventoryDoc = XDocument.Load("Inventory.xml"); 
return inventoryDoc; 


} 
catch (System.I0.FileNotFoundException ex) 
t 


MessageBox.Show(ex.Message); 
return null; 


} 
InsertNewElement() 方 法 (如 下 所 示 ) 获取 “Add Inventory Item” 中 各 个 TextBox 控 件 的 值 ， 并 使 
用 Descendants() 轴 方法 将 其 放置 到 <Inventory> 元 素 的 新 节点 中 。 这 些 工作 完成 之 后 ， 将 保存 文档 。 


public static void InsertNewElement(string make, string color, string petName) 


// 加 载 当前 文档 
XDocument inventoryDoc = XDocument.Load("Inventory.xml"); 


// 为 ID 生成 一 个 随机 数 
Random r = new Random(); 


// 根据 传 入 参数 新 建 XElement 

XElement newElement = new XElement("Car", new XAttribute("ID", r.Next(50000)), 
new XElement("Color", color), 
new XElement("Make”", make), 
new XElement("PetName", petName)); 


// 添加 到 内 存 中 的 对 象 


inventoryDoc.Descendants("Inventory").First().Add(newElement); 


// 保存 到 磁盘 
inventoryDoc.Save("Inventory.xml"); 


} 
最 后 一 个 方法 LookUpColorsForMake() 将 使 用 一 个 LINQ 查 询 获 取 最 后 一 个 TextBox 中 的 数据 ， 并 创 
建 一 个 包含 指定 的 颜色 字符 串 。 考 虑 如 下 实现 : 


24.4 在 内 存 中 操作 XML 文档 


public static void LookUpColorsForMake(string make) 


{ 


// 加 载 当 前 文档 
XDocument inventoryDoc = XDocument.Load("Inventory.xml"); 


// 根据 给 定 的 值 查找 颜色 

var makeInfo = from car in inventoryDoc.Descendants("Car") 
where (string)car.Element("Make") == make 
select car.Element("Color").Value; 


// 构建 一 个 代表 每 个 颜色 的 字符 囊 
string data = string.Empty; 
foreach (var item in makeInfo.Distinct()) 


data += string.Format("- {0}\n", item); 


} 


// 显示 颜色 
MessageBox.Show(data, string.Format("{0} colors:", make)); 


24.4.4 ”将 UI 组 装 到 辅助 类 


现在 我 们 要 做 的 就 是 实现 事件 处 理 程序 的 细节 ， 只 需要 简单 地 调用 静态 的 辅助 方法 ， 如 下 所 示 : 


public partial class MainForm : Form 


} 


public MainForm() 


InitializeComponent(); 


} 


private void MainForm Load(object sender, EventArgs e) 


// 在 TextBox 控 件 中 显示 当前 库存 的 XML 文档 


txtInventory.Text = LinqToXmlObjectModel.GetXmlInventory().ToString(); 


private void btnAddNewItem Click(object sender, EventArgs e) 


{ 
// 为 文档 添加 一 个 新 项 


LinqToXmlObjectModel.InsertNewElement (txtMake.Text, txtColor.Text, txtPetName.Text); 


// 在 TextBox 控 件 中 显示 当前 库存 的 XML 文 档 
} 


private void btnLookUpColors Click(object sender, EventArgs e) 


txtInventory.Text = LinqToXmlObjectModel .GetXmlInventory().ToString(); 


LinqToXmlObjectModel .LookUpColorsForMake(txtMakeToLookUp. Text); 


图 24-5 显 示 了 最 终 的 输出 结果 。 
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图 24-5 ”完整 的 LINQ to XML 应 用 程序 


这 就 是 所 有 对 于 LINQ to XML 的 介绍 和 关于 LINQ 的 研究 。 我 们 首先 在 第 12 章 引入 了 LINQ 并 学 习 
了 LINQ to Object。 第 19 章 演示 了 各 种 使 用 PLINQ 的 示例 ， 而 第 23 章 展示 了 如 何在 ADO.NET Entity 对 
象 中 使 用 LINQ。 有 了 这 些 知 识 ， 你 一 定 会 精神 饱满 地 继续 深入 研究 。 微 软 已 经 明确 表示 LINQ 将 会 
随 着 .NET 平 台 的 发 展 而 继续 不 断 改进 。 


源 代码 ”XML 示例 LinqToXmlWinApp 的 源 代 码 位 于 Chapter 24 子 目录 下 。 


24.5 小结 


本 章 考 察 了 LINQ to XML 的 作用 。 如 你 所 见 ， 该 API 是 随 .NET 平 台 发 布 的 原始 XML 操作 库 
System.Xml.dll 的 替代 品 。System.Xml.Linq.dll 采 用 一 种 自 上 而 下 的 方法 生成 新 的 XML 文档， 其 代码 结 
构 与 最 终 的 XML 数据 极其 接近 。 就 此 而 论 ，LINQ to XML 是 更 优秀 的 DOM。 我 们 还 学 习 了 如 何 通过 
各 种 方式 ( 解析、 从 文件 加 载 、 从 内 存 中 的 对 象 映射 ) 构建 XDocument 和 XElement， 以 及 如 何 使 用 LINQ 
查询 导航 和 操作 数据 。 





借 软 从 NET3.0 开 始 引 入 了 一 种 专门 用 来 构建 分 布 式 系统 的 API 一 一 WCF ( Windows Communication 
几 入 Foundation )。 与 你 过 去 所 使 用 的 其 他 分 布 式 API ( 如 DCOM、.NET Remoting 、XML Web 服 
务 、 消 息 队 列 等 ) 有 所 不 同 , WCF 提 供 了 统一 的 、 可 扩展 的 编程 对 象 模型 来 使 用 以 前 多 个 分 布 式 技术 。 

本 章 首先 通过 快速 浏览 前 面 的 分 布 式 计算 API 来 介绍 为 什么 需要 WCF 并 探究 它 所 要 解决 的 问题 。 
在 对 WCF 所 提供 的 服务 有 了 初步 的 了 解 之 后 ,我 们 将 转向 探究 代表 WCF 编 程 模型 的 .NET 程 序 集 、 命 
名 空间 和 类 型 。 然 后 在 本 章 的 其 余 篇 幅 中 , 我 们 将 使 用 不 同 的 WCF 开 发 工具 构建 几 种 WCF 服 务 端 、 宿 
主 和 客户 端 。 


说 明 ”本章 所 包含 的 代码 需要 你 以 管理 员 权 限 启 动 Visual Studio ( 而 且 你 也 必须 具有 管理 员 权 限 )。 要 
以 正确 的 管理 权限 启动 Visual Studio， 可 以 右 击 Visual Studio 图 标 ， 选 择 Run As Administrator。 


25.1 各 种 分 布 式 计算 API 


Windows 操 作 系统 过 去 提供 了 许多 用 于 构建 分 布 式 系统 的 API。 虽 然 大 多 数 人 认为 分 布 式 系统 包 
含 至 少 两 台 联网 的 计算 机 ， 但 是 这 个 术语 从 广义 上 说 只 是 指 两 个 可 执行 程序 需要 交换 数据 ， 即 使 它们 
运行 于 相同 的 物理 宿主 。 通 过 这 个 定义 ， 为 我 们 当前 的 编程 任务 选择 分 布 式 API 往 往 需要 解决 如 下 关 
键 问题 : 

这 个 系统 仅 在 “内 部 ”使 用 吗 ? 还 是 外 部 用 户 也 需要 访问 这 个 应 用 程序 的 功能 ? 

如 果 我 们 构建 内 部 使 用 的 分 布 式 系统 , 那么 我 们 就 有 更 多 选择 来 确保 每 一 个 相连 的 计算 机 都 运行 
于 相同 的 操作 系统 ， 使 用 相同 的 编程 模型 ( 如 .NET、COM 或 者 Java 平 台 )。 运 行内 部 系统 也 意味 着 可 
以 使 用 既 有 的 安全 系统 来 处 理 授权 、 验 证 等 。 这 样 , 我 们 就 可 能 希望 选择 局 限于 特定 操作 系统 /编程 杠 
架 的 特定 分 布 式 API 来 获得 更 好 的 性 能 。 

相反 ， 如 果 我 们 构建 的 系统 必须 从 防火 墙 外 部 被 访问 ， 我 们 就 要 处 理 其 他 一 些 问题 。 首 先 ， 我 们 
往往 不 能 限制 外 部 用 户 使 用 的 操作 系统 、 用 来 构建 软件 的 编程 框架 或 安全 设置 。 

此 外 ， 如 果 是 为 使 用 许多 操作 系统 和 编程 技术 的 大 型 公司 或 者 大 学 工作 ， 内 部 应 用 程序 也 就 面临 
着 和 面向 外 部 应 用 程序 相同 的 挑战 。 对 于 这 些 情 况 ， 我 们 需要 使 用 更 灵活 的 分 布 式 API 来 确保 应 用 程 
序 被 尽 可 能 地 访问 到 。 
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基于 针对 这 个 关键 的 分 布 式 计算 问题 的 答案 ， 下 一 个 任务 就 是 决定 究竟 要 使 用 哪个 API (或 一 组 
API )。 在 简单 的 概览 之 后 ， 下 面 的 小 节 会 简单 回顾 Windows 软 件 开发 人 员 过 去 使 用 的 一 些 主要 分 布 式 
API， 然 后 我 们 很 容易 就 能 看 到 WCF 的 有 用 之 处 了 。 


说 明 为 了 确保 我 们 说 的 是 同一 件 事情 ， 有 必要 指出 WCF ( 以 及 它 包 含 的 技术 ) 和 构建 基于 HTML 
的 网 站 没有 什么 关系 。 虽然 Web 应 用 程序 被 认为 是 “分 布 式 的 ”， 因 为 通常 在 交换 中 包含 两 个 
机 器 ， 但 是 WCF 是 用 来 创建 对 机 器 的 连接 以 共享 远程 组 件 功能 的 不 是 用 于 在 Web 浏 览 器 
上 显示 HTML。 第 32 章 会 研究 使 用 .NET 平 台 来 构建 网 站 。 





25.1.1 DCOM 的 作用 


在 .NET 平 台 发 布 之 前 , DCOM ( 分 布 式 组 件 对 象 模型 ) 是 微软 相关 开发 人 员 可 以 选择 的 远程 API。 
使 用 DCOM, 我 们 可 以 使 用 COM 对 象 、 系 统 注册 表 ( 以 及 大 量 体 力 劳动 ) 来 构建 分 布 式 系统 。DCOM 
的 一 个 优势 是 运行 组 件 的 位 置 透明 性 。 简 单 来 说 ， 可 以 不 通过 硬 编码 远程 对 象 物理 位 置地 址 来 为 客户 
端 软件 编程 。 不 管 远程 对 象 是 在 相同 的 机 器 上 还 是 在 二 级 网 络 计算 机 上 ， 代 码 还 是 能 保持 不 变 ， 因 为 
真实 路 径 记 录 在 外 部 的 系统 注册 表 中 。 

虽然 DCOM 确 实 有 一 定 的 成 功 ， 但 是 实际 上 它 是 Windows 相 关 的 API。 即 使 很 多 其 他 操作 系统 支 
持 DCOM，DCOM 本 身 并 没有 提供 一 个 结构 用 于 构建 包含 多 个 操作 系统 ( Windows、Unix、Max ) 的 
复杂 解决 方案 或 促进 多 个 不 同 架 构 ( COM 、Java、CORBA 等 ) 的 数据 分 享 。 


说 明 虽然 有 很 多 尝试 让 DCOM 能 运行 于 各 种 形式 的 Unix/Linux 上 ,但 是 最 后 的 结果 很 无 聊 ， 并 且 最 
终 变 成 了 技术 脚注 。 


总 体 来 说 , DCOM 非 常 适用 于 内 部 的 应 用 程序 开发 , 因为 把 COM 对 象 向 公司 防火 墙 外 部 公开 会 遇 
到 很 多 额外 的 困难 ( 防火 墙 等 ) 。 随 着 .NET 平 台 的 发 布 ，DCOM 马 上 就 变 成 了 遗留 编程 模型 。 如 果 我 
们 不 是 在 维护 遗留 的 DCOM 系 统 ， 就 可 以 认为 这 项 技术 是 不 推荐 的 。 


25.1.2 COM+/ 企 业 服 务 的 作用 


DCOM 只 是 定义 了 一 种 在 两 个 基于 COM 的 软件 之 间 创 建 通信 通道 的 方式 ,为 了 完善 用 于 构建 功能 
丰富 的 分 布 式 计算 解决 方案 ,微软 最 后 发 布 了 MTS ( 微软 事务 处 理 服务 器 )， 它 在 之 后 的 发 布 中 被 命 
名 为 COM+。 

不 管 名 字 是 什么 ， 不 仅 COM 程 序 员 能 使 用 COM+，.NET 人 员 也 可 以 访问 它 。 自 从 .NET 平 台 第 一 
次 发 布 以 来 ， 基 础 类 库 就 提供 了 一 个 叫 System.EnterpriseServices 的 命名 空间 。 在 这 里 ，.NET 程 序 员 
可 以 构建 能 安装 到 COM+ 运 行 库 的 托管 类 库 , 这 样 就 能 像 传统 的 COM+ 相 关 的 COM 服 务 器 一 样 访问 一 
组 服务 。 在 任何 一 种 情况 下 ,一旦 COM+ 相 关 类 库 安装 到 了 COM+ 运 行 库 中 ， 它 就 被 称 为 服务 组 件 。 

COM+ 提 供 了 许多 服务 组 件 可 以 利用 的 特性 ， 包 括 事务 管理 、 对 象 生命 周期 管理 、 池 服务 、 基 于 
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角色 的 安全 系统 、 松 耦合 的 事件 模型 等 。 这 是 COM+ 主 要 的 优势 ， 因 为 大 多 数 分 布 式 系统 都 需要 相同 
的 服务 集合 。COM+ 提 供 了 现成 的 解决 方案 ,而 开发 人 员 无 需 强制 来 手写 代码 。 

COM+ 非 常 好 的 一 个 方面 是 所 有 这 些 配 置 都 可 以 以 声明 方式 使 用 管理 工具 进行 配置 。 因 此 ， 如 有 果 
希望 确保 对 象 受 事务 上 下 文 监视 或 属于 某 个 安全 角色 ， 只 需要 选择 正确 的 复 选 框 。 

虽然 COM+/ 企 业 服 务 至 今 仍 在 使 用 ,但 是 这 个 技术 只 是 Windows 的 解决 方案 ,并且 最 适用 于 内 部 
应 用 程序 开发 或 作为 被 前 端 ( 如 在 后 台 调 用 服务 组 件 COM+ 对 象 的 公共 网 站 ) 间接 操作 的 后 台 服 务 。 


说 明 WCF 当 前 没有 提供 构建 服务 组 件 的 方式 。 然 而 ， 它 却 提 供 了 一 种 方式 让 WCF 服 务 和 既 有 的 
COM+ 对 象 进行 通信 。 如 果 你 希望 使 用 C# 构 建 服务 组 件 ， 我们 需要 直接 使 用 System. 
EnterpriseSerives 命 名 空间 。 细 节 请 参考 .NET Framework 4.5 SDK 文 档 。 





25.1.3 MSMQ 的 作用 


MSMQ ( 微软 消息 队列 ) API 可 用 来 构建 需要 确保 消息 数据 在 网 络 上 可 靠 传送 的 分 布 式 系统 。 
我 们 知道 ， 任 何 分 布 式 系统 都 存在 网 络 服务 器 停机 、 数 据 库 断 开 连接 或 由 于 各 种 原因 引起 的 连接 丢 
失 等 风险 。 此 外 ,许多 应 用 程序 需要 以 这 样 一 种 形式 来 构建 ， 那 就 是 保存 之 后 会 传递 的 数据 〈 叫做 
队列 数据 )。 

首先 ，MSMQ 被 打包 成 为 一 组 基于 C 的 低级 别 API 和 COM 对 象 。 同样 ,使 用 System.Messaging 命 名 
空间 ，.NET 程 序 员 可 以 连接 MSMQ 并 且 以 可 靠 方式 构建 和 间断 连接 应 用 程序 进行 通信 的 软件 。 

男 一 方面 ， COM+ 层 使 用 一 种 叫做 队列 组 件 (QC ) 的 技术 把 MSMQ 功 能 包含 到 了 运行 库 中 (以 简 
化 的 形式 )。 这 种 与 MSMQ 通 信 的 方式 被 打包 到 System.EnterpriseServices 命 名 空间 中 。 

不 管 我 们 使 用 哪 种 编程 模型 来 和 MSMQ 运 行 库 进行 交互 ,最终 结果 确保 了 应 用 程序 可 以 可 靠 并 
及 时 地 传递 数据 。 和 COM+ 相 似 ，MSMQ 仍 然 是 在 Windows 操 作 系 统 上 构建 分 布 式 软 件 的 结构 的 一 
部 分 。 


25.1.4 .NET Remoting 的 作用 


之 前 提 过 , 随 着 .NET 平 台 的 发 布 ,DCOM 很 快 就 成 为 了 遗留 分 布 式 API。.NET 基 础 类 库 附 带 了 .NET 
Remoting 层 ( 用 System.Runtime.Remoting 命 名 空间 表示 ) 来 替代 其 地 位 。 如 果 所 有 应 用 程序 都 运行 
在 .NET 平台 下 ， 这 个 (遗留 的 ) API 就 允许 多 个 计算 机 来 分 布 对 象 。 

.NET Remoting API 提 供 了 许多 有 用 的 特性 。 最 重要 的 就 是 使 用 基于 XML 的 配置 文件 以 声明 方式 
定义 客户 端 和 服务 端 软 件 使 用 的 基础 通道 。 使 用 *.config 文 件 , 只 需要 改变 配置 文件 的 内 容 并 且 重 启 应 
用 程序 就 可 以 简单 有 效 地 改变 分 布 式 系统 的 功能 。 

同样 ， 由 于 这 个 API 只 能 用 于 .NET 应 用 程序 ， 我 们 可 以 获得 各 种 性 能 优势 ， 因 为 数据 可 以 以 精简 
的 二 进 制 格式 进行 编码 , 并 且 在 定义 参数 和 返回 值 的 时 候 可 以 使 用 公共 类 型 系统 ( CTS )。 虽 然 可 以 使 
用 .NET Remoting 来 构建 跨越 多 个 操作 系统 的 分 布 式 系统 (通过 Mono， 在 第 1 章 中 简单 介绍 过 ), 但 是 
仍然 不 可 以 和 其 他 编程 架构 ( 如 Java ) 进行 直接 互 操作 。 
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25.1.5 XML Web 服 务 的 作用 


前 一 节 中 每 个 分 布 式 API 都 提供 了 一 点 〈 如 果 有 的 话 ) 允许 外 部 调用 者 以 不 可 知 的 方式 访问 提供 
功能 的 支持 。XML Web 服 务 提 供 了 最 直接 的 方式 , 使 我 们 可 以 将 远程 对 象 的 服务 向 任何 操作 系统 和 任 
何 编程 模型 公开 。 

和 传统 的 基于 浏览 器 的 Web 应 用 程序 不 同 ，Web 服 务 只 是 通过 标准 Web 协 议 公 开 远程 组 件 功 能 的 
一 种 方式 。 自 .NET 最 初 发 布 以 来 ，System.Web.Services 命 名 空间 就 支持 程序 员 构 建 和 使 用 XML Web 
服务 。 其 实 ， 在 很 多 情况 下 ， 构 建功 能 完整 的 Web 服 务 并 不 比 在 希望 提供 访问 的 公共 方法 上 应 用 
[WebMethod] 特 性 复杂 。 此 外 ，Visual Studio 人 允许 我 们 单 击 一 两 个 按钮 就 可 以 连接 到 远程 Web 服 务 。 

Web 服 务 允 许 开发 人 员 构 建 .NET 程 序 集 来 包含 通过 简单 HTTP 就 可 以 访问 的 类 型 。 此 外 ，Web 服 务 
以 简单 XML 编码 其 数据 。 由 于 Web 服 务 是 基于 工业 开放 标准 的 (HTTP、XML 、SOAP 等 ) 而 不 是 私有 
的 类 型 系统 和 私有 的 有 线 格式 ( 就 像 DCOM 或 ,NET Remoting 一 样 )， 它 们 允许 高 度 的 互 操作 性 和 数据 
交换 。 图 25-1 展 示 了 XML Web 服 务 的 多 变性 。 
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图 25-1 XML Web 服 务 具 有 非常 高 的 互 操作 性 


当然 , 没有 一 个 分 布 式 API 是 完美 的 。Web 服 务 一 个 潜在 的 缺点 是 它们 可 能 会 有 很 多 性 能 问题 ( 因 
为 HTTP 和 XML 数据 表示 的 使 用 ), 并 且 它 们 可 能 不 是 用 于 内 部 应 用 程序 的 理想 解决 方案 , 对 内 部 应 用 
程序 来 说 ， 基 于 TCP 的 协议 和 二 进 制 格式 化 的 数据 可 能 更 适合 。 

Web 服 务 标准 

Web 服 务 早 期 面临 的 另 一 个 主要 问题 是 ， 所 有 大 型 的 行业 公司 (微软 、IBM 和 SunMicroSystems ) 
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创建 的 Web 服 务实 现 都 不 能 和 其 他 Web 服 务实 现 100% 兼 容 。 很 明显 ， 这 是 一 个 问题 ， 因 为 Web 服 务 的 
主要 目的 就 是 实现 跨 平 台 、 跨 操作 系统 的 高 度 互 操作 性 。 

为 了 确保 Web 服 务 的 互 操 作 人 性 , 万 维 网 联盟 ( W3C, www.w3.org ) 和 Web 服 务 互 操作 性 组 织 ( WS-I， 
www.ws-i.org ) 等 已 经 开始 编写 规范 来 确保 软件 供应 商 ( 如 微软 、IBM 以 及 SunMicroSystems ) 应 该 如 
何 构建 Web 服 务 相关 的 软件 类 库 来 确保 互 操作 性 。 

总 体 来 说 ， 所 有 这 些 规范 都 以 WS-* 作 为 名 字 并 且 覆 盖 了 安全 、 附 件 以 及 Web 服 务 描述 (通过 Web 
服务 描述 语言 或 WSDL )、 策 略 、SOAP 格 式 以 及 其 他 重要 细节 的 问题 。 我 们 将 看 到 ，WCF 支 持 很 多 
WS-* 规 范 。 通 常 WCF 服 务 会 基于 你 选择 的 绑 定 来 选择 不 同 的 WS-* 规 范 。 


说 明 除了 分 布 式 API， 开 发 人 员 还 可 以 利用 各 种 进程 间 通 信 协 议 ， 如 命名 管道 和 套 接 字 。 
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从 之 前 的 一 些 内 容 中 你 已 经 发 现 ， 这 么 多 分 布 式 技术 使 得 我 们 很 难 选择 合适 的 。 更 复杂 的 是 某 些 
技术 提供 的 功能 还 有 重 友 (最 常见 的 就 是 事务 和 安全 )。 

即使 NET 开 发 人 员 已 经 为 手头 的 任务 选择 了 看 上 去 “正确 ”的 技术 , 但 是 构建 、 维 护 和 配置 这 样 
一 个 程序 也 很 复杂 。 每 一 个 API 都 有 自己 的 编程 模型 、 独 有 的 配置 工具 等 。 因 此 ， 在 WCEF 之 前 ， 如 果 
不 编写 大 量 自 定义 基础 结构 的 话 ， 就 很 难 实现 即 插 即 用 的 分 布 式 API。 例如， 如 果 使 用 .NET Remoting 
API 来 构建 系统 ， 之 后 又 觉得 XML Web 服 务 是 更 合适 的 解决 方案 ， 那 么 就 需要 重新 写 代 码 。 

WCF 是 分 布 式 计算 工具 包 , 它 把 之 前 这 些 独立 的 分 布 式 技术 整合 到 了 主要 由 System.ServiceModel 
命名 空间 表示 的 简化 API 中 。 使 用 WCF ， 我 们 就 可 以 使 用 大 量 的 技术 来 将 服务 公开 给 调用 者 。 例 如 ， 
如 果 要 构建 一 个 内 部 的 应 用 程序 ， 所 有 计算 机 都 是 基于 Windows 的 ， 就 可 以 使 用 各 种 TCP 协 议 来 确保 
最 快 的 性 能 。 相 同 的 服务 也 完全 可 以 使 用 HTTP 和 SOAP 进 行 公 开 ， 使 得 外 部 调用 者 可 以 利用 其 功能 ， 
而 无 须 考虑 编程 语言 和 操作 系统 。 

由 于 WCF 人 允许 我 们 为 工作 选择 正确 的 协议 ( 使 用 通用 的 编程 模型 )， 我 们 可 以 很 容易 地 为 分 布 式 
应 用 程序 实现 即 插 即 用 的 基础 管道 。 在 大 多 数 情 况 下 , 我 们 不 需要 重新 编译 或 重新 部 署 客户 端 /服务 端 
软件 就 可 以 完成 ， 因 为 这 些 细 节 都 交 给 了 应 用 程序 配置 文件 。 


25.2.1 ”WCF 特性 概览 


不 同 API 之 间 的 互 操作 性 和 整合 只 是 WCF 中 的 两 个 重要 方面 。 此 外 ， WCF 提 供 了 一 个 丰富 的 软件 
框架 ,该 框架 与 WCF 所 提供 的 远程 技术 相辅相成 。 请 看 下 列 WCF 核 心服 务 。 
口 支持 强 类 型 与 无 类 型 消息 。 这 就 允许 .NET 应 用 程序 共享 自 定义 类 型 ;与 此 同时 ， 使 用 其 他 平 
台 〈 如 Java ) 创建 的 软件 可 以 使 用 松散 类 型 的 XML 流 。 
口 支持 若干 绑 定 (binding ) ( 原始 HTTP、TCP、MSMQ 和 命名 管道 )， 这 就 允许 你 选择 最 合适 的 
方式 去 传输 和 接收 数据 。 
口 支持 最 新 和 最 高 级 的 Web 服 务 规范 ( WS-* ) 。 
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口 一 个 完全 整合 的 安全 模型 ， 它 包括 原生 Windows/.NET 安 全 协议 和 许多 构建 在 Web 服 务 标准 之 
上 的 中 性 安全 技术 。 
口 对 会 话 之 类 的 状态 管理 技术 的 支持 以 及 对 单 向 无 状态 消息 的 支持 。 
虽然 列 出 的 这 些 特性 用 处 很 大 , 但 它 其 实 只 是 WCF 的 一 小 部 分 功能 。 此外, WCF 还 提供 了 跟踪 和 
调试 功能 、 性 能 计数 器 、 发 布 订阅 事件 模型 以 及 事务 支持 。 


25.2.2” SOA 概览 


WCF 的 另外 一 个 优势 在 于 , 它 以 SOA ( 面向 服务 架构 ) 所 确立 的 设计 原则 为 基础 。 不 可 否认 , SOA 
是 业界 的 一 个 热点 ， 和 其 他 热点 一 样 ，SOA 可 以 以 各 种 方式 来 定义 。 简 单 来 说 ，SOA 是 设计 分 布 式 系 
统 的 一 种 方式 ， 它 通过 使 用 明确 定义 的 接口 通过 跨越 边界 ( 可 以 是 联网 的 计算 机 或 只 是 同一 个 机 器 的 
两 个 进程 ) 传递 消息 来 让 多 个 独立 的 服务 协同 工作 。 

在 WCF 的 世界 中 ， 这 些 “ 明 确定 义 的 接口 ”通常 使 用 实际 的 CLR 接 口 类 型 来 创建 ( 见 第 9 章 ) 。 
然而 ， 更 广义 地 说 ， 服 务 的 接口 只 是 描述 了 会 由 外 部 调用 者 调用 的 一 组 成 员 。 

在 设计 WCF 时 ，WCF 团 队 贯彻 了 SOA 设 计 准则 的 4 个 原则 。 虽 然 在 构建 WCF 应 用 程序 时 ， 通 常会 
自动 遵守 这 些 原则 ， 但 是 理解 SOA 的 这 4 个 最 主要 的 设计 原则 有 助 于 我 们 更 深刻 地 理解 WCF。 下 面 这 
部 分 内 容 简单 介绍 了 每 个 原则 。 

1. 原则 1: 边界 是 明确 的 

这 个 原则 强调 的 是 WCF 服 务 的 功能 是 通过 定义 明确 的 接口 进行 表达 的 ( 如 每 一 个 成 员 的 描述 、 其 
参数 以 及 返回 值 )。 外 部 调用 者 和 WCF 服 务 通信 的 唯一 方式 就 是 通过 这 个 接口 ， 并 且 外 部 调用 者 还 是 
对 底层 的 实现 细节 一 无 所 知 。 

2. 原则 2:， 服务 是 独立 的 

说 服务 是 “独立 ”实体 ,我 们 指 某 个 WCF 服 务 ( 尽 可 能 ) 是 可 以 独立 存在 的 。 一 个 独立 的 服务 对 
于 版 本 问题 、 部 署 问 题 和 安装 问题 来 说 应 该 是 独立 的 。 我 们 再 来 回顾 一 下 基于 接口 编程 的 主要 方面 。 
在 产品 中 接口 应 该 永远 不 能 修改 ( 否则 就 会 有 打破 既 有 客户 端的 危险 )。 如 果 我 们 需要 为 WCF 服 务 扩 
展 功能 ， 只 能 编写 新 的 接口 来 实现 新 的 功能 。 | 

3. 原则 3: 服务 通过 契约 而 不 是 实现 进行 通信 

第 3 个 原则 也 是 基于 接口 编程 的 另 一 个 副产品 ， 因 为 外 部 调用 者 不 关心 WCF 服 务 的 实现 细节 (用 
哪个 语言 写 的 ， 怎 么 完成 工作 的 ， 等 等 )。WCF 客 户 端 仅仅 通过 它们 公共 的 公共 接口 来 和 服务 进行 交 
互 。 此 外 ， 如 果 服 务 接口 的 成 员 公 开 了 自 定 义 的 复杂 类 型 ， 就 需要 完整 描述 数据 契约 的 细节 来 确保 所 
有 调用 者 可 以 把 内 容 映射 到 某 个 数据 结构 。 

4. 原则 4: 服务 兼容 性 基于 策略 

由 于 CLR 接 口 为 所 有 WCF 客 户 端 提供 了 强 类 型 的 契约 ( 也 会 根据 我 们 选择 的 绑 定 用 来 生成 相关 
的 WSDL 文 档 ), 值得 指出 的 是 , 接口 /WSDL 本 身 还 不 足够 描述 服务 能 够 做 什么 的 细节 。 因此 ,SOA 
允许 我 们 定义 策略 来 进一步 限定 服务 的 语法 ( 如 期 望 用 于 和 服务 通信 的 安全 需求 )。 使 用 这 些 策略 ， 
我 们 就 可 以 把 服务 如 何 工 作 和 如 何 被 调用 的 语法 细节 与 服务 低级 别 句法 描述 (公开 的 接口 ) 进行 分 
离 了 。 
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25.2.3 ”WCF 概要 


这 些 历史 经 验 告 诉 我 们 WCF 是 构建 分 布 式 应 用 程序 的 首选 方式 。 无论 我 们 打算 使 用 TCP 协 议 构 建 
内 部 的 应 用 程序 ， 使 用 命 ey 还 是 使 用 基于 HTTP 的 协议 向 整个 世界 公开 
数据 ，WCF 都 是 推荐 的 API。 

这 不 是 说 有 了 新 的 开发 方案 ， 我 们 就 不 能 使 用 原始 的 .NET 分 布 式 相关 的 命名 空间 了 ( System. 
Runtime.Remoting、 System.Messaging、 System.EnterpriseServices、System.Web.Services 等 )。 其 实 ， 
在 一 些 情况 下 (特别 是 需要 构建 COM+ 对 象 时 ), 我 们 也 必须 这 么 做 。 如 果 在 之 前 项 目 中 已 经 使 用 过 这 
些 API, 你 会 发 现 学 习 WCF 相 当 简 单 。 和 之 前 的 技术 相似 , WCF 使 用 了 大 量 基于 XML 的 配置 文件 、.NET 
特性 和 代理 生成 工具 。 

有 了 这 样 介绍 性 的 内 容 之 后 , 现在 可 以 转 到 真实 构建 WCF 应 用 程序 的 主题 上 来 了 。 同 样 , 对 WCF 
的 完整 研究 可 能 需要 完整 的 一 本 书 ， 因 为 支持 的 每 一 个 服务 (MSMQ、COM+、P2P、 命 名 管道 等 ) 
都 可 以 写 一 章 。 在 这 里 , 我 们 会 学 习 使 用 基于 TCP 和 HTTP ( 如 Web 服 务 等 ) 的 协议 构建 WCF 程 序 的 完 
整 步骤 。 这 将 为 你 将 来 的 学 习 打 下 很 好 的 基础 。 


25.3 WCF 核心 程序 集 


正如 你 所 想到 的 ，WCF 的 功能 由 安装 在 GAC (全 局 程序 集 缓存 ) 里 面 的 一 组 NET 程序 集 所 表示 。 
表 25-1 描 述 了 每 一 个 WCF 程 序 集 的 总 体 功 能 。 


表 25-1 WCF 核 心 程 序 集 


程 序 集 作 用 
System.Runtime. Serialization.dl]l 该 核心 程序 集 定义 了 一 些 用 于 在 WCF 框 架 中 序列 化 和 反 序 列 化 对 象 的 命 
名 空间 和 类 型 
System. ServiceModel.d1l 包含 了 核心 类 型 的 核心 程序 集 。 这 些 核心 类 型 用 于 构建 任何 种 类 的 WCF 
应 用 程序 


表 25-1 列 出 的 这 两 个 核心 程序 集 定义 了 一 些 新 的 命名 空间 和 类 型 。 表 25-2 列 出 了 一 些 你 应 该 知道 
的 核心 命名 空间 的 作用 ， 更 加 完整 详细 的 说 明 请 查阅 .NET Framework 4.5 SDK 文 档 。 


表 25-2 ”WCF 核心 命 名 空间 


命名 空间 作 用 
SystemRuntime, Serialization 定义 了 一 些 用 来 控制 在 WCF 框 架 中 如 何 序列 化 和 反 序 列 化 数据 的 类 型 
ystemsericeModel 定义 了 绑 定 和 承载 类 型 ， 以 及 基础 安全 和 事务 类 型 
System. ServiceModel .Configuration 定义 了 提供 对 WCF 配 置 文件 核心 部 分 进行 编程 访问 的 各 种 类 型 
SEE Deseription 定义 了 一 些 类 型 ， 为 在 WCF 配 置 文件 中 定义 的 地 址 、 绑 定 和 契约 提供 对 
象 模型 


System.ServiceModel .MsmqIntegration 包含 了 用 来 与 MSMQ 服 务 进行 整合 的 类 型 
System.ServiceModel .Security 定义 了 用 来 控制 WCF 安 全 层 的 种 种 类 型 
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25.4 ” Visual Studio WCF 项 目 模板 


WCF 应 用 程序 一 般 由 三 个 相互 关联 的 程序 集 表示 ( 本 章 稍 后 会 更 详细 解释 )， 其 中 一 个 就 是 *.dll 
( 换 句 话说 就 是 WCF 服 务 本 身 ), 外 部 调用 者 可 以 和 它 包含 的 类 型 进行 通信 。 如 果 你 希望 构建 WCF 服 务 
的 话 ， 完 全 可 以 选择 标准 的 类 库 项 目 模 板 ( 见 第 14 章 ) 作为 起 始点 并 且 和 手动 引用 WCF 程 序 集 。 

或 者 还 可 以 通过 选择 Visual Studio 的 WCF 服 务 库 ( Service Library ) 项 目 模板 来 新 建 一 个 WCF 服 务 ， 
如 图 25-2 所 示 。 这 个 项 目 类 型 自动 设置 必要 的 WCF 程 序 集 引 用 ,然而 ， 它 还 生成 很 多 常常 会 被 删除 的 
“初始 代码 ”。 


er 








atch Installed Templates 





WCF Service Library Vesual Cs We ele 
[se Ee A project for creating a host-independent 
WCF Sece Library Vi WCF service class fibrary (dl 

ua 





WCF Service Application 
CF Workflow Service Application Visual C# 


Syndication Service Library Visyual Cs 


© Create directory for solution 
忆 Addto source control 





图 25-2 ”Visual Studio WCF 服 务 类 库 项 目 模 板 

选择 WCF 服 务 库 项 目 模板 的 一 个 好 处 是 ， 它 还 提供 了 一 个 App.config 文 件 ， 可 能 你 会 感到 奇怪 ， 
因为 我 们 构建 的 是 .NET*.dll 而 不 是 .NET *.exe。 然 而 ， 这 个 文件 在 我 们 调试 或 者 运行 WCF 服 务 库 项 目 
的 时 候 非 常 有 用 ，Visual Studio IDE 会 自动 启动 WCF 测 试 客户 端 控 制 台 。 这 个 程序 ( WcfTestClient.exe ) 


会 读 取 App.config 中 的 配置 , 为 了 测试 目的 而 承载 我 们 的 服务 。 在 本 章 后 面 , 我 们 会 学 到 更 多 有 关 WCF 
测试 客户 端的 内 容 。 


说 明 WCF 服 务 库 项 目的 App.config 文 件 同 样 有 用 ,因为 它 显示 了 用 于 配置 WCF 宿 主 应 用 程序 的 基本 
设置 。 其实， 你 可 以 复制 大 多 数 代 码 并 粘贴 到 产品 服务 的 配置 文件 中 。 
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除了 基本 WCF 服 务 库 模板 外 ，New Project 对 话 框 的 WCF 项 目 分 类 定义 了 两 个 WCF 库 项 目 来 将 WF 
功能 集成 到 WCF 服 务 中 , 还 定义 了 一 个 构建 RSS 库 的 模板 ( 可 以 从 图 25-2 中 看 到 )。 下 一 章 会 介绍 WF， 
因此 现在 忽略 这 些 特 殊 的 WCF 项 目 模 板 (我 会 把 它 留 给 感 兴趣 的 读者 来 深入 RSS 提 要 项 目 模板 )。 


WCF 服 务 网 站 项 目 模 板 
事实 上 ，New Web Site 对 话 框 中 ,[ 通过 File 一 New 一 WebSite 菜 单项 来 激活 它 ( 如 图 25-3 所 示 ) ] 
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图 25-3 ”Visual Studio 基 于 Web 的 WCF 服 务 项 目 模 板 

如 果 你 一 开始 就 知道 WCF 服 务 会 使 用 基于 HTTP 的 协议 而 不 是 诸如 TCP 或 命名 管道 的 协议 ， 这 个 
WCF 服 务 项 目 模板 很 有 用 。 这 个 选项 可 以 自动 创建 新 的 IIS 虚 拟 目录 来 包含 我 们 的 WCF 程 序 文件 ， 创 
建 正 确 的 web.config 文 件 来 通过 HTTP 公 开 服 务 并 且 编 写 必 要 的 *.svc 文 件 (本 章 后 面 会 介绍 更 多 有 关 
*.svc 文 件 的 知识 )。 这 样 的 话 ， 这 个 基于 Web 的 WCF 服 务 项 目 只 是 节省 了 时 间 ， 因 为 IDE 会 自动 设置 必 
要 的 IS 基 础 结构 。 

相反 ， 如 果 使 用 WCF 服 务 库 选 项 构建 新 的 WCF 服 务 的 话 ， 就 可 以 以 各 种 形式 ( 自 定义 宿主 、 
Windows 服 务 、 在 IIS 中 手动 创建 虚拟 目录 等 ) 来 承载 服务 。 如 果 你 需要 为 WCF 服 务 构建 自 定 义 宿主 的 
话 ， 这 个 选项 就 更 合适 。 


25.5 ”WCF 应 用 程序 的 基本 构成 


构建 WCF 分 布 式 系统 时 ， 一 般 会 创建 3 个 相互 关联 的 程序 集 。 

口 WCF 服 务 程序 集 : 这 个 *.dll 包 含 了 表示 希望 向 外 部 用 户 公 开 的 整体 功能 的 类 和 接口 。 
口 WCF 服 务 宿主 : 这 个 软件 模块 是 承载 WCF 服 务 程序 集 的 实体 。 

口 WCF 客 户 端 这 是 通过 中 间 代 理 访问 服务 功能 的 应 用 程序 。 
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之 前 说 过 ，WCF 服 务 程序 集 是 一 个 NET 类 库 ， 它 包含 了 许多 WCF 契 约 和 它们 的 实现 。 唯 一 区 别 
是 接口 契约 使 用 各 种 特性 修饰 来 控制 数据 类 型 表示 、WCF 运 行 库 如 何 和 公开 的 类 型 进行 交互 等 。 

第 二 个 程序 集 WCF 服 务 宿 主 可 以 是 任何 .NET 可 执行 程序 。 在 本 章 中 我 们 会 看 到 ，WCF 可 以 设置 
使 用 任何 类 型 的 应 用 程序 ( Windows Forms 、Windows 服 务 、WPF 应 用 程序 等 ) 来 公开 。 如 果 你 在 构 
建 自 定义 宿主 的 话 ， 就 会 使 用 ServiceHost 类 型 和 相关 的 *.config 文 件 ， 它 包含 了 有 关 和 希望 使 用 的 服务 
端 管 道 的 细节 。 然 而 ， 如 果 你 使 用 IIS 作 为 WCF 服 务 宿主 的 话 ， 就 不 需要 以 编程 方式 构建 自 定义 宿主 ， 
因为 IIS 会 在 后 台 使 用 ServiceHost 类 型 。 


说 明 还 可 以 使 用 Windows Activation Service ( WAS ) 来 承载 WCF 服 务 ， 更 多 细节 请 参考 .NET 
Framework 4.5 SDK 文 档 。 


最 后 一 个 程序 集 表示 发 起 对 WCF 服 务 的 调用 的 客户 端 。 像 你 期 望 的 那样 , 客户 端 可 以 是 任何 类 型 
的 .NET 应 用 程序 。 和 宿主 相似 ， 客 户 端 应 用 程序 通常 还 使 用 客户 端 *.config 文 件 来 定义 客户 端 管道 。 
你 应 该 也 注意 到 ， 如 果 使 用 基于 HTTP 的 绑 定 构建 WCF 服 务 ， 很 容易 用 另 一 框架 ( 如 Java ) 来 编写 客 
户 端 应 用 程序 。 

图 25-4 从 宏观 上 显示 了 这 3 个 WCF 程 序 集 之 间 的 关系 。 你 可 能 会 假设 ,在 背后 还 有 几 个 用 于 表示 
必要 的 管道 ( 工厂、 信道 、 侦 听 器 等 ) 的 底层 细节 。 这 些 底层 细节 一 般 看 不 到 ， 但 是 如 果 需 要 的 话 可 
以 扩展 或 自 定 义 。 大 多 数 情况 下 ， 默 认 管道 可 以 满足 要 求 。 


客户 端 应 用 程序 





图 25-4 从 宏观 上 看 典型 的 WCF 应 用 程序 
还 值得 指出 的 是 ,从 技术 上 说 , 使 用 服务 端 或 客户 端 *.config 文 件 是 可 选 的 。 如 果 你 希望 的 话 ， 可 
以 硬 编码 宿主 和 客户 端 来 指定 必要 的 管道 (终结 点 、 绑 定 、 地 址 等 )。 使 用 这 种 方式 明显 的 问题 是 ， 
如 果 你 需要 改变 管道 细节 ,就 需要 重 写 代 码 , 重新 编译 并 且 重 新 部 署 许多 程序 集 。 使 用 *.config 文 件 能 
让 我 们 的 代码 更 灵活 ， 因 为 改变 管道 就 是 更 新 文件 内 容 并 且 重 启 应 用 程序 这 么 简单 。 另 一 方面 ， 在 程 
序 中 编写 的 配置 也 可 以 使 应 用 程序 更 灵活 ， 例 如 ， 可 以 基于 if 条 件 测 试 来 选择 如 何 配置 管道 。 


25.6 WCF 的 ABC 


宿主 和 客户 端 相互 通信 会 遵循 ABC。 再 提醒 一 下 ,注意 构建 WCF 应 用 程序 的 核心 模块 ， 具体 而 言 
就 是 地 址 ( A，address )、 绑 定 ( B，binding ) 和 回 约 ( C，contract )。 
口 地 址 : 服务 的 位 置 。 在 代码 中 ， 用 System.Uri 类 型 表示 ， 然 而 ， 值 一 般 保存 在 *.config 文 件 中 。 
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口 绑 定 : WCF 附 带 了 许多 不 同 的 绑 定 来 指定 网 络 协议 、 编 码 机 制 和 传输 层 。 

口 契约 : 从 WCF 服 务 公 开 的 每 一 个 方法 的 描述 。 

请 务必 了 解 , 缩 略语 ABC 并 不 意味 着 开发 人 员 必 须 首 先 定义 地 址 , 然后 定义 绑 定 , 最 后 定义 契约 。 
在 许多 情况 下 ，WCF 开 发 人 员 都 是 首先 为 服务 定义 契约 ， 然 后 定义 地 址 和 绑 定 (其 实 它们 的 先后 次 序 
是 不 重要 的 ， 只 要 每 个 方面 都 考虑 到 即 可 )。 在 构建 第 一 个 WCF 应 用 程序 之 前 ， 先 来 研究 这 3 个 元 素 。 


25.6.1 WCF 契 约 


问 约 的 概念 对 于 构建 WCF 服 务 来 说 是 关键 的 。 尽 管 不 是 强制 性 的 ， 但 是 绝 大 部 分 WCF 应 用 程序 都 会 首 
先 定义 一 组 .NET 接口 类 型 。 这 些 类 型 用 来 表示 某 一 给 定 的 WCF 类 型 将 会 支持 的 一 组 成 员 。 确 切 地 说 ， 表 示 
WCF 契 约 的 接口 称 作 服务 契约 。 实 现 了 这 些 接口 的 类 (或 者 结构 ) 称 作 服务 类 型 。 

WCF 服 务 契 约 标记 了 各 种 特性 , 最 常见 的 特性 定义 在 System.ServiceModel 命 名 空间 中 。 如 果 服 务 
契约 的 成 员 只 包含 简单 数据 类 型 ( 如 数值 数据 、 布 尔 值 和 字符 串 数据 )， 我 们 就 可 以 只 使 用 
[ServiceContract] 和 [OperationContract] 特 性 来 构建 一 个 完整 的 WCF 服 务 。 

然而 ， 如 果 你 的 成 员 公 开 自 定义 类 型 ， 就 会 使 用 System.Runtime.Serialization.dll 程 序 集中 的 
System.Runtime.Serialization 命 名 空间 中 (如 图 25-5 所 示 ) 的 不 同类 型 。 这 里 你 可 以 用 其 他 特性 (如 
[DataMember] 和 [DataContract] ) 来 完善 定义 过 程 ， 包 括 复合 类 型 在 传递 给 服务 操作 时 如 何 序列 化 为 
XML， 反 之 亦 然 。 


4 * System,Runtime.Serialization [局 
内 
b 加 CollectionDataContractattribute 
by oy ContractNamespaceAttribute 
by se DataContractAttribute 
b> os DataContractResolver 
b Wh DataContractSerializer 
| b to DataContractSerializerSettings 
| 》 ts DataMemberAttribute 
| b % DateTimeFormat 
| bs EmitTypelnformation 
| b ts EnumMemberAttribute 
| Db By ExportOptions 
| b 如 EdensionDataObject 
> “© IDataContractSurrogate 
| b *0 lIExtensibleDataObject 
| by Wy lgnoreDataMemberAttribute 
| 
| 
[ 
| 


| 


2 


> ss ImportOptions 

b ts InvalidDataContractException 
by ts KnownTypeAttribute 

b Ws NetDataContractSerializer 

b ts XmilObjectSerializer 

b> te XmilSerializableServices 

| 》 $s XPathQueryGenerator 

> Wy XsdDataContractExporter 

b os XsdDataContractimporter 


hb _{Y Suctem Rintime Serializatinn Tnnfinuratint 
振 } + 


图 25-5 System.Runtime.Serialization 定 义 了 许多 构建 WCF 数 据 契 约 时 使 用 的 特性 
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严格 地 说 ,我 们 不 需要 使 用 CLR 接 口 来 定义 WCF 超 约 。 很 多 这 些 特性 都 可 以 应 用 在 公共 类 ( 或 结 
构 ) 的 公共 成 员 上 。 然 而 ， 由 于 基于 接口 编程 具有 许多 优势 ( 多 态 、 优 雅 的 版 本 控制 等 )， 作 为 最 佳 
实践 还 是 应 该 考虑 使 用 CLR 接 口 来 描述 WCF 契 约 。 


25.6.2”WCF 绑 定 


一 旦 定义 并 实现 了 一 个 (或 者 一 组 ) 契约 后 ， 接 下 来 就 该 为 WCF 服 务 构建 承载 代理 了 。 你 会 看 到 
有 多 种 承载 方式 可 供 选 择 ， 所 有 这 些 承载 都 必须 指明 一 些 绑 定 ， 远 程 调用 者 通过 使 用 这 些 绑 定 来 获取 
对 服务 类 型 功能 的 访问 。 

WCF 附 带 了 许多 绑 定 选择 ， 每 一 个 都 针 定 特定 的 需要 。 如 果 所 有 的 现成 绑 定 都 不 能 满足 要 求 ， 还 
可 以 通过 扩展 CustomBinding 类 型 来 创建 自己 的 扩展 ( 本 章 不 会 介绍 这 个 )。 简 而 言 之 ，WCF 绑 定 可 以 
指定 如 下 特性 。 

口 用 于 移动 数据 的 传输 层 (HTTP 、MSMQ 、 命 名 管道 、TCP )。 

口 用 于 传输 的 信道 〈( 单 向 、 请 求 响应 、 双 向 )。 

口 用 于 处 理 数 据 本 身 的 编码 机 制 (XML 、 二 进 制 等 )。 

口 任何 被 支持 的 Web 服 务 协议 〈 如 果 绑 定 允 许 ) ， 如 WS-Security 、WS-Transaction 、WS-Relia- 

bility 等 。 

让 我 们 看 一 下 我 们 的 选择 。 

1. 基于 HTTP 的 绑 定 

BasicHttpBinding 、WSHttpBinding、WSDualHttpBinding 和 WSFederationHttpBinding 选 项 都 可 以 通 
过 HTTP/SOAP 协 议 来 公开 契约 类 型 。 很 明显 , 如果 需 要 尽 可 能 多 地 接触 到 服务 (多 操作 系统 和 多 编程 
架构 ), 就 可 以 关注 这 些 绑 定 ,因为 所 有 这 些 类 型 都 根据 XML 表示 来 编码 数据 并 且 在 网 络 上 使 用 HTTP。 

表 25-3 中 的 每 一 种 WCF 绑 定 在 代码 中 都 可 由 System.ServiceModel 命 名 空间 中 的 一 种 类 类 型 来 表 
示 ， 或 者 表示 为 *.config 文 件 中 所 定义 的 XML 属性 。 


表 25-3”WCF 提 供 的 HTTP 相 关 绑 定 
绑 定 类 绑 定 元 素 含 义 

BasicHttpBinding <basicHttpBinding> 用 来 构建 符合 WS-Basic Profile ( WS-I Basic 
Profile 1.1 ) 的 WCF 服 务 。 该 绑 定 使 用 HTTP 作 
为 传输 ， 使 用 TexVXML 作 为 默认 的 消息 编码 

WSHttpBinding <wsHttpBinding> 和 BasicHttpBinding 相 似 , 但 是 提供 了 更 多 Web 
服务 特性 。 这 个 绑 定 增加 了 对 事务 、 可 靠 消息 
和 WS-Addressing 的 支持 

WSDualHttpBinding <wsDualHttpBinding> 和 WsHttpBinding 相 似 , 但 是 用 于 双向 契约 ( 如 
服务 和 客户 端 可 以 互相 传递 消息 )。 这 个 绑 定 
只 支持 SOAP 安 全 并 且 需 要 可 靠 消息 

WSFederationHttpBinding <wsFederationHttpBinding> 一 种 支持 WS-Federation 协 议 , 安全 且 可 互 操作 
的 绑 定 。 使 联合 ( federation ) 内 的 组 织 可 以 高 
效 地 对 用 户 进行 验证 和 授权 
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正如 其 名 ，BasicHttpBinding 是 所 有 Web 服 务 相 关 协 议 中 最 简单 的 。 准 确 地 说 ， 这 个 绑 定 会 确保 
我 们 的 WCF 服 务 遵守 由 WS-I 定 义 的 WS-I Basic Profile 1.1 规 范 。 使 用 这 个 绑 定 主要 是 为 了 维持 之 前 和 
ASPNET Web 服 务 ( 从 1.0 版 本 开始 就 是 .NET 类 库 的 一 部 分 ) 通信 的 应 用 程序 的 向 后 兼容 性 。 

WsHttpBinding 协 议 不 仅仅 提供 了 对 WS-* 规 范 的 支持 ( 事务、 安全 和 可 靠 会 话 )， 还 支持 使 用 消息 
传输 优化 机 制 (MTOM ) 处 理 二 进 制 数据 编码 的 能 力 。 

WSDualHttpBinding 的 主要 优势 是 它 允 许 调 用 者 和 发 送 者 使 用 双向 消息 进行 通信 。 如 果 选 择 了 
WSDualHttpBinding， 我 们 就 可 以 挂 接 到 WCF 发 布 /订阅 事件 模型 。 

最 后 ， 如 果 安 全 性 是 最 重要 的 话 ， 可 以 考虑 WSFederationHttpBinding 这 个 基于 Web 服 务 的 协议 。 这 
个 绑 定 支持 WS-Tmst、WS-Security 以 及 WS-SecureConversation 规 范 ， 它 们 由 WCF CardSpace API 表 示 。 

2. 基于 TCP 的 绑 定 

如 果 你 构建 的 分 布 式 应 用 程序 包括 使 用 .NET 4.5 类 库 进 行 配 置 的 机 器 ( 换 句 话说 ， 所 有 的 机 器 都 
运行 于 Windows 操 作 系统 )， 我 们 就 可 以 不 使 用 Web 服 务 绑 定 而 使 用 TCP 绑 定 来 获取 一 些 性 能 优势 ， 它 
保证 了 所 有 数据 都 以 紧凑 二 进 制 格式 而 不 是 XML 来 编码 。 同 样 ， 如 果 使 用 表 25-4 中 列 出 的 绑 定 ， 客 户 
端 和 宿主 必须 是 .NET 应 用 程序 。 


表 25-4 TCP 相 关 的 WCF 绑 定 


绑 定 类 绑 定 元 素 作 用 
NetNamedPipeBinding <netNamedPipeBinding> 用 于 相同 机 器 上 .NET 应 用 程序 之 间 通 信 的 安全 的 、 可 靠 
的 、 优 化 的 绑 定 
NetPeerTcpBinding <netPeerTcpBinding> 提供 了 P2P 网 络 应 用 程序 安全 的 绑 定 
NetTcpBinding <netTcpBinding> 适合 .NET 应 用 程序 跨 机 器 通信 的 安全 的 优化 的 绑 定 


NetTcpBinding 类 使 用 TCP 在 客户 端 和 WCF 服 务 之 间 移 动 二 进 制 数据 。 之 前 提 过 ， 这 会 比 Web 服 务 
协议 有 更 好 的 性 能 ， 但 是 这 只 能 是 内 部 的 Windows 解 决 方案 。 好 的 一 面 是 NetTcpBinding 支 持 事务 、 可 
靠 会 话 和 安全 通信 。 

和 NetTcpBinding 相 似 ，NetNamedPipeBinding 支 持 事务 、 可 靠 会 话 和 安全 通信 ,但 是 不 能 跨 机 器 调 
用 。 如 果 我 们 要 以 最 快 的 方式 在 相同 机 器 WCF 应 用 程序 之 间 ( 如 跨 应 用 程序 域 通信 ) 推送 数据 ， 
NetNamedPipeBinding 是 最 佳 选择 。 要 了 解 NetPeerTcpBinding, 请 参考 .NET Framework 4.5 文 档 有 关 P2P 
网 络 的 细节 。 

3. 基于 MSMQ 的 绑 定 

最 后 ， 如 果 要 整合 微软 MSMQ 服 务 器 ， 就 要 看 一 下 NetMsmqBinding 和 MsmqIntergrationBinding 绑 
定 。 在 本 章 中 ， 我 们 不 会 研究 使 用 MSMQ 绑 定 的 细节 ， 但 是 表 25-5 列 举 了 每 个 绑 定 的 基本 作用 。 


表 25-5 _MSMQ 相 关 的 WCF 绑 定 


绑 定 类 绑 定 元 素 作 用 
MsmqIntegrationBinding <msmqIntegrationBinding> 这 个 绑 定 可 以 用 来 让 WCF 应 用 程序 向 /从 既 有 的 使 


用 COM , 原生 C++ 或 定义 在 System.Messaging 命 名 空 

间 中 的 类 型 的 MSMQ 应 用 程序 发 送 和 接收 消息 
NetMsmqBinding <netMsmqBinding> 这 个 绑 定 适用 于 跨 机 器 通信 的 .NET 应 用 程序 。 在 

MSMQ 相 关 的 绑 定 中 ， 可 以 使 用 该 绑 定 
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25.6.3 ”WCF 地 址 


创建 契约 和 绑 定 之 后 ， 最 后 一 个 难题 就 是 为 WCF 服 务 指定 一 个 地 址 。 很 明显 这 很 重要 ， 因 为 远程 
调用 者 如 果 不 能 定位 到 远程 类 型 的 话 ， 当 然 也 就 不 能 和 它们 进行 通信 。 和 WCF 的 很 多 方面 一 样 ， 地 址 
可 以 硬 编码 在 程序 集中 (通过 System.Uri 类 型 ) 或 分 离 到 *.config 文 件 。 

对 于 任何 一 种 情况 ，WCF 地 址 确切 的 格式 会 根据 我 们 选择 的 绑 定 类 型 有 所 不 同 (基于 HTTP、 命 
名 管道 、TCP 或 MSMQ )。 从 宏观 上 说 ，WCF 地 址 可 以 指定 如 下 一 些 信 息 。 

口 构架 : 传输 协议 ( HTTP 等 )。 
口 机 器 名 : 机 器 的 完全 限定 域名 。 
口 端口 : 在 很 多 情况 下 是 可 选 的 。 例 如 ，HTTP 绑 定 默认 的 端口 是 80。 
口 路 径 : WCF 服 务 的 路 径 。 

这 个 信息 可 以 由 如 下 泛 化 的 模板 来 表示 端口 值 是 可 选 的 ， 因 为 很 多 绑 定 不 会 使 用 ): 

构架 ://《 机 器 名 >[: 痛 口 ]/ 路 径 

如 果 使 用 基于 HTTP 的 绑 定 ( basicHttpBinding 、wsHttpBinding 、wsDualHttpBinding 或 
wsFederationHttpBinding )， 地 址 就 可 以 是 下 面 这 样 (回忆 一 下 ， 如 果 没 有 指定 端口 号 ， 基 于 HTTP 协 
议 的 端口 默认 是 80 ): 

http://localhost:8080/MyWCFService 

如 果 你 使 用 基于 TCP 的 绑 定 ( 如 NetTcpBinding 或 NetPeerTcpBinding )，URI 就 应 该 是 如 下 的 格式 : 

net.tcp://localhost:8080/MyWCFService 

MSMQ 相 关 绑 定 ( NetMsmqBinding 和 MsmqIntegrationBinding ) 对 于 URI 格 式 有 一 些 特殊 ， 因 为 
MSMQ 可 以 使 用 公共 的 或 私有 ( 只 在 本 机 可 用 ) 的 队列 ， 并 且 端 口号 对 于 MSMQ 相 关 的 URI 来 说 没 意 
义 。 考 虑 如 下 URI， 它 描述 了 一 个 叫 MyPrivateQ 的 私有 队列 : 

net.msmq://localhost/private$/MyPrivateQ 

最 后 ， 用 于 命名 管道 的 绑 定 NetNamedpPipeBinding 地 址 格式 可 以 为 如 下 (回忆 一 下 ， 命 名 管道 允许 
同一 个 物理 机 器 上 的 应 用 程序 跨 进程 通信 ): 

net.pipe://localhost/MyWCFService 

虽然 一 个 WCF 服 务 可 能 只 会 公开 一 个 地 址 ( 基于 一 个 绑 定 ), 但 是 还 可 以 配置 为 一 个 地 址 的 集合 
(使 用 不 同 的 绑 定 )。 可 以 通过 在 *.config 文 件 中 定义 多 个 cendpoint> 元 素来 实现 。 在 这 里 ,我 们 可 以 为 
相同 的 服务 指定 许多 ABC。 如 果 和 希望 调用 者 在 和 服务 通信 的 时 候选 择 喜 欢 的 协议 ,那么 这 个 方式 就 很 
有 用 。 


25.7 构建 WCF 服务 


现在 我 们 已 经 更 好 地 理解 了 有 关 构 建 WCF 应 用 程序 的 模块 。 让 我 们 创建 第 一 个 示例 应 用 程序 来 学 
习 如 何 能 在 代码 中 表示 ABC。 第 一 个 示例 不 会 使 用 Visual Studio WCF 项 目 模板 ， 这 样 能 更 关注 创建 
WCF 服 务 中 的 一 些 细节 步骤 。 
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首先 ， 新 建 一 个 叫 MagicEightBallServiceLib 的 C# 类 库 项 目 。 完 成 后 ， 把 初始 文件 从 Classl.cs 重 命 
名 为 MagicEightBallService.cs， 然 后 添加 对 System.ServiceModel.dl! 程 序 集 的 引用 。 在 初始 代码 文件 中 ， 
指定 我 们 要 用 的 System.ServiceModel 命 名 空间 。 至 此 , 我 们 的 C# 代 码 应 该 差不多 如 下 所 示 ( 注意 这 里 
的 类 是 公共 的 ): 


// 主要 的 WCF 命 名 空间 
using System.ServiceModel; 


namespace MagicEightBallServicelLib 


public class MagicEightBallService 
{ 
} 

} 


我 们 的 类 类 型 会 实现 由 强 类 型 CLR 接 口 IEightBal1 表 示 的 WCF 服 务 契 约 。 你 可 能 知道 , 魔法 8 号 球 
是 一 个 玩具 ， 能 让 我 们 看 到 你 可 能 问 的 问题 的 一 些 固定 回答 。 我 们 的 接口 会 定义 一 个 方法 允许 调用 者 
对 魔法 8 号 球 发 起 一 个 问题 来 获得 随机 答案 。 

WCF 服 务 接口 标记 了 [ServiceContract] 特 性 ， 而 每 一 个 接口 成 员 都 标记 了 [0perationContract] 
特性 ( 稍 后 会 讲 这 两 个 特性 的 更 多 细节 )。 这 里 是 IEightBall 接 口 的 定义 : 


[ServiceContract] 25 


public interface IEightBal1 


// 问 一 个 问题 ， 获 得 答案 
[OperationContract] 
string ObtainAnswerToQuestion(string userQuestion); 


说 明 还 可 以 定义 服务 契约 接口 来 包含 没有 使 用 [0perationContract] 特 性 的 方法 。 然 而 ， 这 样 的 成 
员 不 会 被 WCF 运 行 库 公开 。 


从 接口 类 型 的 学 习 ( 见 第 8 章 ) 中 你 可 能 知道 了 ， 接 口 在 被 类 或 结构 实现 ( 填充 其 功能 ) 之 前 没 
什么 用 。 和 真实 的 魔法 8 号 球 一 样 ， 服 务 类 型 ( MagicEightBallService ) 的 实现 会 从 字符 串 数组 中 随 
机 返回 一 个 答案 。 同 样 ， 我们 的 默认 构造 函数 会 显示 一 个 在 宿主 控制 台 窗 口中 显示 的 消息 (为 了 诊断 
目的 ): 

-i class MagicEightBallService : IEightBall 


// 只 是 为 了 在 宿主 上 显示 
public MagicEightBallService() 


Console.WriteLine("The 8-Ball awaits your question..."); 


public string ObtainAnswerToQuestion(string userQuestion) 
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string[] answers = { "Future Uncertain", "Yes", "No", 
"Hazy", "Ask again later", "Definitely" }; 


// 返回 随机 的 响应 
Random r = new Random(); 
return answers[r.Next(answers.Length)]; 


} 
} 


至 此 ， 我 们 的 WCF 服 务 库 就 完成 了 。 在 为 服务 构建 宿主 之 前 ， 先 来 研究 [ServiceContract] 和 
[OperationContract] 特 性 的 其 他 细节 。 


25.7.1 [ServiceContract] 特 性 


为 了 使 接口 成 为 WCF 所 提供 的 服务 ， 我 们 必须 用 [ServiceContract] 特 性 来 修饰 它 。 和 许多 其 他 
的 .NET 特 性 一 样 , ServiceContractAttribute 类 型 支持 许多 用 来 限定 其 含义 的 属性 ,我们 可 以 设置 Name 
和 Namespace 这 两 个 属性 ， 用 它们 来 控制 服务 类 型 的 名 称 及 其 XML 命名 空间 。 当 使 用 特定 于 HTTP 的 绑 
定时 ， 这 些 值 用 来 定义 相关 WSDL 文 档 的 cportType> 元 素 。 

由 于 服务 类 型 的 默认 名 称 就 是 它 在 C# 中 的 类 名 ， 所 以 我 们 在 这 里 就 不 再 浪费 时 间 去 给 Name 赋 值 
了 。 然 而 ， 内 部 的 XML 命名 空间 的 默认 名 称 一 般 都 是 http:Wtempuri.org ( 对 于 WCF 服 务 ， 你 应 该 修 
改 它 )。 

如 果 你 构建 的 WCF 服 务 会 发 送 和 接收 自 定义 数据 类 型 ( 现在 我 们 没有 这 么 做 )， 为 基础 XML 命名 
空间 创建 一 个 有 意义 的 值 就 很 重要 ， 因 为 这 样 就 可 以 让 我 们 的 自 定义 类 型 是 唯一 的 。 如 果 你 有 构建 
XML Web 服 务 经 验 的 话 ， 就 应 该 知道 ，XML 命 名 空间 提供 了 一 种 方式 以 唯一 的 容器 包装 我 们 的 自 定 
义 类 型 ， 从 而 确保 我 们 的 类 型 不 会 和 其 他 赋值 的 类 型 发 生 冲 突 。 

因此 , 我 们 可 以 使 用 更 合适 的 定义 来 更 新 我 们 的 接口 定义 , 这 和 在 .NET Web 服 务 项 目 中 定义 XML 
命名 空间 的 过 程 很 相似 ， 一 般 设 置 为 服务 起 始点 的 URL， 例 如 : 


[ServiceContract(Namespace = "http://MyCompany.com")] 

ee interface IEightBall 

, dis 

除了 Namespace 和 Name 之 外 ， 我 们 可 以 用 表 25-6 中 的 另外 一 些 属性 来 配置 [ServiceContract] 特 性 。 

根据 你 所 选择 的 绑 定 ， 其 中 有 一 些 设置 可 能 会 被 忽略 。 
表 25-6 [ServiceContract] 特 性 的 一 些 属性 
属 性 含义 
CallbackContract 对 于 双向 信息 交换 ， 如 果 服 务 契 约 需要 具有 回调 功能 ， 则 要 设置 此 属性 
ConfigurationName 该 名 称 用 来 在 应 用 程序 配置 文件 中 定位 服务 元 素 。 默 认为 实现 服务 的 类 的 名 称 
ProtectionLevel 允许 你 为 公开 该 契约 的 终结 点 指定 契约 绑 定 所 需 的 安全 级 别 ， 是 要 加 密 ， 需 数字 签名 ,或 
既 要 加 密 又 需 数字 签名 

SessionMode 允许 你 设 定 服务 契约 是 支持 会 话 ， 不 支持 会 话 ， 还 是 必须 使 用 会 话 
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25.7.2 [0perationContract] 特 性 


在 WCF 框 架 中 使 用 的 方法 必须 用 [0perationContract] 特 性 来 修饰 。 我们 也 可 以 用 各 种 属性 来 配置 
该 特性 。 使 用 表 25-7 所 示 的 属性 , 你 可 以 将 一 个 给 定 的 方法 声明 为 在 本 质 上 是 单 向 的 , 支持 异步 调用 ， 
需要 加 密 的 消息 数据 等 ( 同样， 根据 所 选择 的 绑 定 ， 许 多 值 可 能 会 被 忽略 )。 


表 25-7 [0perationContract] 特 性 的 属性 


属 性 省， 文 
AsyncPattern 指明 操作 是 否 使 用 Begin/End 方 法 对 来 异步 执行 。 这 能 让 服务 把 处 理 转 到 另 一 个 服务 器 端 线 
程 上 ， 这 和 客户 端 异步 调用 方法 没有 关系 
IsInitiating 指定 该 操作 能 否 作为 一 个 会 话 中 的 初始 操作 
IsOneWay 指明 该 操作 是 否 只 是 由 单个 输入 消息 组 成 ( 而 并 没有 相关 的 输出 ) 


IsTerminating 指定 WCF 运 行 库 在 操作 完成 后 是 否 应 该 尝试 去 结束 当前 会 话 


对 于 第 一 个 例子 ， 我 们 并 不 需要 用 额外 的 特征 来 配置 0btainAnswerToQuestion() 方 法 。 因 此 ， 可 
以 使 用 当前 定义 的 [operationContract] 特 性 。 


25.7.3 ”作为 操作 契约 的 服务 类 型 


构建 WCF 服 务 类 型 并 不 需要 使 用 接口 。 实 际 上 ， 直 接 将 [ServiceContract] 特 性 和 [0peration 
Contract] 特 性 应 用 到 服务 类 型 上 也 是 可 行 的 ， 如 下 所 示 。 


// 这 段 代码 只 是 为 了 演示 ， 并 不 会 用 于 当前 示例 
[ServiceContract(Namespace = "http://MyCompany.com")] 
public class ServiceTypeAsContract 





[OperationContract] 
void SomeMethod() { } 


[OperationContract] 
void AnotherMethod() { } 
} 


虽然 这 种 方法 是 可 行 的 ,但 是 显 式 定 义 一 个 接口 类 型 去 表示 服务 契约 有 很 多 好 处 。 最 明显 的 一 个 
好 处 是 给 定 的 接口 可 被 应 用 到 多 个 服务 类 型 ( 这 些 服务 类 型 是 用 多 种 语言 和 架构 来 编写 的 )， 以 此 来 
获取 高 度 的 多 态 性 。 另 外 一 个 好 处 是 一 个 服务 契约 接口 可 以 用 作 新 契约 的 基础 ( 通过 继承 接口 )， 而 
并 不 需要 浪费 时 间 去 实现 它 。 

到 目前 为 止 , 第 一 个 WCF 服 务 库 就 完成 了 。 编 译 项 目 以 确保 没有 录入 错误 。 


源 代码 ”MagicEightBallServiceLib 项 目的 源 代码 位 于 Chapter 25 子 目录 MagicEightBallServiceHTTP 下 。 
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25.8 承载 WCF 服务 


现在 ,我 们 已 经 为 定义 我 们 的 服务 类 型 的 宿主 做 好 了 准备 。 虽 然 产 品级 的 服务 最 好 是 由 Windows 
服务 或 IS 虚拟 目录 承载 ,但 是 我 们 将 创建 一 个 名 为 MagicEightBallServiceHost 的 基于 控制 台 的 
宿主 。 

创建 完 该 项 目 以 后 , 添加 对 System.ServiceMode1.d11 和 MagicEightBallSserviceLib.d11 的 引用 , 并 
且 使 用 System.ServiceModel 和 MagicEightBallServiceLib 命 名 空间 来 修改 初始 代码 文件 ， 如 下 所 示 : 


using Systemj 


using System.ServiceModel; 
using MagicEightBallServicelib; 


namespace MagicEightBallServiceHost 
class Program 
static void Main(string[] args) 


Console.WriteLine("***** Console Based WCF Host *****"); 
Console.ReadLine(); 
} 
} 
} 


当 构 建 WCF 服 务 类 型 的 宿主 时 , 第 一 件 必须 做 的 事情 是 , 你 要 决定 是 完全 在 代码 中 定义 必要 的 承 
载 逻辑 , 还 是 将 一 些 低级 的 细节 转移 到 应 用 程序 配置 文件 中 去 。 回 想 一 下 ，*.config 文 件 的 好 处 是 宿主 
能 够 改变 底层 的 运行 方式 而 并 不 需要 重新 编译 和 部 署 可 执行 文件 。 然 而 ,请 记 住 ， 这 确实 只 是 选择 性 
的 ， 因 为 你 能 够 使 用 System.ServiceModel.dll 程 序 集中 的 类 型 来 对 承载 逻辑 进行 编码 实现 。 

这 个 基于 控制 台 的 宿主 确实 会 使 用 应 用 程序 配置 文件 ， 因 此 使 用 Project 一 Add New Item 菜 单项 ， 
然后 选择 Application Configuration File， 问 当前 项 目 插入 一 个 新 的 应 用 程序 配置 文件 (如果 项 目 目前 
还 没有 配置 文件 的 话 )。 


25.8.1 ”在 App.config 文 件 中 创建 ABC 


在 构建 WCF 服 务 类 型 的 宿主 时 ,你 将 会 遵循 一 些 常 见 的 步 又 (一 部 分 是 通过 配置 ,一 部 分 是 通过 
代码 )， 如 下 所 示 。 

口 在 宿主 的 配置 文件 中 ， 定 义 所 承载 的 WCF 服 务 的 终结 点 。 

口 通过 编程 使 用 ServiceHost 类 型 去 提供 终结 点 所 提供 的 服务 类 型 。 

口 确保 宿主 保持 运行 状态 ， 以 处 理 所 收 到 的 客户 端 请 求 。 显 然 ， 如 果 你 使 用 Windows 服 务 或 IIS 

来 承载 服务 类 型 ， 那 么 并 不 需要 这 一 步 。 

在 WCF 的 世界 中 ,术语 终结 点 只 是 表示 地 址 、 绑 定 和 契约 的 一 个 包装 。 在 XML 中 ,终结 点 使 用 
<endpoint> 元 素 和 address、binding 以 及 contract 元 素 进行 表达 。 更 新 我 们 的 *.config 文 件 来 指定 一 个 
由 宿主 公开 的 终结 点 〈 通 过 8080 端 口 可 用 )， 如 下 所 示 : 
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<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name="MagicEightBallServicelib.MagicEightBallService"> 
<endpoint address ="http://localhost:8080/MagicEightBallService" 
binding="basicHttpBinding" 
contract="MagicEightBallServicelib.IEightBall"/> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


注意 <system.serviceModel> 元 素 是 所 有 宿主 WCEF 设 置 的 根 。 每 一 个 由 宿主 公开 的 服务 都 由 
<seivice> 元 素 表示 ， 并 包装 在 <services> 根 元 素 中 。 在 这 里 ， 一 个 <sercice> 元 素 使 用 ( 可 选 的 ) name 
特性 来 指定 服务 类 型 的 友好 名 称 。 

藤 套 的 <endpoint> 元 素 处 理 定义 地 址 、 绑 定 模 型 ( 在 本 例 中 是 basicHttpBinding ) 以 及 定义 WCF 
服务 契约 接口 的 完全 限定 名 ( IEightBall ) 的 任务 。 因 为 我 们 使 用 的 是 基于 HTTP 的 绑 定 ， 所 以 可 以 使 
用 https:// 架 构 随 便 指定 一 个 端口 ID。 


25.8.2 ”针对 ServiceHost 类 型 进行 编程 


有 了 现在 这 样 的 配置 文件 ， 完 成 宿主 的 编程 逻辑 就 很 简单 了 。 在 启动 可 执行 程序 时 ， 我 们 会 创建 25 
ServiceHost 类 的 实例 并 且 通 知 它 宿主 的 是 哪个 WCF 服 务 , 在 运行 时 ,这 个 对 象 会 自动 读 取 宿 主 *.config 
文件 中 <system.serviceModel1> 元 素 中 的 数据 来 检测 正确 的 地 址 、 绑 定 类 型 和 契约 。 然 后 创建 必要 的 
管道 : 

static void Main(string[] args) 

Console.WriteLine("***** Console Based WCF Host *****"); 


using (ServiceHost serviceHost = new ServiceHost(typeof(MagicEightBallService))) 


// 打开 宿主 并 且 开启 对 传 入 消息 的 监听 


serviceHost.0pen(); 


// 使 服务 保持 运行 状态 ， 直 到 Enter 键 被 按 下 

Console.WritelLine("The service is ready."); 
Console.WriteLine("Press the Enter key to terminate service."); 
Console.ReadLine(); 


} 


—- 


运行 这 个 应 用 程序 ， 就 会 发 现 ， 宿 主 在 内 存 中 随时 准备 接收 从 远程 客户 端 发 来 的 请 求 。 


说 明 记 住 必须 以 管理 员 权 限 启动 Visual Studio 才 能 运行 多 种 WCF 项 目 类 型 ! 


25.8.3 ”指定 库 地 址 
现在 ,我 们 使 用 只 需要 服务 类 型 信息 的 构造 函数 来 创建 serviceHost。 然 而 ,还 可 以 传人 System.Uri 
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类 型 的 数组 作为 构造 函数 参数 来 表示 可 以 访问 服务 的 地 址 集合 。 现 在 ,地 址 是 从 *.config 文 件 中 获取 的 ， 
然而 如 果 按 如 下 所 示 更 新 using 区 域 的 话 : 


using (ServiceHost serviceHost = new 
ServiceHost(typeof(MagicEightBallService), 
new Uri[]{new Uri("http://localhost:8080/MagicEightBallService")})) 


0 
我 们 就 可 以 这 样 定义 终结 点 : 


<endpoint address = 
binding="basicHttpBinding" 
contract="MagicEightBallServicelib.IEightBall"/> 


当然 ， 在 宿主 代码 库 中 有 太 多 硬 编码 会 减少 灵活 性 。 因 此 对 于 当前 宿主 的 示例 , 假设 你 只 是 像 前 
面 那 样 使 用 类 型 信息 来 创建 服务 宿主 : 


using (ServiceHost serviceHost = new ServiceHost(typeof(MagicEightBallService))) 


编写 *.config 文 件 时 , 根据 在 代码 库 中 硬 编码 的 量 ( 就 像 刚 才 例 子 中 看 到 的 可 选 的 Uri 数 组 ), 我们 
有 许多 方式 来 构建 XML 的 描述 。 为 了 演示 另外 一 种 编写 *.config 文 件 的 方式 ， 考 虑 如 下 的 改造 工作 : 


<?Xxml version= "1.0" encoding= "utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name= "MagicEightBallServicelib.MagicEightBallService"> 


《<1-- 从 <baseAddresses> 获 取 的 地 址 --> 
<endpoint address = "" 
binding= "basicHttpBinding" 
contract= "MagicEightBallServicelib.IEightBall"/> 


《1-- 在 专门 的 地 方 列 出 所 有 的 根 地 址 --> 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


在 这 里 ，<endpoint> 元 素 的 address 特 性 还 是 空 的 ， 无论 我 们 在 创建 ServiceHost 时 ， 在 代码 中 是 否 指 
定 了 Uri 对 象 的 数组 ， 应 用 程序 还 是 可 以 像 以 前 那样 运行 ， 因 为 值 可 以 从 baseAddresses 中 得 到 。 把 根 地 
址 保存 在 <host> 的 <baseAddresses> 区 域 中 的 一 个 优势 是 ，*.config 文 件 另 外 的 一 部 分 也 需要 知道 服务 终结 
点 的 地 址 。 因 此 ， 我 们 可 以 这 样 把 这 个 值 进行 隔离 ， 而 无 须 在 一 个 *.config 文 件 中 复制 并 粘贴 地 址 值 。 


说 明 在 稍 后 的 示例 中 ， 我 会 介绍 允许 我 们 以 更 有 趣 的 方式 编写 配置 文件 的 图 形 配置 工具 。 
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不 管 怎么 样 ， 在 构建 客户 端 应 用 程序 和 服务 进行 通信 之 前 ， 让 我 们 深入 serviceHost 类 类 型 、 
<service.serviceModel> 元 素 和 元 数据 交换 (MEX ) 服务 的 作用 。 


25.8.4 ServiceHost 类 型 的 功能 


ServiceHost 类 型 用 于 从 承载 可 执行 文件 中 配置 和 提供 一 种 WCF 服 务 。 请 注意 , 只 有 当 构 建 一 个 自 
定义 的 *.exe 来 承载 服务 时 , 你 才 会 直接 使 用 该 类 型 。 如 果 你 正在 使 用 IIS 来 提供 某 个 服务 , 它们 会 自动 
为 你 创建 ServiceHost 对 象 。 

如 你 所 看 到 的 ，ServiceHost 类 型 需要 完整 的 服务 描述 ， 该 描述 从 宿主 的 *.config 文 件 的 配置 设置 
动态 获取 。 虽 然 对 描述 的 获取 是 在 对 象 创建 期 间 自 动 发 生 的 ， 但 是 你 可 以 使 用 许多 成 员 去 手动 配置 
ServiceHost 对 象 的 状态 。 除 了 以 同步 方式 和 你 的 服务 进行 通信 的 0pen() 和 Close() 外 ,， 表 25-8 还 列 出 了 
其 他 一 些 有 趣 的 成 员 。 


表 25-8 ”ServiceHost 类 型 中 的 一 部 分 成 员 


成 员 含义 
Authorization 该 属性 获取 被 承载 服务 的 授权 级 别 
AddDefaultEndpoints() 该 方法 使 用 框架 提供 的 预 置 终结 点 ， 以 编程 方法 配置 WCF 服 务 宿主 
AddserviceEndpoint() 该 方法 允许 你 通过 编程 的 方式 在 宿主 中 注册 一 个 终结 点 5 
BaseAddresses 该 属性 获取 已 经 在 当前 服务 中 注册 的 基本 地 址 列表 
BeginOpen() 和 BeginClose() 这 两 个 方法 允许 你 使 用 标准 的 异步 .NET 委 托 句法 去 异步 打开 和 关闭 一 个 
ServiceHost 对 象 
CloseTimeout 该 属性 允许 你 设置 和 获取 服务 关闭 的 允许 时 间 
Credentials 该 属性 获取 当前 服务 所 使 用 的 安全 凭证 
EndOpen() 和 EndClose() 这 两 个 方法 与 Begin0pen() 和 BeginClose() 是 相对 应 的 
OpenTimeout 该 属性 允许 你 设置 和 获取 服务 启动 的 允许 时 间 
State 该 属性 获取 一 个 显示 通信 对 象 当前 状态 的 Communicationstate 枚 举 值 


(opened、closed、created 等 ) 


为 了 演示 ServiceHost 的 其 他 方面 ， 使 用 新 的 静态 方法 更 新 我 们 的 Program 类 ， 来 输出 当前 宿主 的 
各 个 方面 : 
static void DisplayHostInfo(ServiceHost host) 


Console.WritelLine(); 
Console.WriteLine("***** Host Info *****")， 


foreach (System.ServiceModel .Description.ServiceEndpoint se 
in host.Description.Endpoints) 


Console.WriteLine("Address: {0}", se.Address); 
Console.WriteLine("Binding: {0}", se.Binding.Name); 
Console.WriteLine("Contract: {0}", se.Contract.Name); 
Console.Writeline(); 


Console .WriteLine(" 六 六 六 六 六 六 冰冰 六 闵 率 闵 冰冰 闵 冰 冰冰 六 水 闵 阔 " ) 3 
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假设 我 们 打开 宿主 后 在 Main() 方 法 中 调用 这 个 新 的 方法 : 
using (ServiceHost serviceHost = new ServiceHost(typeof(MagicEightBallService))) 
// 打开 宿主 并 且 启 动 对 传 入 消息 的 监听 


serviceHost .Open(); 
DisplayHostInfo(serviceHost); 


} 
将 会 看 到 如 下 所 示 的 统计 信息 : 





六 六 站 水 * Console Based WCF Host 六 冰冰 炒米 


六 六 六 玉米 Hos 七 nfQ 六 六 六 六 六 

Address: http://localhost:8080/MagicEightBallService 
Binding: BasicHttpBinding 

Contract: IEightBall 

米 闵 玉米 玉 闵 阔 玉 六 来 六 六 六 来 六 冰冰 玉米 冰冰 闵 

The service is ready. 

Press the Enter key to terminate service. 





25.8.5 “system.serviceModel> 元 素 的 细节 





和 任何 XML 元 素 一 样 ，<system.serviceMode1> 元 素 可 以 包含 许多 子 元 素 ， 而 每 一 种 子 元 素 又 可 以 


用 各 种 不 同 的 特性 来 完整 配置 。.NET Framework 4.5 SDK 文 档 描述 了 每 一 种 特性 的 完整 细节 ， 我 们 在 
这 里 列 出 了 <system.ServiceModel> 元 素 部 分 有 用 的 子 元 素 。 


<system.serviceModel> 
<behaviors> 
</behaviors> 
<client> 
</client> 
<commonBehaviors> 
</commonBehaviors> 
<diagnostics> 
</diagnostics> 
<comContracts> 
</comContracts> 
<services> 
</services> 
<bindings> 
</bindings> 

</system.serviceModel> 


到 本 章 后 面 ， 会 有 更 有 趣 的 配置 文件 ， 表 25-9 列 出 了 每 个 子 元 素 的 主要 作用 。 
表 25-9 “service.serviceModel> 的 部 分 子 元 素 





子 元 素 作 用 
behaviors WCF 提 供 了 各 种 终结 点 和 服务 行为 。 简 而 言 之 ,行为 允许 我 们 进一步 限定 宿主 、 服 务 或 客 
户 端的 功能 
bindings 这 个 元 素 允 许 我 们 微调 每 个 WCF 提 供 的 绑 定 ( basicHttpBinding 和 netMsmqBinding 等 ) 和 指 


定 宿主 使 用 的 客户 端 绑 定 
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( 续 ) 
子 元 案 作 用 

client 这 个 元 素 包含 客户 端 用 来 连接 到 服务 的 终结 点 列表 。 显 然 ， 这 对 于 宿主 的 *.config 文 件 没 什 
么 用 

comContracts 这 个 元 素 定义 了 人 允许 WCF 和 COM 互 操作 的 COM 契 约 

commonBehaviors 这 个 元 素 只 能 在 machine.config 文 件 中 进行 设置 。 它 可 以 用 于 定义 某 个 机 器 所 有 WCF 服 务 的 
行为 

diagnostics 这 个 元 素 包 含 WCF 诊 断 特性 的 设置 。 用 户 可 以 启用 或 禁用 跟踪 、 性 能 计数 器 和 WMI 提 供 程 
序 ， 并 且 可 以 增加 自 定义 消息 过 滤器 

services 这 个 元 素 包含 了 从 宿主 公开 的 WCF 服 务 的 集合 


25.8.6 ”启用 元 数据 交换 


回忆 一 下 , WCF 客 户 端 应 用 程序 通过 中 间 代 理 类 型 和 WCF 服 务 通信 。 虽然 我 们 可 以 完全 手写 编写 
代理 代码 ,但 这 样 做 很 乏味 而 且 会 导致 错误 。 最 好 能 有 一 个 工具 可 以 生成 必要 的 代码 (包括 客户 端的 
*.config 文 件 )。 幸 好 .NET Framework 4.5 SDK 提 供 了 一 个 命令 行 工 具 ( svcutil.exe ) 来 实现 。 同样 ,Visual 
Studio 通 过 Project 一 Add Service Reference 荣 单项 提供 了 相似 的 功能 。 

然而 ， 为 了 让 这 些 工 具 生成 必要 的 代理 代码 和 #.config 文 件 ， 它 们 必须 能 发 现 WCF 服 务 接口 的 格 
式 和 任何 已 定义 的 数据 契约 (方法 名 、 参 数 类 型 等 )。 

元 数据 交换 (MEX ) 是 一 个 WCF 服 务 行为 ， 可 以 指定 它 微调 WCF 运 行 库 如 何 处 理 我 们 的 服务 。 
简 而 言 之 ， 每 一 个 cbehavior> 元 素 都 可 以 定义 某 个 服务 可 以 订阅 的 一 组 活动 。WCF 提 供 了 许多 现成 的 
行为 ， 我们 还 可 以 构建 自己 的 。 

MEX 行 为 (默认 是 关闭 的 ) 会 通过 HTTP GET 拦 截 任何 元 数据 请 求 。 如 果 你 希望 多 许 sveutil.exe 
或 Visual Studio 来 自动 创建 必要 的 客户 端 代理 *.config 文 件 ， 就 必须 启用 MEX。 

只 需要 稍稍 改动 宿主 的 *.config 文 件 , 加 上 正确 的 设置 ( 或 编写 相应 的 C# 代 码 )， 就 可 以 启用 MEX 
了 。 首先 , 必须 为 MEX 增 加 一 个 新 的 <endpoint>。 其次, 我 们 需要 定义 一 个 WCF 行 为 来 允许 HTTP GET 
访问 。 再 次 , 我 们 需要 通过 <service> 元 素 的 behaviorConfiguration 特 性 来 关联 服务 和 行为 。 最后, 我 
们 需要 增加 一 个 <host> 元 素来 定义 这 个 服务 的 根 地 址 ( MEX 会 查看 这 里 以 找到 要 描述 类 型 的 位 置 )。 


说 明 ”如果 你 把 表示 根 地 址 的 System.Uri 对 象 作为 ServiceHost 构 造 函 数 参数 传 入 的 话 , 就 可 以 忽略 最 
后 一 步 。 














考虑 如 下 更 新 后 的 宿主 *.config 文 件 ， 它 创建 了 自 定义 的 <behavior> 元 素 ( 命名 为 EightBall- 
ServiceMEXBehavior )， 并 通过 <service> 定 义 中 的 behaviorConfiguration 特 性 关联 到 我 们 的 服务 : 


<?xml version = "1.0" encoding = "utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name = "MagicEightBallServicelib.MagicEightBallService" 
behaviorConfiguration = "EightBallServiceMEXBehavior"> 
<endpoint address = "" 
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binding = "basicHttpBinding" 
contract = "MagicEightBallServicelib.IEightBall"/> 


<1-- 启用 MEX 终 结 点 --> 

<endpoint address = "mex" 
binding = "mexHttpBinding" 
contract = "IMetadataExchange” /> 


<1-- 需要 增加 这 个 ， 让 MEX 知 道 服务 的 地 址 --》 
<host> 


<baseAddresses> 


<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
</baseAddresses> 


</host> 
</service> 
</services> 


《<1-- MEX 的 行为 定义 --> 
<behaviors> 


<serviceBehaviors> 


<behavior name = "EightBallServiceMEXBehavior” > 


<serviceMetadata httpGetEnabled = "true" /> 
</behavior> 


</serviceBehaviors> 
</behaviors> 


</system.serviceModel> 
</configuration> 


现在 我 们 就 可 以 重启 服务 宿主 应 用 程序 并 且 使 用 喜欢 的 Web 浏 览 器 来 看 元 数据 描述 。 在 宿主 运行 
的 时 候 输 入 如 下 URL 作 为 地 址 : 


http://localhost:8080/MagicEightBallService 


在 WCF 服 务 的 主页 上 ( 如 图 25-6 所 示 )， 我 们 得 到 了 有 关 如 何以 编程 方式 和 这 个 服务 进行 交互 的 


基本 细节 ， 并 且 可 以 通过 单 击 页 面 顶 部 的 链接 来 查看 WSDL 契 约 。 回 忆 一 下 ，WSDL ( Web 服 务 描述 
语言 ) 是 描述 某 个 终结 点 Web 服 务 的 语法 。 
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图 25-6 ”准备 通过 MEX 查 看 元 数据 
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现在 宿主 公开 两 个 不 同 的 终结 点 ( 一 个 用 于 服务 ， 一 个 用 于 MEX )， 宿 主 的 控制 台 输出 类 似 下 面 
所 示 : 





沙沙 沙沙 炒 Console Based WCF Host ***** 


六 六 六 冰冰 Hos 七 nO 冰冰 炒米 冰 

Address: http://localhost:8080/MagicEightBallService 
Binding: BasicHttpBinding 

Contract: IEightBall 


Address: http://localhost:8080/MagicEightBallService/mex 
Binding: MetadataExchangeHttpBinding 


Contract: IMetadataExchange 
六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 冰冰 冰冰 六 六 


The service is ready. 





源 代码 ”MagicEightBallServiceHost 项 目的 源 代码 位 于 Chapter 25 的 MagicEightBallServiceHTTP 子 目录 下 。 


25.9 构建 WCF 客户 端 应 用 程序 


现在 , 我 们 的 宿主 已 经 建立 完毕 。 最 后 的 任务 是 构建 与 该 WCF 服 务 类 型 进行 通信 的 程序 。 虽然 我 
们 可 以 绕 弯 路 去 手动 构建 必要 的 基础 结构 ( 一 种 可 行 但 很 费劲 的 做 法 ), 但 是 .NET Framework 4.5 SDK 
已 经 为 我 们 提供 了 一 些 构建 客户 端 代理 的 方法 。 首 先 创建 一 个 新 的 控制 台 应 用 程序 项 目 
MagicEightBall ServiceClient。 


25.9.1 使 用 svcutil.exe 生 成 代理 代码 


第 一 种 创建 客户 端 代理 的 方式 是 使 用 svcutil.exe 命 令 行 工具 。 可 以 使 用 该 工具 生成 一 个 充当 代理 代 
码 的 C# 滞 言 文件 以 及 一 个 客户 端 配置 文件 。 为 了 生成 这 两 个 文件 ,只 需要 指定 服务 的 终结 点 作为 第 一 
个 参数 。/out: 标 记 用 来 定义 包含 代理 的 *.cs 文 件 的 名 称 ， 而 /config: 选 项 则 指明 所 生成 的 客户 端 
*.config 文 件 的 名 称 。 

假设 服务 正在 运行 , 那么 传人 svceutil.exe 的 下 列 命令 将 会 在 工作 目录 中 生成 两 个 新 文件 ( 当然, 在 
Developer Command Prompt 中 输入 时 ， 这 个 命令 只 有 一 行 ): 


svcutil http://localhost:8080/MagicEightBallService 
/out:myProxy.cs /config:app.config 


如 果 你 打开 myProxy.cs 文 件 ， 会 看 见 IEightBall 接 口 的 客户 端 表示 ， 以 及 一 个 名 为 EightBallClient 
的 新 类 ， 这 个 类 就 是 代理 本 身 。EightBallClient 类 派生 自 System.ServiceModel.ClientBasex<T> 泛 型 类 
(在 这 里 ，T 是 已 注册 的 服务 接口 )。 除 了 一 些 生 成 的 构造 函数 之 外 ， 该 代理 的 每 个 方法 ( 基于 原始 的 
接口 方法 ) 还 实现 了 所 有 用 [0perationContract] 修 饰 的 方法 ， 这 些 方法 将 各 自 实现 委托 给 父 类 的 
Channels 属 性 ， 从 而 调用 正确 的 外 部 方法 。 下 面 是 这 个 代理 类 型 的 部 分 代码 : 


828 第 25 章 WCF 


[System.Diagnostics.DebuggerStepThroughAttribute()] 

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", 
"4.5.0.0")|] 

public partial class EightBallClient : 
System.ServiceModel.ClientBase<IEightBall>, IEightBall 


public string ObtainAnswerToQuestion(string userQuestion) 
return base.Channel.ObtainAnswerToQuestion(userQuestion); 


} 

创建 代理 类 型 的 实例 时 , 它 的 基 类 将 使 用 客户 端 应 用 程序 配置 文件 中 的 设置 来 建立 与 终结 点 的 连 
接 。 与 服务 端 配置 文件 相似 ， 生 成 的 App.config 文 件 包含 一 个 cendpoint> 元 素 和 一 些 关于 basicHttp- 
Binding ( 用 来 与 服务 进行 通信 ) 的 细节 。 

此 外 ， 你 会 看 到 如 下 <client> 元 素 ， 它 再 次 从 客户 端 角度 创建 了 ABC: 


<client> 
<endpoint 
address = "http://localhost:8080/MagicEightBallService" 
binding = "basicHttpBinding" bindingConfiguration="BasicHttpBinding IEightBall" 
contract = "IEightBall" name="BasicHttpBinding IEightBall" /> 
</client> 


至 此 ， 你 可 以 把 这 两 个 文件 放 到 客户 端 项 目 中 (并 且 引 用 System.ServiceModel.dll 程 序 集 )， 然 后 
使 用 这 个 代理 类 型 和 远程 WCF 服 务 进行 通信 。 但 这 里 我 们 会 采用 不 同 的 方式 ， 让 我 们 来 看 看 Visual 
Studio 如 何 帮 助 我 们 自动 创建 客户 端 代理 文件 。 


25.9.2 ”使 用 Visual Studio 生 成 代理 代码 


与 任何 优秀 的 命令 行 工 具 相似 , svcutil.exe 提 供 了 大 量 可 用 于 控制 如 何 生成 客户 端 代理 的 选项 。 然 
而 ， 如 果 不 需 要 使 用 这 些 高 级 选项 ， 你 可 以 使 用 Visual Studio 集 成 开发 环境 来 生成 相同 的 文件 。 只 需 
要 选择 Project 菜 单 的 Add Service Reference 选 项 就 可 以 了 。 

一 旦 激活 了 该 菜单 选项 ， 提 示 输 入 服务 的 URI。 单 击 Go 按钮 可 以 查看 服务 描述 ， 如 图 25-7 所 示 。 

除了 向 当前 项 目 创建 和 插入 代理 文件 以 外 , 这 个 工具 还 会 为 我 们 自动 引用 WCF 程 序 集 。 作 为 命名 
惯例 ,代理 类 在 命名 空间 ServiceReferencel 中 定义 ， 它 被 嵌 套 在 了 客户 端 命名 空间 中 ( 为 了 避免 可 能 
的 名 字 冲 突 )。 下 面 是 完整 的 客户 端 代码 : 

// 代理 所 在 的 位 置 


using MagicEightBal1ServiceClient.ServiceReference1; 
namespace MagicEightBallServiceClient 
class Program 
static void Main(string[] args) 
Console.WriteLine("***** Ask the Magic 8 Ball] *****\n"); 
using (EightBallClient ball = new EightBallClient()) 


Console.Write("Your question: "); 
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string question = Console.ReadLine(); 

string answer = 
ball.ObtainAnswerToQuestion(question); 

Console.WritelLine("8-Ball says: {0}", answer); 


Console.ReadLine(); 


To see a list of availabje services on a Specific server, enter a service URL and click Go. To browse for available 
services, click Discover. 


Address: 


http://iocalhost:8080/MagicEightBallService bd [ge | 
Services: Qperations: 
a ©:@ MagicEightBallService ® ObtainAnswerToQuestion 
"1EightBal | 




















[1 service(s) found at address ‘http://localhost8080/MagicEightBallService. 


Namespace: 
ServiceReferencel 





图 25-7 使 用 Visual Studio 生 成 代理 代码 
现在 ,假设 WCF 正 在 运行 ， 就 可 以 执行 客户 端 。 以 下 是 对 一 个 问题 可 能 的 响应 : 





***** Ask 七 he Magic 8 Bal] ***** 


Your question: Will I ever finish Skyrim? 
8-Ball says: No 


Press any key to continue . .. 








源 代码 ”MagicEightBallServiceClient 项 目的 源 代码 位 于 Chapter 25 的 MagicEightBallServiceHTTP 子 目 
深 下 a 
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25.9.3 配置 基于 TCP 的 绑 定 


至 此 ， 宿 主 和 客户 端 应 用 程序 都 配置 为 使 用 最 简单 的 基于 HTTP 的 绑 定 basicHttpBinding。 回 忆 一 
下 ， 把 设置 分 离 到 配置 文件 的 好 处 是 我 们 可 以 以 声明 方式 改变 基础 通道 ， 并 且 对 同一 个 服务 公开 多 个 
绑 定 。 

为 了 演示 ， 让 我 们 做 一 些 实 验 。 在 我 们 的 C: 驱动 器 〈 或 者 你 一 直 保 存 代码 的 地 方 ) 上 新 建 一 个 
文件 夹 EightBallTCP， 在 这 个 新 文件 夹 中 创建 两 个 子 目录 Host 和 Client。 

然后 ， 使 用 Windows 资 源 管理 器 导航 到 ( 本 章 前 面 创建 的 ) 宿主 项 目的 \bin\Debug 文 件 夹 并 且 将 
MagicEightBallServiceHost.exe 、MagicEightBallServiceHost.exe.config 和 MagicEightBallServiceLib.dll 复 
制 到 C:\Eight BallTCP\Host 文 件 夹 。 使 用 简单 的 文本 编辑 器 打开 *.config 文 件 进行 编辑 ,然后 按 如 下 所 
示 修 改 既 有 的 内 容 : 


<?xml] version = "1.0”encoding = "utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name= "MagicEightBallServicelLib.MagicEightBallService"> 
<endpoint address = "" 
binding = "netTcpBinding" 
contract = "MagicEightBallServicelib.IEightBall"/> 
<host> 
<baseAddresses> 
<add baseAddress = "net.tcp://localhost:8090/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


宿主 的 *.config 文 件 基本 上 去 除了 所 有 的 MEX 设 置 ( 因为 我 们 已 经 构建 了 代理 ) 并 且 使 用 
netTcpBinding 绑 定 类 型 进行 创建 。 现 在 双击 *.exe 来 运行 应 用 程序 。 如 果 一 切 正常 的 话 , 你 应 该 能 看 到 
如 下 所 示 的 宿主 输出 : 





六 冰冰 冰冰 Console Based WCF Host ***** 


六 六 六 六 六 Host Info 闵 闵 六 六 六 

Address: net.tcp://localhost:8090/MagicEightBallService 
Binding: NetTcpBinding 

Contract: IEightBall 


六 六 六 玉米 米 冰冰 闵 玉米 六 六 六 玉米 冰 玉米 闵 冰冰 


The service is ready. 
Press the Enter key to terminate service. 





为 了 完成 这 个 测试 ， 把 MagicEightBallServiceClient.exe 和 MagicEightBallServiceClient.exe.config 文 
件 从 (本 章 前 面 创建 的 ) 客户 端 应 用 程序 的 \binIDebug 文 件 夹 复制 到 C:\EightBallTCP\Client 文 件 夹 。 按 
如 下 所 示 更 新 客户 端 配置 文件 : 
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<?xml version= "1.0" encoding= "utf-8" ?> 
<configuration> 
<system.serviceModel> 
<client> 
<endpoint address = "net.tcp://localhost:8090/MagicEightBallService" 
binding = "netTcpBinding" 
contract = "ServiceReferencel1.IEightBall" 
name = "netTcpBinding IEightBall" /> 
</client> 
</system.serviceModel> 
</configuration> 


这 个 客户 端 配置 文件 是 Visual Studio 代 理 生 成 器 生成 的 极度 简化 形式 。 注 意 ， 我 们 完全 移 除 了 既 
有 的 cbindings> 元 素 。 起初 ，*.config 文 件 包含 了 cbindings> 元 素 和 <basicHttpBinding> 子 元 素 , 它们 提 
供 了 客户 端 绑 定 设置 的 许多 细节 ( 超时 等 )。 

实际 上 ,我 们 的 示例 不 需要 这 些 细节 ， 因 为 我 们 自动 获取 基础 gasicHttpBinding 对 象 的 默认 值 。 
如 果 需 要 ， 我 们 当然 可 以 更 新 既 有 的 <bindings> 元 素来 定义 cnetTcpBing> 子 元 素 的 细节 。 但 是 如 果 
NetTcpBinding 对 象 默认 值 可 以 满足 要 求 ， 就 不 需要 这 样 做 。 

不 管 怎 么 样 , 你 现在 应 该 可 以 运行 客户 端 应 用 程序 。 如 果 宿 主 还 在 后 台 运行 的 话 , 就 可 以 使 用 TCP 
在 程序 集 之 间 转 移 数据 。 


源 代码 ”MagicEightBallTCP 项 目的 源 代码 位 于 Chapter 25 子 目录 下 。 


25.10 简化 配置 设置 


在 学 习 本 章 的 第 一 个 示例 时 ， 你 会 发 现 宿主 的 配置 逻辑 相当 烦琐 。 例 如 ， 宿主 的 *.config 文 件 ( 基 
本 HTTP 绑 定 ) 需要 为 服务 和 MEX 分 别 定义 一 个 <endpoint> 元 素 ， 为 减少 元 余 URI 定 义 一 个 
<baseAddresses> 元 素 ( 这 是 可 选 的 )， 为 定义 元 数据 交换 的 运行 时 性 质 要 配置 cbehaviors> 节 。 

显然 ， 学习 如 何 编写 宿主 的 *.config 文 件 成 为 构建 WCF 服 务 的 主要 障碍 。 更 糟 的 是 ， 很 多 WCF 服 
务 都 要 求 在 宿主 配置 文件 中 包含 相同 的 基本 配置 。 例 如 ,创建 一 个 全 新 的 WCF 服 务 机 器 宿主 ， 使 用 
<basicHttpBinding> 和 MEX 公 开 该 服务 ， 所 需 的 *.config 文 件 看 上 去 与 前 面 编写 的 几乎 完全 相同 。 

幸好 从 .NET 4.0 开 始 ，WCF API 发 布 了 一 些 简化 方法 ， 包 括 简化 构建 宿主 配置 文件 过 程 的 默认 配 
置 (及 其 他 快捷 方式 )。 


25.10.1 ”使 用 默认 终结 点 


在 不 支持 默认 终结 点 之 前 ， 如 果 没 有 在 配置 文件 中 指定 <endpoint> 元 素 ， 就 调用 ServieHost 对 象 
的 0pen() 的 话 , 将 抛 出 运行 时 异常 。 如 果 在 代码 中 调用 AddServiceEndpoint() 来 指定 终结 点 , 也 将 得 到 
相同 的 结果 。 但 在 .NET 4.5 中 ， 每 个 WCF 服 务 都 自动 提供 了 上 默认 终结 点 ， 为 每 个 支持 的 协议 捕获 普通 
的 配置 细节 。 

打开 .NET 4.5 中 的 machine.config 文 件 ， 将 发 现 一 个 新 的 元 素 <protocolMapping>。 该 元 素 列 出 了 未 
指定 WCF 绑 定时 将 使 用 的 默认 绑 定 : 
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<system. serviceModel> 


<protocolMapping> 
<add scheme = "http" binding= "basicHttpBinding"/> 
<add scheme = "net.tcp" binding= "netTcpBinding"/> 
<add scheme = "net.pipe”" binding= "netNamedPipeBinding"/> 
<add scheme = "net.msmq" binding= "netMsmqBinding"/> 
</protocolMapping> 


</system. serviceModel> 

要 使 用 这 些 默认 绑 定 ， 你 要 做 的 仅仅 是 在 宿主 配置 文件 中 指定 基地 址 。 在 Visual Studio 中 打开 基 
于 HTTP 的 MagicEightBallServiceHost 项 目 。 要 更 新 *.config 文 件 ， 可 以 删除 所 有 WCF 服 务 的 <endpoint> 
元 素 和 MEX 指 定 的 数据 。 现 在 配置 文件 如 下 所 示 : 


<configuration> 
<system.serviceModel> 
<services> 
<service name = "MagicEightBallServicelib.MagicEightBallService" > 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


由 于 指定 了 一 个 有 效 的 HTTP <baseAddress>， 宿 主 程序 将 自动 使 用 basicHttpBinding。 再 次 运行 
宿主 程序 ， 将 得 到 相同 的 ABC 数据 : 
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六 六 玉米 炒 HOS 七 In 下 QO 六 六 六 六 六 

Address: http://localhost:8080/MagicEightBallService 
Binding: BasicHttpBinding 

Contract: IEightBall 

闵 米 闵 来 六 来 闵 永 六 冰冰 六 冰冰 冰冰 冰冰 冰冰 冰冰 

The service is ready. 

Press the Enter key to terminate service. 





我 们 还 没有 启用 MEX， 稍 后 将 使 用 另 一 个 简化 方法 一 一 默认 行为 配置 来 启用 MEX。 不 过 ,我们 
首先 要 学 习 的 是 如 何 使 用 多 重 绑 定 公 开 单 独 的 WCF 服 务 。 


25.10.2 ”使 用 多 重 绑 定 公 开 单 独 的 WCF 服 务 


从 最 初 发 布 开始 ，WCF 就 支持 单独 的 宿主 通过 多 重 终结 点 公开 WCF 服 务 。 例 如 , 通过 在 配置 文件 
中 添加 新 的 终结 点 , 你 可 以 使 用 HTTP、TCP 和 命名 管道 绑 定 来 公开 MagicEightBallService。 重启 宿主 
程序 ， 将 自动 创建 所 有 必要 的 通道 。 

在 WCF 之 前 ,使 用 多 个 绑 定 公开 单独 的 服务 是 很 困难 的 ， 因 为 不 同类 型 的 绑 定 (HTTP 或 TCP ) 
包含 不 同 的 编程 模型 。 然 而, 允许 调用 者 选择 最 适合 的 绑 定 是 很 有 用 的 。 内 部 调用 者 可 能 希望 使 用 TCP 
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绑 定 ， 外 部 客户 端 ( 在 公司 防火 墙 之 外 ) 可 能 需要 使 用 HTTP 来 进行 访问 ， 而 同一 台 机 器 上 的 客户 端 
则 会 使 用 命名 管道 。 

在 .NET 4.5 之 前 ， 需 要 手工 在 宿主 配置 文件 中 定义 多 个 <endpoint> 元 素 。 还 可 能 要 为 每 个 协议 定 
义 多 个 cbaseAddress> 元 素 。 但 是 ， 现 在 只 需要 编写 下 面 的 配置 文件 : 


<configuration> 
<system.serviceModel> 
<services> 
<service name = "MagicEightBallServicelib.MagicEightBallService" > 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
<add baseAddress = 
"net.tcp://localhost:8099/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


编译 项 目 (这 样 可 以 刷新 部 署 的 *.config 文 件 ) 并 重启 宿主 程序 ， 可 以 看 到 如 下 的 终结 点 数据 : 
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六 六 六 冰冰 Host Info 来 来 来 来 水 

Address: http://localhost:8080/MagicEightBallService 
Binding: BasicHttpBinding 

Contract: IEightBall 


Address: net.tcp://localhost:8099/MagicEightBallService 
Binding: NetTcpBinding 
Contract: IEightBall 


六 六 六 六 冰冰 冰冰 冰冰 冰 六 冰冰 冰冰 冰冰 六 冰冰 六 


The service is ready. 
Press the Enter key to terminate service. 


现在 WCF 服 务 可 从 两 种 不 同 的 终结 点 到 达 , 那么 调用 者 如 何在 两 者 之 间 进 行 选 择 呢 ? 在 生成 客户 
端 代理 时 ，Add Service Reference 工 具 将 在 客户 端 *.config 文 件 中 为 每 个 公开 的 终结 点 起 一 个 字符 串 形 
式 的 名 称 。 在 代码 中 ， 可 以 向 代理 的 构造 函数 传递 正确 的 字符 串 名 称 ， 并 且 肯 定 ， 会 使 用 正确 的 绑 定 。 
在 此 之 前 ， 我 们 需要 为 修改 后 的 宿主 配置 文件 重新 建立 MEX， 并 学 习 如 何 调整 默认 绑 定 的 设置 。 


25.10.3 ”修改 WCF 绑 定 的 设置 


如 果 在 C# 代 码 中 指定 了 服务 的 ABC ( 本 章 稍 后 将 介绍 )， 那 么 如 何 修改 WCF 绑 定 的 默认 设置 就 显 
而 易 见 了 ， 只 需要 修改 对 象 的 属性 值 即 可 。 例如 ,如果 要 使 用 BasicHttpBinding 并 希望 更 改 超时 设置 ， 
可 以 使 用 如 下 代码 : 


void ConfigureBindingInCode() 


BasicHttpBinding binding = new BasicHttpBinding(); 
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binding.0penTimeout = TimeSpan.FromSeconds(30); 


你 还 可 以 以 声明 方式 配置 绑 定 的 设置 。 例 如 ，.NET 3.5 可 以 构建 修改 了 BasicHttpBinding 的 
0penTimeout 属 性 的 宿主 配置 文件 ， 如 下 所 示 : 


<configuration> 
<system.serviceModel> 


<bindings> 
<basicHttpBinding> 
<binding name = "myCustomHttpBinding" 
openTimeout = "00:00:30" /> 
</basicHttpBinding> 
</bindings> 


<services> 
<service name = "WcfMathService.MyCalc"> 
<endpoint address = "http://localhost:8080/MyCalc" 
binding = "basicHttpBinding" 
bindingConfiguration = "myCustomHttpBinding" 
contract = "WcfMathService.IBasicMath" /> 
</service> 
</services> 
</system.serviceModel> 
</configuration> 


这 里 ,我 们 为 支持 IBasicMath 接 口 的 WcfMathService.MyCalc 服 务 编写 了 一 个 配置 文件 。 注意, 在 
<bindings> 节 中 可 以 定义 命名 的 <binding> 元 素 ， 该 元 素 可 用 来 调整 给 定 绑 定 的 设置 。 在 服务 的 
<endpoint> 内 ， 可 以 使 用 bindingConfiguration 特 性 来 连接 指定 的 设置 。 

这 种 宿主 配置 方式 同样 有 效 。 但 若 使 用 默认 的 终结 点 ， 就 不 能 将 <binding> 连 接 到 <endpoint> 了 。 
幸好 你 可 以 省 略 <binding> 元 素 的 name 特 性 , 来 控制 默认 终结 点 的 设置 。 例 如 ,， 下面 的 标记 片段 修改 了 
后 台 使 用 的 默认 BasicHttpBinding 和 NetTcpBinding 对 象 的 某 些 属性 : 


<configuration> 
<system.serviceModel> 
<services> 
<service name = "MagicEightBallServicelib.MagicEightBallService" > 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
<add baseAddress = 
"net.tcp://localhost:8099/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 


<bindings> 
<basicHttpBinding> 
<binding openTimeout = "00:00:30" /> 
</basicHttpBinding> 
<netTcpBinding> 
<binding closeTimeout ="00:00:15"/> 
</netTcpBinding> 
</bindings> 
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</system.serviceModel> 
</configuration> 


25.10.4 ”使 用 默认 的 MEX 行 为 配置 


代理 生成 工具 必须 在 运行 时 发 现 服务 ， 才 能 开始 工作 。 在 WCF 中 ， 可 以 通过 启用 MEX 来 允许 这 
种 运行 时 发 现 。 而 且 ， 大 和 多数 宿主 配置 文件 都 需要 启用 MEX ( 至 少 在 开发 时 是 这 样 )。 幸 好 我 们 很 少 
需要 修改 MEX 配 置 ， 因 此 .NET 4.5 提 供 了 一 些 快 捷 方式 。 

最 常用 的 快捷 方式 是 默认 的 MEX 支 持 。 你 不 需要 添加 MEX 终 结 点 、 定 义 命名 的 MEX 服 务 行为 并 
将 命名 的 绑 定 连接 到 服务 ( 像 HTTP 版 本 的 MagicEightBallServiceHost 那 样 ), 而 只 需要 添加 如 下 标记 : 


<configkration> 
<system.serviceModel> 
<services> 
<service name = "MagicEightBallServicelib.MagicEightBallService” > 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MagicEightBallService"/> 
<add baseAddress = 
"net.tcp://localhost:8099/MagicEightBallService"/> 
</baseAddresses> 
</host> 
</service> 
</services> 


<bindings> 
<basicHttpBinding> 
<binding openTimeout = "00:00:30" /> 
</basicHttpBinding> 
<netTcpBinding> 
<binding closeTimeout ="00:00:15"/> 
</netTcpBinding> 
</bindings> 


<behaviors> 
<serviceBehaviors> 
<behavior> 
《<1-- 不 要 命名 <serviceMetadata> 元 素 ， 这 样 可 以 得 到 默认 的 MEX --> 
<serviceMetadata httpGetEnabled = "true"/> 
</behavior> 
</serviceBehaviors> 
</behaviors> 


</system.serviceModel> 
</configuration> 


关键 点 是 <serviceMetadata> 元 素 不 再 设置 name 特 性 ( 并且 “service> 元 素 也 不 再 设置 
behaviorConfiguration 特 性 )。 这 样 就 可 以 在 运行 时 得 到 默认 的 MEX 支 持 。 编 译 并 刷新 配置 文件 ， 然 
后 运行 宿主 程序 ， 在 浏览 器 中 输入 下 面 的 URL : 

http://localhost:8080/MagicEightBallService 

打开 之 后 ， 单 击 页 面 上 方 的 wsd] 链 接 ， 查 看 服务 的 WSDL 描 述 (如 图 25-6 所 示 )。 注 意 ， 宿 主 程序 
的 控制 台 窗 口 不 会 打印 MEX 终 结 点 的 数据 , 因为 我 们 没有 在 配置 文件 中 为 IMetadataExchange 显 式 地 定 
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义 终结 点 。 但 MEX 已 经 启用 了 ， 可 以 开始 构建 客户 端 代理 了 。 


25.10.5 ”刷新 客户 端 代理 和 选择 绑 定 


假设 更 新 后 的 宿主 程序 已 经 编译 并 在 后 台 运 行 , 你 现在 可 能 希望 打开 客户 端 应 用 程序 并 刷新 当前 
的 服务 引用 。 在 Solution Explorer 中 打开 Service References 文 件 夹 ， 右 击 当 前 的 ServiceReferencel， 选 
择 Update Service Reference 菜 单 选项 ( 如 图 25-8 所 示 )。 


> SOLUTION EXPLORER 
必 呈 肖 团 二 加 | 和 | 可 中 | 辐 
Search Solution Explorer (Ctri+;) 
图 Solution "MagicEightBallServiceClient' (1 project) 
4 [Ee MagicEightBallServiceCient 
b # Properties 
b wm References 
4 Wh Service References 
Update Service Reference 
Configure Service Reference... R 
View in Object Browser 
Scopeto This 


New View 


和 app.config 
b € Program.cs 


Delete 
Rename 


Properties 


SOLUTION EXPLORER TEAM EXPLORER CLASSVIEW 
图 25-8 ”刷新 代理 和 客户 端的 *.config 文 件 


完成 之 后 ， 将 在 客户 端的 *.config 文 件 中 看 到 两 个 可 选 的 绑 定 : 一 个 用 于 HTTP， 一 个 用 于 TCP。 
可 以 看 到 ， 每 个 绑 定 都 有 一 个 适当 的 名 称 。 以 下 是 刷新 后 配置 文件 的 部 分 内 容 : 


<configuration> 
«system. serviceModel> 





<bindings> 
<basicHttpBinding> 
<binding name = "BasicHttpBinding IEightBall” ... /> 
</basicHttpBinding> 


25.11 使 用 WCF 服务 库 项 目 模板 837 


<netTcpBinding> 
<binding name = "NetTcpBinding IEightBall” ... /> 
</netTcpBinding> 
</bindings> 


<¢/system.serviceModel> 
</configuration> 


客户 端 在 创建 代理 对 象 并 选择 要 使 用 的 绑 定 时 ,可 以 使 用 这 些 名 称 。 因 此 ,如 果 客 户 端 要 使 用 TCP， 
可 以 使 用 如 下 的 C# 代 码 : 
static void Main(string[] args) 
Console.WritelLine("***** Ask the Magic 8 Ball *****\n"); 


using (EightBallClient ball = new EightBallClient("NetTcpBinding IEightBall")) 
{ 


Console.ReadLine(); 


如 果 客 户 端 要 使 用 HTTP 绑 定 ， 可 以 使 用 如 下 的 代码 : 


using (EightBallClient ball = new 
EightBallClient("BasicHttpBinding IEightBall")) 


在 当前 的 示例 中 ,我 们 介绍 了 很 多 有 用 的 快捷 方式 。 这 些 特性 简化 了 编写 宿主 配置 文件 的 方式 。 
接 下 来 ， 你 将 看 到 如 何 使 用 WCF Service Library Project 模 板 。 


源 代码 ”MagicEightBallServiceHTTPDefaultBindings 项 目的 源 代码 位 于 Chapter 25 子 目录 下 。 


25.11 使 用 WCF 服务 库 项 目 模板 


在 我 们 构建 WCF 服 务 来 和 第 21 章 中 创建 的 AutoLot 数 据 库 进行 通信 之 前 ， 下 一 个 示例 会 阐明 许多 
重要 的 主题 ,包括 WCF 服 务 库 项 目 模板 的 优势 、WCF 测 试 客户 端 、WCF 配 置 编 辑 器 、 把 WCF 服 务 承 
载 在 Windows 服 务 中 以 及 异步 客户 端 调用 。 为 了 便于 关注 这 些 新 的 方面 ，WCF 服 务 仍然 会 很 简单 。 


25.11.1 构建 简单 的 Math 服 务 


首先 , 创建 一 个 叫 MathServiceLibrary 的 全 新 WCF 服 务 库 项 目 , 请 确保 在 New Project 对 话 框 的 WCF 
节点 下 选择 正确 的 选项 ( 如 果 需 要 提示 的 话 ， 请 看 图 25-2 )。 现 在 将 初始 IServicel.cs 文 件 名 改 为 
IBasicMath.cs。 完 成 后 ， 删 除 MathServiceLibrary 命 名 空间 中 所 有 的 示例 代码 ， 然 后 使 用 如 下 代码 进行 
替换 : 


[ServiceContract(Namespace="http://MyCompany.com")] 
public interface IBasicMath 
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[OperationContract] 
int Add(int x, int y); 
} 


然后 , 将 Servicel.cs 文 件 名 改 为 MathService.cs, 并 且 再 一 次 删除 MathserviceLibrary 命 名 空间 中 的 
所 有 示例 代码 ， 然 后 这 样 实现 服 务 契 约 : 


public class MathService : IBasicMath 
{ 
public int Add(int x, int y) 


{ 
// 为 了 模拟 长 请 求 
System.Threading.Thread.Sleep(5000); 
return x + yj 
} 
最 后 ,打开 提供 的 App.config 文 件 并 将 所 有 的 IService1 修 改 为 I BasicMath, 将 所 有 的 Service1 修 改 
为 MathService。 同 样 ， 注 意 *.config 文 件 已 经 启用 了 对 MEX 的 支持 ， 并 且 默 认 使 用 的 是 wsHttpBinding 


协议 。 
25.11.2 ”使 用 WcfTestClient.exe 测 试 WCF 服 务 


使 用 WCF 服 务 库 项 目的 优势 体现 在 调试 或 运行 库 的 时 候 ， 它 会 从 *.config 文 件 中 读 取 设 置 ， 然 后 
用 它们 加 载 WCF 测 试 客户 端 应 用 程序 ( WcfTestClient.exe )。 这 个 基于 GUI 的 应 用 程序 允许 我 们 在 构建 
WCF 服 务 的 时 候 测 试 服务 接口 的 每 个 成 员 ， 而 无 须 像 之 前 那样 为 了 测试 而 手动 构建 宿主 /客户 端 。 

图 25-9 显 示 了 Mathservice 的 测试 环境 。 注 意 ， 双 击 一 个 接口 方法 ， 就 可 以 指定 输入 参数 并 且 调 用 
成 员 。 
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图 25-9 ”使 用 WecefTestClient.exe 测 试 WCF 服 务 
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虽然 在 创建 WCF 服 务 库 项 目的 时 候 ， 这 个 工具 是 现成 的 ， 但 是 要 知道 如 果 通 过 指定 MEX 终 结 点 
在 命令 行 中 启动 它 的 话 ， 我 们 可 以 用 它 来 测试 任何 WCF 服 务 。 例 如 ， 如 果 要 启动 MagicEightBall 
ServiceHost.exe 应 用 程序 ， 就 可 以 在 Developer Command Prompt 中 指定 如 下 命令 : 

wcftestclient http://localhost:8080/MagicEightBallService 

完成 后 ， 我 们 就 可 以 以 相似 方式 调用 0btainAnswerToQuestion()。 


25.11.3 ”使 用 SvcConfigEditor.exe 修 改 配置 文件 


使 用 WCF 服 务 库 项 目的 另外 一 个 好 处 是 ,我们 可 以 在 Solution Explorer 中 右 击 App.config 文 件 来 激 
活 基 于 GUI 的 服务 配置 编辑 器 SvcConfigEditorexe ( 如 图 25-10 所 示 )。 引 用 WCF 服 务 的 客户 端 应 用 程序 
也 可 以 使 用 相同 的 技术 。 


: SOLUTGA EXPLORER : 


ee 台 生 + 加 rioeln 
Search Solution Explorer (Ctrl+;) 
Solution ‘MathServicelibrary’ (1 project} 
4 MathServiceLibrary 
所 properties 
bp wa References 
yD App.config 
Cr IBasicMath,cs © Open 
Ce MathService.c Open With… 
EditWCF Configuration 
Scope to This 
国 ! New View 
Exclude From Project 
Cut 
Copy 
Delete Del 


Rename 


Properties Alt+Enter 





SOLUTION EXPLORER TEAM EXPLORER CLASSVIEW 
图 25-10 从 这 里 开始 基于 GUI 的 *.config 文 件 编辑 


激活 这 个 工具 之 后 , 我 们 就 可 以 使 用 友好 的 用 户 界 面 来 改变 基于 XML 的 数据 。 使 用 像 这 样 的 工具 
来 维护 我 们 的 *.config 文 件 有 很 多 明显 的 好 处 。 首 先 , 我 们 可 以 确保 生成 的 标记 遵守 期 望 的 格式 并 且 不 
会 有 输入 错误 。 其 次 , 还 可 以 看 到 可 以 赋 给 某 个 属性 的 有 效 值 。 最 后 , 我 们 不 需要 手动 编写 乏味 的 XML 
数据 。 

图 25-11 演 示 了 服务 配置 编辑 器 的 总 体外 观 。 说 实话 ,可 以 用 整 章 的 内 容 来 描述 SvcConfigEditor exe 
支持 的 有 趣 选 项 ( COM+ 集 成 、 新 建 *.config 文 件 等 )。 请 一 定 要 花 时 间 研 究 这 个 工具 ， 要 知道 你 可 以 
通过 按 Fl1 键 来 获得 相对 详细 的 帮助 系统 。 
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图 25-11 使 用 WCF 服 务 配 置 编 辑 器 


说 明 ”即使 你 开始 没有 选择 WCF 服 务 库 项 目 ，SvcConfigEditor.exe 工 具 还 是 可 以 编辑 (或 创建 ) 配置 
文件 。 使 Developer Command 窗 口 启动 这 个 工具 ， 然 后 使 用 File 一 Open 菜 单项 来 加 载 要 编辑 的 
既 有 *.config。 


不 需要 进一步 配置 WCF Mathservice， 因 此 现在 可 以 构建 自 定义 宿主 了 。 


25.12 以 Windows 服务 承载 WCF 服务 


你 可 能 会 同意 ， 在 一 个 控制 台 应 用 程序 ( 或 在 GUI 桌面 应 用 程序 中 ) 中 承载 WCF 服 务 对 于 产品 
别 的 服务 器 来 说 不 是 一 个 理想 的 选择 ， 因 为 宿主 必须 一 直 保 持 在 后 台 可 视 地 运行 来 服务 客户 端 。 即 使 
我 们 把 宿主 应 用 程序 最 小 化 到 Windows 任 务 栏 中 ,仍然 有 可 能 不 小 心 关 闭 这 个 程序 ， 这 样 也 就 终止 了 
任何 客户 端 应 用 程序 的 连接 。 


说 了 明 虽然 桌面 Windows 应 用 程序 不 一 定 要 显示 主 窗口 ,但 是 大 多 数 *.exe 需 要 用 户 的 交互 才能 加 载 可 
执行 程序 。 因 此 ，Windows 服 务 ( 后 面 会 介绍 ) 可 以 配置 为 即使 用 户 当前 没有 登录 到 工作 站 的 
时 候 也 能 运行 。 


如 果 你 正在 构建 一 个 内 部 的 WCF 应 用 程序 ， 另 外 一 种 承载 WCF 服 务 库 的 方案 就 是 使 用 专 有 的 
Windows 服 务 。 这 样 做 的 一 个 好 处 是 Windows 服 务 可 以 配置 为 在 目标 机 器 启动 的 时 候 自动 启动 。 另 一 
个 好 处 是 Windows 服 务 在 后 台 不 可 视 地 运行 ( 和 控制 台 应 用 程序 不 同 ) 并 且 不 需要 用 户 交互 性 (而且 
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不 需要 在 宿主 计算 机 上 安装 IIS )。 
为 了 演示 如 何 构 建 这 样 的 宿主 , 首先 新 建 一 个 叫 MathWindowsServiceHost 的 Windows 服 务 项 目 ( 如 
图 25-12 所 示 )。 完 成 后 ， 使 用 Solution Explorer 将 最 初 的 Servicel.cs 文 件 重 命名 为 MathWinService.cs。 












[NET Framework4s sotbr Odo, 由 辐 Search installed Tampltes eit 
2: ”Type: Visual C# 


[ | Windows Forms Application 
A project for creating Windows Services 


站 
WPF Application 
站 
Console Apphcation 
Class Library VisvalCe 于 
portable Class tibrary VisgalCs | 
WPF Browser Application Visual C# 
Empty Project Visual Cz 
WE 
es 
| WPF Custom Contro} Library Visual CN 
4 


" 
| WPF User Control Library 


MathWindowsServicetost 











MathWindowsSeracetost 





图 25-12 ”创建 一 个 Windows 服 务 来 承载 我 们 的 WCF 服 务 





25.12.1 在 代码 中 指定 ABC 


现在 ， 假 设 我 们 设置 了 MathServiceLibrary.dl 和 System.ServiceModel.dll 程 序 集 的 引用 ， 所 有 需要 
做 的 就 是 在 Windows 服 务 类 型 的 Oonstart() 和 0nstop() 中 使 用 ServiceHost 类 型 。 打 开 服务 宿主 类 的 代码 
文件 (通过 右 击 设计 器 并 选择 View Code ) 并 且 增 加 如 下 逻辑 : 

// 确保 导入 这 些 命名 空间 

using MathServicelibrary; 

using System.ServiceModel; 

namespace MathWindowsServiceHost 


public partial class MathWinService: ServiceBase 


// ServiceHost 类 型 的 成 员 变量 
private ServiceHost myHost; 


public MathWinService() 


InitializeComponent(); 
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protected override void OnStart(string[] args) 


// 只 是 为 了 确保 安全 
if (myHost != null) 


myHost.Close(); 
myHost = null; 
} 


// 创建 宿主 
myHost = new ServiceHost(typeof(MathService)); 


// 代码 中 的 ABC 
Uri address = new Uri("http://localhost:8080/MathServiceLibrary"); 


WSHttpBinding binding = new WSHttpBinding(); 
Type contract = typeof(IBasicMath); 


// 增加 终结 点 
myHost.AddServiceEndpoint(contract, binding, address); 


// 打开 宿主 
myHost .Open(); 


protected override void OnStop() 


// 关闭 宿主 
if(myHost != null) 
myHost.Close(); 


} 
} 


虽然 在 为 WCF 服 务 构建 Windows 服 务 宿主 的 时 候 ， 完 全 可 以 使 用 配置 文件 ， 但 是 在 这 里 (为 了 改 
变 习 惯 ) 我 们 以 编程 方式 使 用 Uri 、WSHttpBinding 和 Type 类 来 创建 终结 点 ， 而 不 是 使 用 *.config 文 件 。 
在 创建 了 ABC 的 每 个 方面 之 后 ， 我 们 就 会 通过 调用 AddserviceEndpoint() 来 以 编程 方式 通知 宿主 。 

如 果 想 通知 运行 时 ， 你 希望 访问 .NET 4.5 machine.config 文件 中 的 所 有 默认 终结 点 绑 定 ， 可 以 简 
化 编程 逻辑 ， 在 调用 ServiceHost 构 造 函 数 的 时 候 指定 基地 址 。 在 这 种 情况 下 ,就 不 需要 在 代码 中 手工 
指定 ABC 或 调用 AddServiceEndpoint()， 而 只 需要 调用 AddDefaultEndpoints()。 考 虑 如 下 的 更 新 : 


protected override void OnStart(string[] args) 
if (myHost != null) 
myHost.Close(); 
// 创建 宿主 ， 并 为 HTTP 绑 定 指定 URL 
myHost = new ServiceHost(typeof(MathService), 
new Uri("http://localhost:8080/MathServicelLibrary")); 


// 选择 默认 的 终结 点 
myHost .AddDefau1ltEndpoints(); 


// 打开 宿主 
myHost .Open(); 
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25.12.2 启用 MEX 


虽然 我 们 也 可 以 以 编程 方式 开启 MEX, 但 是 我 们 会 采用 配置 文件 。 向 Windows 服 务 项 目 插入 一 个 
新 的 App.config 文 件 ， 它 包含 如 下 的 MEX 设 置 : 


<?xml version = "1.0" encoding = "utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name = "MathServicelLibrary.MathService"> 
</service> 
</services> 


<behaviors> 
<serviceBehaviors> 
<behavior> 
<serviceMetadata httpGetEnabled = "true"/> 
</behavior> 
</serviceBehaviors> 
</behaviors> 


</system.serviceModel> 
</configuration> 


25.12.3 ”创建 Windows 服 务 安装 程序 


为 了 把 Windows 服 务 注 册 到 操作 系统 ， 我 们 需要 向 项 目 增加 一 个 安装 程序 来 包含 注册 服务 的 必要 
代码 。 只 需要 右 击 Windows 服 务 设计 器 界面 并 且 选 择 Add Installer ( 如 图 25-13 所 示 ) 即 可 。 


| MathWinService'cs [Design] 所 x 


《> View Code 


Line Up lcons > 
ethe Properties window 
,click here to Switch to 


To add components to your class 


to set their properties. To create thow intge leons 


上 dd Installer 人 
于 ”Properties 





图 25-13 ”为 Windows 服 务 增加 安装 程序 


完成 后 ， 你 就 会 看 到 新 设计 器 界面 上 加 入 了 两 个 组 件 。 第 一 个 组 件 (默认 为 serviceprocessInstaller1 ) 
表示 可 以 在 目标 机 器 上 安装 的 新 的 Windows 服 务 的 类 型 。 在 设计 器 上 选择 这 个 类 型 ， 然 后 在 Properties 
窗口 中 将 Account 属 性 设置 为 LocalSystem ( 如 图 25-14 所 示 )。 
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王浆] 国 |> | 


和 


(Name) ora el 
LocalSystem 

GenerateMember True 

HelpText 

Modifiers 





Parent ProjectInstaller 


Indicates the account type under which the service will run- 





图 25-14 ”确保 以 本 地 系统 账号 运行 Windows 服 务 


第 二 个 组 件 ( 名 为 serviceInstaller1 ) 表示 会 安装 我 们 的 某 个 Windows 服 务 的 类 型 。 同 样 ， 使 用 
Properties 窗 口 将 ServiceName 属 性 修改 为 Mathservice， 将 StartType 属 性 设置 为 Automatic， 并 且 通 过 
Description 属 性 增加 一 个 Windows 服 务 的 友好 描述 ( 如 图 25-15 所 示 )。 


: PROPERTIES +:: 因 2 
servicelInstaller1 Sytem SeviceProcess servicelnataer 
和 国耻 

(Name) serviceinstallerl 

~ DelayedAutoStart False 
Descnption This is the math service! 

“ DisplayName i 
~ GenerateMember 

~ HelpText 


Modifiers 
parent 
ServiceName 
ServicesDependedOn 





Indicates the service's description (a brief comment that 
explains the purpose of the service). 





图 25-15 ”配置 安装 器 细节 
至 此 ， 我 们 就 可 以 编译 应 用 程序 了 。 
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25.12.4 ”安装 Windows 服 务 


Windows 服 务 可 以 使 用 传统 的 安装 程序 ( 如 *.msi 安 装 程序 ) 或 通过 installutil.exe 命 令 行 工 具 来 安 
装 到 宿主 上 。 





说 明 ”要 使 用 intallutil.exe 安 装 Windows 服 务 ， 必 须 以 管理 员 权 限 启动 Developer Command Prompt。 右 
击 Developer Command Prompt 图 标 ， 选 择 Run As Administrator。 





使 用 Developer Command Prompt， 转 到 MathWindowsServiceHost 项 目的 \bin\Debug 文 件 夹 。 现 在 输 
installutil MathWindowsServiceHost.exe 


如 果 安 装 成 功 ， 现 在 就 可 以 打开 控制 面板 中 Administrative Tools 文 件 夹 下 的 服务 工具 。 可 以 看 到 
Windows 服 务 的 友好 名 称 已 经 按照 字母 顺序 列 出 了 。 找到 它 后 ,就 可 以 使 用 Start 链 接 启动 我 们 本 地 机 器 
上 的 服务 (如 图 25-16 所 示 )。 


Name Description Status 
全]psec Policy Agent Intemet Protocol security (IPsec... Started 
KemRm for Distrib... Coordinates transactions betwe,.. 
Link-Layer Topoilo... Creates 3 Network Map, consist,.. 
| SEC This is he math service! 
| Description: 二 Media Center Exte,. Alows Media Center Etenders .. 
‘| This is the math service! Microsoft .NET Fr. Nicrosoft ,NET Framework NGEN 
S%Microsoft ,NET Fr... Nicrosoft ,NET Framework NGEN 





Microsoft ,NET Fr... Microsoft .NET Framework NGEN 
“Microsoft ,NET Fr. Microsoft ,NET Framework NGEN 





\ Extended 人 Standard / 











图 25-16 ”查看 我 们 的 Windows 服 务 ， 它 承载 了 我 们 的 WCF 服 务 
既然 服务 存在 并 且 启 动 了 ， 最 后 一 步 就 是 构建 客户 端 应 用 程序 来 消费 这 个 服务 。 


源 代 码 ”MathWindowsServiceHost 项 目的 源 代 码 位 于 Chapter 25 子 目录 下 。 


25.13 ”从 客户 端 异 步调 用 服务 


新 建 一 个 控制 台 应 用 程序 项 目 MathClient, 然后 使 用 Visual Studio 的 Add Service Reference 选 项 来 添 
加 运行 中 WCF 服 务 ( 当前 由 后 台 运 行 的 Windows 服 务 承载 ) 的 引用 ( 需要 在 Addresses 框 中 键入 URL， 
可 能 为 http://localhost:8080/MathServiceLibrary )。 然 而 ， 暂 时 不 要 单 击 OK 按钮 。 注 意 Add Service 
Reference 对 话 框 中 左下 角 的 Advanced 按 钮 ( 如 图 25-17 所 示 )。 
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To see a list of available services on a specific server, enter a service URL and ciick Go. To browse for available 
| services, <click Discover, 











图 25-17 引用 Mathservice 并 准备 配置 高 级 设置 


现在 单 击 这 个 按钮 来 看 其 他 的 代理 配置 选项 ( 如 图 25-18 所 示 )。 使 用 这 个 对 话 框 ,我 们 可 以 生成 
允许 我 们 以 异步 形式 调用 远程 方法 的 代码 , 可 以 通过 Generate asynchronous operators 单 选 框 来 完成 。 现 
在 ， 请 选中 这 个 选项 。 





Access level for generated classes: [Pubiic - i ee 
BY Allow generation of asynchronous operations 
人 DGenerate task-based operations 
Generate asynchronous operations 
et 3 
1 Ahways generate message contracts 
Coliection type: 














Dictionary collection type 
(7 Reuse types in referenced assemblies 
© Reuse types in all referenced assemblies 
* Reuse types mn specified referenced assembbes: 








Add a Web Reference instead of a Service Reference. This will generate code based on .NET Framework 20 
Web Services technology. 


图 25-18 ”高 级 客户 端 代 理 配 置 选 项 
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至 此 , 代理 代码 就 会 包含 允许 我 们 使 用 第 19 章 介绍 的 Begin/End 异 步调 用 方式 调用 每 个 服务 契约 成 
员 。 这 里 使 用 的 是 一 个 使 用 Lambda 表 达 式 而 不 是 强 类 型 AsyncCallback 委 托 的 简单 实现 。 
using System; 
using MathClient.ServiceReferencel; 
namespace MathClient 
class Program 
static void Main(string[] args) 
Console.WritelLine("***** The Async Math Client *****\n"); 
using (BasicMathClient proxy = new BasicMathClient()) 
{ 
proxy.Open(); 
// 使 用 Lambda 表 达 式 以 异步 方式 增加 数字 
IAsyncResult result = proxy.BeginAdd(2，3， 
ar => 
Console.WriteLine("2 + 3 = {0}", proxy.EndAdd(ar)); 
nul1); 
while (!result.IsCompleted) 
Thread.Sleep(200); 


Console.WriteLine("Client working..."); 


Console.ReadLine(); 


源 代 码 ”MathClient 项 目的 源 代 码 位 于 Chapter 25 子 目录 下 。 


25.14 定义 WCF 数据 契约 


本 章 最 后 一 个 示例 是 WCF 数 据 揣 约 的 构建 ,之 前 的 WCF 服 务 定义 了 非常 简单 的 方法 操作 原生 CLR 
数据 类 型 。 只 要 使 用 任何 HTTP 绑 定 类 型 ( basicHttpBinding、wsHttpBinding 等 )， 传 人 的 和 输出 的 数 
据 类 型 都 会 被 自动 格式 化 为 XML 元 素 。 补 充 一 点 ， 如 果 使 用 的 是 基于 TCP 的 绑 定 ( 如 netTcpBinding )， 
简单 数据 类 型 的 参数 和 返回 值 就 会 用 紧凑 二 进 制 格式 进行 传输 。 


说 明  WCF 和 运行 库 还 会 自动 为 所 有 使 用 [Serializable] 的 特性 进行 编码 。 但 这 并 不 是 定义 WCF 契 约 
的 推荐 方法 ， 它 只 是 为 了 向 后 兼容 。 
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然而 , 如 果 我 们 定义 服务 契约 将 自 定义 类 型 作为 参数 或 返回 值 , 那么 最 佳 实践 是 用 WCF 数 据 契 约 
对 这 些 数据 进行 建 模 。 简 而 言 之 ， 数 据 契 约 是 使 用 [DataContract] 特性 的 类 型 。 每 一 个 需要 用 作 契 约 
的 一 部 分 的 字段 也 标记 了 [DataMember] 特 性 。 


说 明 在 早期 的 .NET 平 台 版 本 中 ， 要 确保 正确 表示 自 定义 数据 类 型 ， 就 要 强制 使 用 [DataContract] 
和 [DataMember]。 从 技术 上 说 ,在 自 定义 数据 类 型 上 使 用 这 些 特性 不 是 必需 的 。 但 这 被 认为 是 
一 项 .NET 最 佳 实践 。 


25.14.1 使 用 Web 相 关 的 WCF 服 务 项 目 模板 


我 们 的 下 一 个 WCF 服 务 将 允许 外 部 调用 者 和 第 21 章 中 创建 的 AutoLot 数 据 库 进行 交互 。 此 外 ， 这 
个 最 后 的 WCF 服 务 会 使 用 基于 Web 的 WCF 服 务 模板 来 创建 并 部 署 在 IIS 下 。 

打开 Visutal Studio( 以 管理 员 权 限 )， 访 问 File 一 New 一 Web Site 菜 单项 。 选 择 WCF Service 项 目 类 
型 ， 并 确保 Web Location 的 下 拉 框 选择 的 是 HTTP ( 这 将 在 IS 中 安装 我 们 的 服务 )。 将 服务 公开 为 下 面 
的 URI: 

http://localhost/AutoLotWCFService 

图 25-19 展 示 了 配置 后 的 项 目 。 








二 | Search Instalied Templates 


Type: Visual C# 
A Web site for creating WCF services 


ASP NET Web Forms Ste 
ASP.NET Web Srte (Razor v2) 


. 
ASP.NET Web Site (Razor) 





和 
ASPNET Empty Web Site Visual C# 


Visual C# 





图 25-19 ”创建 Web 相 关 的 WCF 服 务 


完成 后 ， 添 加 第 21 章 中 创建 的 AutoLotDAL.dll 程 序 集 的 引用 (通过 Website 一 Add Reference 菜 单 
项 )。 有 一 些 示 例 初 始 代码 (在 App_Code 文 件 夹 中 )， 你 可 能 会 要 删除 。 首 先 ， 将 最 初 的 IService.cs 文 
件 重 命名 为 IJAutoLotService.cs， 然 后 在 新 命名 的 文件 中 定义 最 初 的 服务 契约 ， 如 下 所 示 : 


[ServiceContract] 
public interface IAutoLotService 
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[OperationContract] 
void InsertCar(int id, string make, string color, string petname); 


[OperationContract] 
void InsertCar(InventoryRecord car); 


[OperationContract] 
InventoryRecord[] GetInventory(); 
} 


这 个 接口 定义 了 3 个 方法 ， 其 中 一 个 返回 ( 还 未 创建 的 ) InventoryRecord 类 型 的 数组 。 回 忆 一 下 ， 
InventoryDAL 的 GetInventory() 方 法 只 是 返回 DataTable 对 象 ， 你 可 能 会 问 为 什么 我 们 服务 的 
GetInventory() 方 法 不 这 么 做 呢 。 

虽然 从 WCF 服 务 方法 返回 DataTable 是 可 行 的 ,但 是 回忆 一 下 WCF 的 构建 遵循 SOA 标 准 ， 其 中 一 
个 要 点 就 是 对 契约 编程 ， 而 不 是 实现 。 因 此 ， 我 们 会 返回 以 未 知 方式 用 WSDL 文 档 正 确 表达 的 自 定 义 
数据 契约 ( InventoryRecord )， 而 不 会 把 .NET 特 有 的 DataTable 类 型 返回 给 外 部 调用 者 。 

还 要 注意 ， 接 口 定义 了 叫做 InsertCar() 的 重 载 方法 。 第 一 个 版 本 接受 了 4 个 传人 参数 ， 而 第 二 个 
版 本 接受 了 InventoryRecord 类 型 作为 输入 。 你 可 以 按照 如 下 所 示 定 义 InventoryRecord 数 据 契 约 : 


[DataContract] 
public class InventoryRecord 


[DataMember] 
public int ID; 


[DataMember] 
public string Make; 


[DataMember] 
public string Color; 


[DataMember] 
public string PetName; 


如 果 像 现在 这 样 实现 IAutoLotService 接 口 ,编译 宿主 并 是 尝试 从 客户 端 调用 这 些 方法 的 话 , 你 可 
能 会 得 到 一 个 运行 时 异常 。 出 现 这 个 问题 的 原因 是 WSDL 描 述 要 求 每 一 个 从 给 定 终结 点 公开 的 方法 必 
须 具 有 唯一 的 名 字 。 因 此 ， 虽 然 对 于 C# 来 说 方法 重 载 可 以 实现 ,但 是 当前 的 Web 服 务 规范 不 允许 两 个 
方法 都 命名 为 InsertCar()。 

可 嘉 的 是 ，[0perationContract] 特 性 支持 一 个 命名 属性 ( Name )， 它 能 让 我 们 指定 如 何在 WSDL 
描述 中 表示 C# 方 法 。 那 么 ， 可 以 按 如 下 所 示 更 新 第 二 个 版 本 的 InsertCar() : 


public interface IAutoLotService 


[OperationContract(Name = "InsertCarWithDetails")] 
void InsertCar(InventoryRecord car); 


25.14.2 ”实现 服务 契约 


现在 将 Service.cs 重 命名 为 AutoLotService.cs 。AutoLotService 类 型 按 如 下 方式 实现 了 IAutoLot- 
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Service 接 口 (请 确保 在 代码 文件 中 导 人 AutoLotConnectedLayer 和 System.Data 命 名 空间 ， 并 在 需要 的 
时 候 更 新 连接 字符 串 ): 


using AutoLotConnectedLayer; 
using System.Data; 


public class AutoLotService : IAutoLotService 


private const string ConnString = 
@"Data Source=(local)\SQLEXPRESS;Initial Catalog=AutoLot"+ 
";Integrated Security=True"; 


public void InsertCar(int id, string make, string color, string petname) 


InventoryDAL d = new InventoryDAL(); 
d.0penConnection(ConnString); 
d.InsertAuto(id, color, make, petname); 
d.CloseConnection(); 


} 


public void InsertCar(InventoryRecord car) 


InventoryDAL d = new InventoryDAL(); 
d.OpenConnection(ConnString); 

d.InsertAuto(car.ID, car.Color, car.Make, car.PetName); 
d.CloseConnection(); 


} 
public InventoryRecord[] GetInventory() 


// 首先 ， 从 数据 库 获 取 DataTable 
InventoryDAL d = new InventoryDAL(); 
d.0penConnection(ConnSstring); 

DataTable dt = d.GetAllInventoryAsDataTable(); 
d.CloseConnection(); 


// 创建 List<T> 来 获取 记录 
List<InventoryRecord> records = new List<InventoryRecord>(); 


// 把 数据 表 复 制 到 客户 端 契 约 的 List<> 中 
DataTableReader reader = dt.CreateDataReader(); 
while (reader.Read()) 

{ 


InventoryRecord r = new InventoryRecord(); 
r.ID = (int)reader["CarID"]; 

r.Color = ((string)reader["Color"]); 
r.Make = ((string)reader["Make"]); 
r.PetName = ((string)reader["PetName"]); 
records.Add(r); 


// 把 List<T> 转 换 到 InventoryRecord 类 型 的 数组 
return (InventoryRecord[])records.ToArray(); 


} 
} 


没什么 可 说 的 。 为 了 简单 ， 我 们 硬 编码 了 连接 字符 串 值 ( 可 能 需要 根据 机 器 配置 进行 调整 )， 而 
不 是 把 它 保存 在 web.config 文 件 中 。 由 于 我 们 的 数据 访问 类 库 确 实 和 AutoLost 数 据 库 进 行 真实 的 通信 ， 
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我 们 需要 做 的 只 是 把 参数 传人 InventoryDAL 类 类 型 的 InsertAuto() 方 法 中 。 还 有 一 个 有 趣 的 地 方 是 ， 
把 DataTable 对 象 的 值 映 射 到 泛 型 InventoryRecord 类 型 ( 使 用 DataTableReader 来 实现 ) 列表 ， 然 后 把 
List<T> 转 换 到 InventoryRecord 类 型 的 数组 。 


25.14.3 *.svc 文 件 的 作用 


在 创建 Web 相 关 的 WCF 服 务 时 ， 你 会 发 现 项 目 包 含 了 一 个 具有 *.svc 文 件 扩展 名 的 特殊 文件 。 
这 个 特殊 文件 对 于 任何 由 IIS 承 载 的 WCF 服 务 来 说 都 是 必需 的 ， 它 描述 了 安装 点 服务 实现 的 名 字 和 
位 置 。 因 为 我 们 改变 了 起 始 文 件 和 WCF 类 型 的 名 字 ， 所 以 必须 按 如 下 所 示 更 新 Service.svc 文 件 的 
内 容 : 


<%@ ServiceHost Language="C#" Debug="true" 
Service="AutoLotService" CodeBehind="~/App Code/AutoLotService.cs" %> 


25.14.4 更 新 web.config 文 件 


在 HTTP 下 创建 的 WCF 服 务 的 web.config 文 件 将 使 用 很 多 本 章 前 面 介绍 的 WCF 简 化 配置 .本 书 稍 后 
研究 ASPNET 的 时 候 会 更 详细 介绍 ，web.config 文 件 和 可 执行 的 *.config 文 件 有 相似 的 作用 。 但 它 还 控 
制 了 许多 Web 特 有 的 设置 。 如 下 面 的 示例 启用 了 MEX， 并 且 不 需要 手工 指定 自 定义 的 <endpointy> : 


<configuration> 


<system.serviceModel> 
<behaviors> 
<serviceBehaviors> 
<behavior> 
《1-- 为 了 避免 泄露 元 数据 信息 ， 在 部 署 前 要 将 下 面 的 值 设 置 为 false， 并 移 除 元 数据 终结 点 --> 
<serviceMetadata httpGetEnabled="true" httpsGetEnabled="true"/> 
《1-- 为 了 在 调试 时 接收 异常 信息 ， 可 以 将 下 面 的 值 设置 为 true。 在 部 署 前 将 其 设置 为 false， 
可 以 避免 泄露 异常 信息 --> 
<serviceDebug includeExceptionDetailInFaults="false"/> 
</behavior> 
</serviceBehaviors> 
</behaviors> 
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" 
multipleSiteBindingsEnabled="true" /> 
</system. serviceModel> 


</configuration> 


25.14.5 ”测试 服务 


现在 我 们 完全 可 以 构建 任何 形式 的 客户 端 来 测试 服务 ， 当 然 也 可 以 把 *.svc 文 件 的 终结 点 传人 
WcfTestClient.exe 应 用 程序 : 
WcfTestClient http://localhost/AutoLotWCFService/Service.svc 
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如 果 要 构建 一 个 自 定义 客户 端 应 用 程序 ,可 以 通过 Add Service Reference 对 话 框 来 完成 ,所 用 的 方 
法 和 本 章 前 面 的 MagicEightBallServiceClient 项 目 和 MathClient 项 目 一 样 。 


源 代码 ”AutoLotService 项 目的 源 代码 位 于 Chapter 25 子 目录 下 。 


对 WCF API 的 学 习 至 此 告 一 段落 。 当 然 , 关于 WCF 还 有 很 多 内 容 没 有 涉及 , 但 如 果 你 了 解 了 本 章 
所 讲述 的 内 容 ， 就 可 以 为 更 深入 的 学 习 打 下 良好 的 基础 。 要 学 习 WCF 的 更 多 内 容 ， 请 参考 .NET 
Framework 4.5 SDK 文 档 。 


25.15 小结 


本 章 介 绍 了 .NET 3.0 及 其 更 高 版 本 所 提供 的 WCF API。 正 如 前 面 所 说 的 ，WCF 背 后 的 主要 动机 是 
提供 一 个 统一 的 对 象 模型 。 该 模型 使 用 单一 的 编程 接口 来 提供 一 些 ( 在 以 前 是 不 相关 的 ) 分 布 式 计算 
API。 此 外 ，WCF 服 务 是 使 用 特定 的 地 址 、 绑 定 和 契约 来 表示 的 ( 可 以 通过 使 用 友好 的 缩 略语 ABC 来 
方便 记忆 )。 

一 个 典型 的 WCF 应 用 程序 包括 对 三 个 相关 程序 集 的 使 用 。 第 一 个 程序 集 定义 了 服务 契约 和 代表 服 
务 功 能 的 服务 类 型 。 然 后 ， 该 程序 集 可 由 自 定义 可 执行 文件 、IIS 虚 拟 目 录 、Windows 服 务 所 承载 。 最 
后 ， 客 户 端 程序 集 使 用 定义 了 代理 类 型 的 代码 文件 ( 以 及 应 用 程序 配置 文件 中 的 设置 ) 去 与 远程 类 型 
进行 通信 。 

本 章 的 结尾 部 分 提 及 了 WCF 编 程 工具 SvcConfigEditorexe ( 使 用 它 可 以 修改 *.config 文 件 )、 
WcfTestClient.exe 应 用 程序 ( 快速 测试 WCF 服 务 ) 和 各 种 Visual Studio WCF 项 目 模板 。 你 还 学 习 了 一 
些 简 化 配置 ， 包 括 默 认 的 终结 点 和 行为 。 
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* 们 知道 ，.NET 平 台 支 持 Windows Workflow Foundation ( WF ) 编程 模型 。 该 API 可 以 对 给 定 

的 .NET 程 序 内 部 所 使 用 的 工作 流 (workflow， 业 务 流程 ) 进行 建 模 、 配 置 、 监 视 和 执行 。 
默认 情况 下 ,工作 流 的 建 模 使 用 一 种 声明 式 的 基于 XML 的 语法 XAML。 在 XAML 中 , 工作 流 所 使 用 的 
数据 被 视 为 一 等 公民 。 

如 果 你 是 WF 新 手 ， 那 么 本 章 首 先 定义 了 什么 是 业务 流程 ， 然 后 描述 业务 流程 是 如 何 与 WF API 相 
关联 的 。 在 此 过 程 中 ,你 将 了 解 到 WF 活动 (activity ) 的 概念 、 工 作 流 的 公共 类 型 以 及 各 种 项 目 模 板 
和 编程 工具 。 在 讲解 了 基础 知识 之 后 ， 我 们 将 编写 几 个 示例 程序 说明 如 何 利用 WF 编程 模型 来 建立 
在 WF 运行 时 引擎 监视 之 下 执行 的 业务 流程 。 


说 明 WF API 的 整个 内 容 不 可 能 在 这 么 一 个 介绍 性 的 章节 里 全 部 涵盖 。 如 果 你 需要 了 解 更 深入 的 内 
容 ， 请 参考 Bayer White 所 著 的 Pro WF 4.5 ( Apress, 2012 )。 


26.1 定义 业务 流程 


任何 现实 世界 的 应 用 程序 都 必须 能 为 各 种 业务 流程 建 模 。 简 单 地 说 ， 一 个 业务 流程 是 对 逻辑 上 作 
为 一 个 整体 协同 工作 的 多 个 任务 在 概念 上 进行 组 合 。 例如 , 构建 一 个 让 用 户 在 线 购买 汽车 的 应 用 程序 。 
在 用 户 提交 订单 后 ， 很 多 活动 开始 运转 。 我 们 也 许 首先 执 行 信用 检查 。 如 果 用 户 通过 了 信用 验证 ， 就 
执行 一 个 数据 库 事务 ， 从 Inventory 表 中 删除 一 条 记录 ,在 0rders 表 中 添加 一 条 记录 ， 并 更 新 用 户 的 账 
户 信息 。 在 数据 库 事 务 完成 之 后 ,我 们 也 许 还 需要 给 买方 发 送 一 个 确认 电子 邮件 ,然后 调用 一 个 远程 
服务 向 汽车 代理 商 下 订单 。 总 的 来 说 ， 所 有 这 些 任 务 代表 了 一 个 单独 的 业务 流程 。 

一 直 以 来 , 业务 流程 建 模 都 是 程序 员 需 要 应 对 的 另 一 个 细节 ， 经 常 需要 通过 自 定义 的 代码 来 确保 
业务 流程 能 够 正确 地 建 模 ， 并 且 确 保 其 在 应 用 程序 内 部 能 够 正确 地 执行 。 例如 ， 你 可 能 需要 编写 其 他 
的 代码 来 处 理 流程 中 出 现 的 错误 、 跟 踪 和 日 志 记 录 支 持 ( 用 来 查看 指定 业务 流程 进行 的 情况 )、 持 久 
支持 (用 来 保存 长 久 运行 的 流程 的 状态 ) 以 及 其 他 一 些 东 西 。 你 大 概 有 过 亲身 体验 ， 构 建 这 种 基础 设 
施 需 要 花费 很 长 时 间 和 很 多 手工 劳动 。 

假设 一 个 开发 团队 已 经 为 他 们 的 应 用 程序 打造 了 一 个 自 定义 的 业务 流程 框架 , 但 是 他 们 的 工作 还 
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没有 结束 。 简 单 地 说 ， 团 队 中 除了 程序 员 以 外 ， 还 有 其 他 人 员 也 需要 了 解 业 务 流程 ， 而 向 他 们 解释 原 
生 的 C# 代 码 库 并 不 是 一 件 容 易 的 事情 。 事 实 上 ,业务 方面 的 专家 、 经 理 、 销 售 人 员 和 美工 设计 团队 的 
成 员 并 不 懂 代 码 语言 。 鉴 于 这 个 事实 ， 作 为 程序 员 ， 我 们 需要 利用 其 他 的 建 模 工 具 ( 例如 ， 使 用 微软 
的 Visio， 或 直接 贴 在 办 公 室 的 公告 栏 上 )， 使 用 非 技 术 性 的 中 性 术语 以 图 形 的 形式 来 表示 流程 。 这 里 
很 明显 的 问题 是 ， 我 们 需要 保持 两 个 实体 的 一 致 性 ， 即 如 果 我 们 改动 了 代码 ， 就 需要 更 新 图 表 ; 假如 
我 们 改动 了 图 表 ， 代 码 也 要 随 之 更 新 。 

此 外 , 当 使 用 100% 代 码 的 方式 来 构建 一 个 复杂 的 软件 应 用 程序 时 , 在 代码 库 里 将 看 不 出 应 用 程序 
内 部 流程 的 痕迹 。 例 如 , 一 个 典型 的 .NET 程 序 可 能 由 成 百 上 千 个 自 定义 类 型 组 成 (更 不 用 说 所 使 用 的 
基础 类 库 的 种 种 类 型 了 )。 尽 管 程序 员 知 道 对 象 间 是 如 何 调用 的 ， 但 是 代码 本 身 跟 一 个 解释 整个 活动 
序列 的 活 文档 相 比 ， 还 是 差 得 很 远 。 开 发 团队 也 许 会 创建 外 部 文档 和 工作 流程 图 ,但 是 这 同样 还 是 会 
遇 到 一 个 流程 多 种 表现 形式 的 问题 。 


WF 的 作用 


实质 上 ，WF API 人 允许 程序 员 使 用 预制 的 活动 集 声明 式 地 设计 业务 流程 。 这 样 ， 并 不 需要 创建 自 定 
义 的 程序 集 来 表示 一 个 给 定 的 业务 活动 和 所 需 的 基础 设施 ,我们 就 可 以 利用 Visual Studio 的 WF 设计 器 ， 
在 设计 阶段 创建 我 们 的 业务 流程 了 。 这 样 ， 我 们 可 以 通过 WF 构建 一 个 业务 流程 的 骨架 ， 然 后 再 用 代 
码 来 实现 。 

WF API 编 程 可 用 单个 实体 来 表示 整个 业务 流程 以 及 定义 这 个 流程 的 代码 。 因 为 单个 WF 文档 不 仅 
为 业务 流程 提供 了 一 个 友好 的 视觉 表示 ， 它 还 可 以 用 来 代表 驱动 流程 的 代码 ， 所 以 我 们 不 再 需要 担心 
多 个 文档 不 同步 的 问题 了 。 更 棒 的 是 ， 这 个 WF 文档 能 清楚 地 说 明 流程 本 身 。 加 上 一 点 点 的 指导 ， 即 
使 那些 最 不 了 解 技术 的 团队 成 员 也 应 该 能 理解 WF 设计 器 所 建立 的 模型 。 


26.2 构建 简单 的 工作 流 


当 构 建 一 个 启用 工作 流 的 应 用 程序 时 , 你 肯定 会 注意 到 它 与 构建 传统 .NET 应 用 程序 有 所 不 同 。 例 
如 ， 本 书 到 目前 为 止 ， 每 个 代码 例子 都 从 创建 一 个 新 的 项 目 工 作 空间 开始 ( 如 最 常见 的 控制 台 应 用 程 
序 ), 然后 编写 代码 来 表示 详细 的 程序 。 一 个 WF 应 用 程序 也 由 自 定义 代码 组 成 , 但 你 同时 还 要 把 业务 
流程 本 身 直接 构建 到 程序 集中 去 。 

WF 男 一 个 与 其 他 类 型 的 .NET 应 用 程序 不 同 的 方面 是 ， 大 多 数 工作 流 模型 都 使 用 基于 XML 的 语法 
XAML 来 声明 式 地 构建 。 大 多 数 情况 下 ， 你 不 需要 直接 编写 这 些 标记 ， 因 为 在 你 使 用 WF 设计 器 工具 
时 ，Visual Studio IDE 会 自动 完成 这 些 工 作 。 这 是 WF API 较 以 往 的 版 本 一 个 很 大 的 改变 ， 它 有 利于 用 
标准 的 C# 代 码 建立 工作 流 模型 。 


说 明 注意 ，WF 所 使 用 的 XAML 方言 与 WPF 使 用 的 XAML 方言 是 不 同 的 。 你 将 在 第 27 章 学 习 WPF 
XAML 的 语法 和 符号 。 与 WF XAML 不 同 ， 编 辑 设计 器 生成 的 WPF XAML 是 很 常见 的 事情 。 


为 了 深入 学 习 工 作 流 ， 我 们 打开 Visual Studio， 在 New Project 对 话 框 中 选择 一 个 Workflow Console 
Application 项 目 ， 并 将 其 命名 为 FirstWorkflowExampleApp ( 如 图 26-1 所 示 )。 
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图 26-1 创建 一 个 基于 控制 台 的 工作 流 应 用 程序 


图 26-2 演 示 了 Visual Studio 生 成 的 初始 的 工作 流 图 表 。 如 你 所 见 , 这 时 设计 器 中 除了 一 个 提醒 你 放 
置 活动 的 信息 外 什么 也 没有 。 





Workflowlxam|l XX 有 
Workflow1 Expand Ai Collapse Ai 





Variables Arguments Imports 草 户 100% ~ 器 同 
图 26-2 ”工作 流 设计 器 是 活动 的 容器 ， 活 动 为 业务 流程 建 模 


在 这 个 简单 的 测试 工作 流 中 ,打开 Visual Studio 的 Toolbox , 找到 Primitives 节 下 的 WriteLine 活 动 ( 如 
图 26-3 所 示 )。 
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Search Toolbox 

bP Control Flow 

bP Flowchart 

》 Messaging 

b State Machine 

》 Runtime 
Pointer 
Assign 
Delay 
InvokeDelegate 
InvokeMethod 
WriteLine N 

b Transaction 

P Collection 


WriteLine 

Version 4.0.0.0 from Microsoft Corporation 
b Error Handling Managed .NET Component 

bP Migration 
4 General 


Writes text to a TedtWriter 





There are no usable controls in this group. Drag an item onto this 
text to add it to the toolbox. 





图 26-3 ”Toolbox 显 示 了 WF 中 所 有 的 默认 活动 


找到 该 活动 之 后 ， 将 其 拖 中 到 设计 器 中 ( 写 着 “Drop activity po 的 区 域 )， 并 在 Text 编 辑 框 中 
输入 用 双 引 号 括 起 的 字符 串 信 息 ， 如 图 26-4 所 示 。 


Workflowl.xaml* 二 Xx ; 六 | 相生 人 





Workflow1 Expand Al Collapse All 


Wi 


| 


Variables ”Arguments imports 草 训 lo0%x vv 电力 





图 26-4 ”WriteLine 活 动 将 向 TextWriter ( 本 例 中 的 控制 台 ) 显示 文本 
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要 知道 WF 远 不 止 一 个 可 以 对 业务 流程 中 的 活动 进行 建 模 的 设计 器 。 在 构建 WF 图 表 时 ， 可 以 使 用 
代码 对 标记 进行 扩展 ， 来 表示 流程 在 运行 时 的 行为 。 事实 上 ， 你 完全 可 以 避 开 XAML， 而 仅仅 使 用 C# 
编写 工作 流 。 但 这 么 做 的 话 ， 就 又 回 到 那个 老 问 题 上 ， 即 拥有 一 堆 非 技术 人 员 看 不 懂 的 代码 体 。 无 论 
如 何 ， 运 行 应 用 程序 ， 将 会 在 控制 台 窗 口 看 到 如 下 所 示 的 消息 : 


HH 


First Workflow! 

Press any key to continue . .. 

非常 好 。 但 是 ,工作 流 如 何 启 动 ? 如 何 确 保 控 制 台 应 用 程序 在 工作 流 完成 之 前 一 直 运 行 ? 要 回答 
这 些 问题 ， 需 要 了 解 工作 流 的 运行 时 引擎 。 


cote 





hap 
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接 下 来 要 了 解 的 是 ，WF API 还 包含 一 个 运行 时 引擎 ， 用 来 加 载 、 执 行 、 印 载 以 及 用 其 他 方式 操作 
定义 好 的 工作 流 。WF 运 行 时 引 敬 可 以 寄宿 在 任何 .NET 应 用 程序 域 中 。 但 要 注意 的 是 ， 一 个 单独 的 应 
用 程序 域 只 能 包含 一 个 正在 运行 的 WF 引擎 实例 。 

第 17 章 已 经 介绍 过 ，AppDomain 是 Windows 进 程 的 分 区 ， 后 者 是 .NET 应 用 程序 和 任何 外 部 代码 库 
的 宿主 。 因 此 ，WF 引 擎 可 以 内 艇 到 简单 的 控制 台 程序 、GUI 桌 面 应 用 ( Windows Forms 或 WPF ), 或 
暴露 于 WCF ( Windows Communication Foundation ) 服务 中 。 





说 明 如 果 你 希望 构建 一 个 在 内 部 使 用 工作 流 的 WCF 服 务 ( 见 第 25 章 )，WCF Workflow Service 
Application 项 目 模 板 是 一 个 不 错 的 起 点 。 





如 果 你 正在 建 模 的 业务 流程 需要 使 用 各 种 各 样 的 系统 ， 你 也 可 以 选择 在 C# Class Library 项 目 
( Workflow Activity Library 项 目 ) 中 编写 WF。 这 样 ， 新 的 应 用 程序 通过 简单 地 引用 *.dll 就 可 以 重用 这 
些 预定 义 的 业务 流程 集合 。 如 果 你 想 避 免 多 次 创建 同样 的 工作 流 ， 这 样 做 显然 很 有 帮助 。 


26.3.1 使 用 WorkflowInvoker 承 载 工 作 流 


WF 运行 时 的 宿主 进程 使 用 一 些 不 同 的 技术 与 运行 时 进行 交互 。 其 中 最 简单 的 方式 是 使 用 
System.Activities 命 名 空间 下 的 WorkflowInvoker 类 。 它 仅 用 一 行 代码 就 可 以 启动 一 个 工作 流 。 打 开 当 
前 Workflow Console Application 项 目的 Program.cs 文 件 ， 可 以 看 到 如 下 的 Main() 方 法 : 

static void Main(string[] args) 

{ 

// 创建 并 缓存 工作 流 定义 


Activity workflow1 = new Workflow1(); 
WorkflowInvoker.Invoke(workflow1); 


当 你 只 想 简单 地 启动 工作 流 而 不 希望 进一步 监控 时 , 使 用 WorkflowInvoker 是 十 分 有 用 的 。Invoke() 
方法 将 以 同步 阻塞 方式 ( synchronous blocking manner ) 执行 工作 流 。 在 整个 工作 流 结束 或 突然 中 断 前 ， 
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调用 线程 都 将 保持 阻塞 状态 。 由 于 Invoke() 方 法 是 同步 调用 ， 这 确保 了 整个 工作 流 在 Main() 终 止 前 能 够 
完成 。 事 实 上 ， 在 WorkflowInvoker.Invoke() 方 法 之 后 添加 的 任何 代码 ， 都 将 在 工作 流 完成 (或 更 糟 
的 情况 ， 突 然 中 断 ) 之 后 才能 执行 : 


static void Main(string[] args) 


{ 
// 创建 并 缓存 工作 流 定 义 
Activity workflow1 = new Workflow1(); 
WorkflowInvoker.Invoke(workflow1); 


Console.WriteLine("Thanks for playing"); 


1. 使 用 WorkflowInvoker 向 工作 流传 递 参 数 

当 宿 主 进 程 开启 一 个 工作 流 时 ,传递 一 些 自 定义 启动 参数 是 很 常见 的 情况 。 例 如 ， 假 设 你 希望 程 
序 的 用 户 指 定 显示 在 WriteLine 活 动 中 的 消息 , 而 不 是 像 现 在 这 样 将 文本 消息 硬 编码 到 活动 中 。 在 普通 
的 C# 代 码 中 ,你 需要 创建 一 个 自 定义 的 构造 函数 来 接收 这 样 的 参数 。 但 是 , 工作 流 只 能 用 默认 的 构造 
函数 创建 ! 此 外 ， 大 多 数 工 作 流 只 使 用 XAML 定 义 ， 而 不 是 程序 代码 。 

事实 上 ，Invoke() 方 法 有 很 多 重 载 ， 其 中 一 个 允许 你 向 工作 流传 递 启 动 参数 。 这 些 参 数 保存 在 一 
个 Dictionary<string，object> 变 量 中 ， 它 包含 的 名 称 / 值 对 可 用 来 设置 工作 流 中 同名 ( 同类 型 ) 的 参 
数 变 量 。 

2. 使 用 工作 流 设计 器 定义 参数 

可 以 使 用 工作 流 设计 器 来 定义 参数 并 获取 字典 数据 。 在 Solution Explorer 中 ， 右 击 Workflow1.xaml 
选择 View Designer。 注 意 在 设计 器 底部 有 一 个 名 为 Arguments 的 按钮 。 单 击 该 按钮 ， 在 弹出 的 UI 中 ， 
添加 一 个 string 类 型 的 输入 参数 MessageToShow ( 不 需要 为 该 参数 指定 默认 值 )。 同 样 ， 通 过 在 Visual 
Studio 的 Properties 窗 口中 重 置 WriteLine 活 动 的 Text 属 性 ， 来 删除 WriteLine 活 动 中 的 初始 消息 。 图 26-5 
显示 了 最 终 的 结果 。 


Workflowl .xamF” 厂 Xx 3 5 和 汪 之 洒 
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芯 WwWntetine 


Tedt Entero C¥ expression 


| Name Direction Argument type Defaug value 
MessageToShow In String Enter o C# expression 
Crecte Argument 
Variables Arguments Imports 草 月 100% ~ 中 图 


图 26-5 工作 流 参数 可 用 来 接收 宿主 提供 的 参数 
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现在 , 在 WriteLine 活 动 的 Text 属 性 中 , 可 以 输入 MessageToShow 作 为 赋值 表达 式 。 当 你 输入 这 些 字 
符 时 ， 可 以 看 到 智能 感知 ( 如 图 26-6 所 示 )。 
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图 26-6 ”使 用 自 定义 参数 作为 活动 的 输入 


现在 已 经 有 了 正确 的 基础 设施 ， 考 虑 下 面 对 Program 类 的 Main() 方 法 所 做 的 修改 。 注 意 你 需要 在 
Program.cs 文 件 中 引入 System.Collections.Generic 命 名 空间 ， 来 声明 Dictionary<> 变 量 。 


static void Main(string[] args) 


{ 


Console.WritelLine("***** Welcome to this amazing WF application *****"); 


// 获取 用 户 输入 的 数据 ， 传 递 给 工作 流 
Console.Write("Please enter the data to pass the workflow: "); 
string wfData = Console.ReadLine(); 


// 将 数据 看 入 字典 中 
Dictionary<string, object> wfArgs = new Dictionary<string,object>(); 
wfArgs.Add("MessageToShow", wfData); 


// 传递 给 工作 流 
Activity workflow1 = new Workflow1(); 
WorkflowInvoker.Invoke(workflow1, wfArgs); 


Console.WritelLine("Thanks for playing"); 


} 
再 次 强调 ，Dictionary<> 变 量 中 每 个 成 员 的 字符 串 值 必须 与 工作 流 中 相应 的 参数 变量 名 一 致 。 运 
行 修改 后 的 程序 ， 输 出 结果 如 下 所 示 : 





****** Welcome to this amazing WF application ***** 

Please enter the data to pass the workflow: Hello Mr. Workflow! 
Hello Mr. Workflow! 

Thanks for playing 

Press any key to continue ... 
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除了 Invoke() 方 法 ，WorkflowInvoker 中 其 他 有 趣 的 成 员 是 BeginInvoke() 和 EndInvoke()， 它 们 使 
用 .NET 异 步 委 托 模式 ( 如 第 19 章 所 示 ) 在 另 一 个 线程 中 启动 工作 流 。 如 果 你 希望 对 WF 运行 时 操作 工 
作 流 有 更 多 地 控制 ， 可 以 使 用 WorkflowApplication 类 。 


26.3.2 ”使 用 wdrkflowApplication 承 载 工作 流 


如 果 要 保存 或 加 载 一 个 使 用 WF 持久 化 服务 长 期 运行 的 工作 流 ， 可 以 使 用 WorkflowApplication。 
它 具 有 接收 工作 流 实例 生命 周期 中 触发 的 各 种 事件 的 通知 、WF“ 书 签 ”等 其 他 高 级 特性 。 在 这 种 情 
况 下 ， 需 要 调用 WorKflowApplication 的 Run() 方 法 。 

调用 Run() 方 法 时 , 将 从 CLR 线 程 池 中 取出 一 个 后 台 线 程 。 因此 ， 如果 你 不 添加 额外 的 支持 来 保证 
主线 程 等 待 辅 助 线程 执行 完毕 的 话 ， 那 么 工作 流 实例 可 能 没有 机 会 完成 其 工作 。 

要 想 让 调用 线程 等 待 足够 长 的 时 间 以 使 后 台 线 程 能 够 完成 其 工作 ， 一 种 方法 是 使 用 
System.Threading 命 名 空间 下 的 AutoResetEvent 对 象 。 以 下 是 修改 后 的 示例 ， 使 用 MorkflowApplication 
替代 了 WorkflowInvoker: 

static void Main(string[] args) 


Console.WritelLine("***** Welcome to this amazing WF application *****"); 


// 获取 用 户 输入 的 数据 ， 传 递 给 工作 流 
Console.Write("Please enter the data to pass the workflow: "); 
string wfData = Console.ReadLine(); 


// 将 数据 存 入 字典 中 

Dictionary<string, object> wfArgs = new Dictionary<string,object>(); 
wfArgs.Add("MessageToShow", wfData); 

// 通知 主线 程 进行 等 待 


AutoResetEvent waitHandle = new AutoResetEvent(false); 


// 传递 给 工作 流 
WorkflowApplication app = new WorkflowApplication(new Workflow1(), wfArgs); 


// 将 事件 与 app 挂 钓 。 当 工作 流 结束 时 ， 通 知 其 他 线程 ， 并 打印 一 条 信息 
app.Completed = (completedArgs) => { 

waitHandle. Set(); 

Console.WritelLine("The workflow is done!"); 


» 


// 开启 工作 流 
app.Run(); 


// 在 工作 流 结 束 之 前 一 直 等 待 
waitHandle.WaitOne(); 


Console.WriteLine("Thanks for playing"); 
} 


输出 结果 与 上 例 类 似 : 





入 中 沸 安 We to th amazing WF ee 人 
Please enter the data to pass the workflow: Hey again! 
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Hey againl! 

The workflow is donel 

Thanks for playing 

Press any key to continue . . ， 





使 用 MorkflowApplication 的 好 处 是 ， 可 以 将 工作 流 与 事件 挂钩 (如 在 本 例 中 间接 使 用 Completed 
属性 )， 并 且 可 以 使 用 更 复杂 的 服务 (如 持久 化 、 书 签 等 )。 


说 明 ”在 我 们 介绍 WF 的 时 候 , 不 会 深入 这 些 运行 时 服务 的 细节 。 如 果 对 Windows Workflow Foundation 
运行 时 环境 下 的 这 些 运 行 时 行为 和 服务 感 兴趣 ， 可 以 参阅 .NET Framework 4.5 SDK 文 档 。 


26.3.3 ”第 一 个 工作 流 示例 回顾 


尽管 这 个 示例 有 点 简单 ， 但 你 确实 学 到 了 一 些 有 趣 ( 且 有 用 ) 的 任务 。 首 先 ， 我 们 介绍 了 可 以 向 
工作 流传 递 一 个 Dictionary 对 象 ， 它 包含 的 名 称 / 值 对 将 传递 给 工作 流 中 具有 相同 名 称 的 参数 。 当 你 需 
要 获得 用 来 处 理 活动 的 用 户 输入 时 ( 如 客户 的 ID 号 、SSN、 私 人 医生 的 名 字 等 )， 这 种 方法 相当 有 用 。 

我 们 还 介绍 了 .NET 工作 流 是 使 用 XAML ( 基于 XML 的 语法 ) 以 一 种 声明 式 的 方式 来 定义 的 。 使 
用 XAML, 可 以 指定 工作 流 包 含 哪些 活动 。 在 运行 时 , 这 些 数据 用 来 创建 正确 的 在 内 存 中 的 对 象 模型 。 
最 后 ， 我 们 介绍 了 使 用 WorkflowInvoker 和 WorkflowApplication 这 两 种 不 同 的 方法 来 启动 工作 流 。 


源 代码 ”FirstWorkflowExampleApp 项 目的 源 代码 位 于 Chapter 26 子 目录 下 。 


26.4 检查 Workflow 中 的 活动 


WF 的 目的 是 以 声明 的 方式 对 业务 流程 建 模 ， 并 由 WF 运行 时 引擎 执行 。 在 WF 的 世界 里 ， 业 务 流 
程 是 由 多 个 活动 组 成 的 。 简 单 地 说 ， 在 整个 流程 中 ， 一 个 WF 活动 就 是 一 个 原子 的 “步骤 ”。 当 你 创建 
一 个 工作 流 应 用 程序 时 ， 你 会 发 现 Toolbox 中 内 骨 了 很 多 按 种 类 划分 的 活动 ， 它 们 以 图 标的 形式 表示 。 

这 些 随手 可 用 的 活动 可 用 来 对 业务 流程 建 模 。Toolbox 中 的 每 个 活动 都 对 应 System.Activities.dll 程 
序 集中 一 个 实际 的 类 ( 大 多 数 都 位 于 System.Activities.Statements 命 名 空间 下 )。 你 将 在 本 章 的 教程 
中 使 用 一 些 内 艇 的 活动 。 我 们 也 将 在 此 对 大 多 数 默 认 的 活动 进行 概述 。 和 往常 一 样 ， 详 细 的 内 容 请 参 
考 .NET Framework SDK 文 档 。 


26.4.1 控制 流 活动 


工具 箱 中 的 第 一 种 活动 允许 你 在 较 大 的 工作 流 中 表示 循环 和 判定 。 它 们 的 用 途 应 该 很 容易 理解 ， 
因为 我 们 每 天 都 用 Cf#f 代 码 做 着 同样 的 事情 。 在 表 26-1 中 ,注意 某 些 控制 流 活动 在 后 台 使 用 了 Task Parallel 
Library ( 任务 并 行 库 ， 参 见 第 19 章 )， 人 允许 并 行 地 处 理 活 动 。 


862 第 26 章 Windows Workflow Foundation 简介 


表 26-1 WF 中 的 控制 流 活动 





活 动 含 尺 
Dowile 一 个 循环 活动 ， 该 活动 至 少 执行 内 含 的 活动 一 次 ， 直 到 条 件 不 为 true 
ForEach<T> 将 ForEach<T>.Values 集 合 中 的 各 个 活动 分 别 执行 一 次 
If 建立 一 个 If-Then-Else 条 件 模型 
Parallel 以 异步 的 方式 同时 执行 的 所 有 子 活动 的 活动 
parallelForEach<T> 枚 举 集合 中 的 元 素 ， 并 以 并 行 的 方式 执行 各 个 元 素 
Pick 提供 基于 事件 的 控制 流 建 模 
pickBranch 父 Pick 活 动 内 可 能 的 执行 路 径 
Sequence 执行 一 组 子 活动 序列 
Switch<T> 基于 给 定 表 达 式 ( 其 类 型 在 此 对 象 的 类 型 参数 中 指定 ) 的 值 ， 从 多 个 活动 中 选择 一 个 执行 
While 在 条 件 的 值 为 true 时 执行 包含 的 工作 流 元 素 


26.4.2 ”流程 图 活动 


接 下 来 介绍 的 是 流程 图 活动 ， 这 实际 上 是 非常 重要 的 ， 因 为 它 常常 是 我 们 放置 到 WF 设计 器 上 的 
第 一 个 项 。 这 种 类 型 的 工作 流 允 许 你 使 用 众所周知 的 流程 图 模型 来 构建 工作 流 。 工 作 流 的 执行 基于 许 
多 分 支 路 径 , 选择 哪 条 分 支 路 径 取决 于 一 些 内 部 条 件 的 真 或 假 。 表 26-2 列 出 了 该 活动 集合 的 所 有 成 员 。 


表 26-2 WF 中 的 流程 图 活动 





活 动 含 义 

Flowchart 使 用 熟悉 的 流程 图 范例 建立 工作 流 的 模型 。 它 常常 是 放 到 设计 器 中 的 第 一 个 活动 
FlowDecision 一 个 节点 ， 提 供 建立 有 两 种 结果 的 条 件 节点 模型 的 能 力 

FlowSwitch<T> 一 个 节点 ， 可 建立 开关 结构 的 模型 ， 该 结构 有 一 个 表达 式 并 且 每 个 匹配 项 都 有 一 个 结果 


26.4.3 消息 传递 活动 


工作 流 可 以 使 用 消息 传递 活动 轻松 地 调用 外 部 XML Web 服 务 或 WCF 服 务 的 成 员 ， 并 且 也 可 以 接 
收 外 部 服务 的 通知 。 由 于 这 些 活动 与 WCF 开 发 息息相关 ， 因 此 存放 于 专门 的 程序 集 System. 
ServiceModel.Activities.dll 中 。 该 库 中 的 核心 活动 如 表 26-3 所 示 。 


表 26-3 WF 中 常见 的 消息 传递 活动 


活 动 含义 
CorrelationScope 管理 子 消息 传递 活动 
InitializeCorrelation 初始 化 关联 ( correlation ) 而 不 发 送 或 接受 消息 
Receive 从 WCF 服 务 接收 消息 
Send 将 消息 发 送 到 WCF 服 务 
SendAndReceiveRelply 将 消息 发 送 到 WCF 服 务 并 获取 返回 值 


TransactedReceiveScope 允许 你 将 事务 流入 工作 流 或 调度 创建 的 服务 器 事务 


26.4 检查 Workflow 中 的 活动 863 
最 常见 的 消息 传递 活动 是 send 和 Receive， 可 以 用 来 与 外 部 XML Web 服 务 和 WCF 服 务 进行 通信 。 


26.4.4 ”状态 机 活动 


在 .NET 4.5 下 ，WF API 得 到 了 更 新 ， 新 增 了 一 些 可 以 对 基于 状态 机 的 工作 流 建 模 的 活动 。 简 单 来 
说 ,状态 机 允许 我 们 定义 一 种 工作 流 ， 这 种 工作 流 可 以 在 某 个 给 定 的 时 间 点 定义 任意 数量 的 状态 ,并 
且 这 些 状态 之 间 可 以 有 效 地 转换 。 

关于 状态 机 一 个 众所周知 的 例子 是 汽水 自动 售 货 机 。 在 任意 给 定 的 时 间 点 ， 该 “机 器 ”都 处 于 一 
种 状态 ， 如 “等 待 付款 ”"“ 配 制 汽水 “退还 付款 ”"“ 找 零 ” “所 选 售 空 ”等 。 这 些 状态 之 间 可 以 有 
效 地 转换 。 例 如 ， 如 果 售 货机 处 于 “所 选 售 空 ”状态 ， 那 么 可 以 有 效 地 转换 为 “退还 付款 ”或 “配制 
汽水 ”( 假设 用 户 选择 了 另 一 种 汽水 )。 要 构建 这 样 一 个 工作 流 ，.NET4.5 引 入 了 StateMachine、State 
和 FinalState 活 动 。 


26.4.5 ”运行 时 活动 与 基 元 活动 
工具 箱 中 下 面 的 两 种 活动 是 运行 时 活动 和 基 元 活动 。 运 行 时 活动 可 用 来 构建 调用 了 工作 流 运行 时 
(如 Persist 和 TerminateWorkflow ) 的 工作 流 ， 基 元 活动 可 用 来 构建 执行 常用 操作 ( 如 向 输出 流 推送 文 
本 ， 或 调用 .NET 对 象 中 的 方法 ) 的 工作 流 ， 表 26-4 展 示 了 该 类 别 中 常见 的 活动 。 
表 26-4 WF 的 运行 时 活动 和 基 元 活动 
活 动 全 义 
Persist 使 用 WF 持久 化 服务 将 工作 流 实例 的 状态 保存 到 数据 库 中 的 请 求 


TerminateWorkflow 终止 正在 运行 的 工作 流 实例 ， 在 宿主 中 和 触发 NorkflowApplication.Completed 事 件 ， 并 报告 错 
误 信息 。 工 作 流 终止 后 将 无 法 恢复 





Assign 使 用 工作 流 设 计 器 中 定义 的 值 来 设置 活动 的 属性 

Delay 在 一 个 固定 的 时 间 点 强制 停止 一 个 工作 流 

InvokeMethod 调用 指定 对 象 或 类 型 的 方法 

WriteLine 将 指定 的 字符 串 写 人 指定 的 TextWriter 派 生 类 型 。 默 认为 标准 输出 流 ( 即 控制 台 )， 但 也 可 


以 配置 为 其 他 流 ， 如 Filestream 


InvokeMethod 也 许 是 这 些 活 动 中 最 有 趣 也 最 有 用 的 一 个 ， 因 为 它 支 持 以 声明 的 方式 调用 .NET 类 中 
的 方法 。 你 还 可 以 配置 InvokeMethod 来 保存 所 调用 方法 的 返回 值 。 当 你 想 终止 一 个 工作 流 时 ， 
TerminateWorkflow 也 是 很 有 帮助 的 。 如 果 工 作 流 实例 命中 该 活动 , 将 触发 Completed 事 件 , 宿主 程序 将 
捕 提 到 该 事件 ， 就 如 同 我 们 在 前 面 的 示例 中 所 做 的 那样 。 


26.4.6 ”事务 活动 


在 构建 工作 流 时 , 你 也 许 会 希望 让 一 组 活动 按 原 子 的 方式 来 工作 , 即 作为 一 个 集体 , 要 么 都 成 功 ， 
要 么 都 失败 。 尽 管 这 些 活动 不 直接 操作 关系 型 数据 库 ， 但 核心 活动 允许 你 向 工作 流 中 添加 事务 范围 ， 
如 表 26-5 所 示 。 
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表 26-5 ”WF 的 事务 活动 


活动 含义 
CancellationScope 将 取消 逻辑 与 执行 的 主 路 径 相 关联 
CompensableActivity 支持 对 子 活动 进行 补偿 的 活动 
TransactionScope 划分 事务 边界 的 活动 


26.4.7 ”集合 活动 和 错误 处 理 活动 


本 章 介 绍 的 最 后 两 类 活动 可 以 操作 泛 型 集合 和 响应 运行 时 异常 。 当 你 需要 在 XAML 中 操作 表示 业 
务 数据 ( 如 采购 订单 、 医 疗 信息 对 象 或 订单 跟踪 ) 的 对 象 时 ， 可 以 使 用 强大 的 集合 活动 。 而 错误 活动 
支持 在 工作 流 中 添加 try/catch/ythrow 逻 辑 。 表 26-6 列 出 了 这 些 活 动 。 


表 26-6 ”WF 的 集合 活动 和 错误 处 理 活动 


活 动 含 义 
AddToCollection<T> 向 指定 的 集合 中 添加 项 
ClearCollection<T> 清除 指定 集合 中 的 所 有 项 
ExistsInCollection<T> 指示 给 定 项 是 否 存 在 于 给 定 集合 中 
RemoveFromCollection<T> 从 指定 的 集合 中 移 除 项 
Rethrow 从 Catch 活 动 内 抛 出 一 个 以 前 抛 出 过 的 异常 
Throw 抛 出 异常 
TryCatch 包含 由 工作 流 运行 时 在 异常 处 理 块 中 执行 的 工作 流 元 素 


好 了 , 我 们 已 经 介绍 了 很 多 默认 的 活动 ， 可 以 使 用 它们 来 构建 一 些 有 趣 的 工作 流 了 。 接 下 来 我 们 
将 学 习 两 个 关键 的 活动 Flowchart 和 Sequence， 它 们 通常 被 认为 是 工作 流 的 根本 。 


26.5 ”构建 流程 图 工作 流 


在 第 一 个 示例 中 ,我 们 将 一 个 简单 的 WriteLine 活 动 直 接 拖 忠 到 工作 流 设计 器 上 。 尽 管 Visual Studio 
工具 箱 中 的 任何 活动 都 可 以 作为 第 一 项 放置 到 设计 器 中 , 但 只 有 一 小 部 分 可 以 包含 子 活动 ( 表示 一 组 
相关 活动 的 集合 )。 在 构建 新 的 工作 流 时 ， 第 一 个 放置 到 设计 器 中 的 项 常常 是 Flowchart 或 sequence 
活动 。 

这 两 个 内 艇 的 活动 都 可 以 包含 任意 数量 的 内 部 子 活 动 ( 可 以 为 其 他 的 Flowchart 或 sequence 活动 )， 
来 表示 整个 业务 流程 。 我 们 创建 一 个 全 新 的 Workflow Console Application 命 名 为 EnumerateMachine- 
DataWF， 并 将 初始 的 *.xaml 文 件 改名 为 MachineInfoWF.xaml。 

现在 , 从 Toolbox 中 的 Flowchart 节 下 , 将 一 个 Flowchart 活 动 拖 电 到 设计 器 中 。 接 下 来 , 在 Properties 
窗口 中 将 DisplayName 属 性 更 改 为 更 容易 记 住 的 名 字 ， 如 Show Machine Data Flowchart ( 我 敢 肯 定 你 在 
猜想 DisplayName 属 性 控制 了 该 项 在 设计 器 中 的 命名 )。 这 时 ， 工 作 流 设计 器 将 如 图 26-7 所 示 。 
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MachineinfoWFxami 卫 ’X ， 0 a 
Workflowi Expand AH Collapse Al 


|Vaables Arguments Imports 避 万 100% ~ 吕 图 
图 26-7 “初始 的 Flowchart 活 动 


注意 , 在 Flowchart 活 动 的 右 下 角 有 一 个 缩放 处 理 的 图 标 , 可 以 用 来 增 大 或 缩小 流程 图 设计 器 空间 
的 尺寸 。 随 着 活动 的 增多 ， 你 将 需要 扩大 这 个 尺寸 。 


26.5.1 在 流程 图 中 连接 活动 


Start 图 标 表示 该 流程 图 活动 的 入口 点 ， 在 本 例 中 它 是 我 们 放置 的 整个 工作 流 中 的 第 一 个 活动 ， 并 
且 将 在 使 用 MorkflowInvokez 或 WorkflowApplication 类 执行 工作 流 时 被 触发 。 你 可 以 将 这 个 图 标 拖 动 到 
设计 器 中 的 任何 位 置 ， 我 建议 将 它 移动 到 左上 角 ， 以 便 留 出 更 多 的 空间 。 

我 们 的 目标 是 通过 连接 多 个 活动 将 它们 组 装 在 一 起 ， 在 流程 中 要 用 到 FlowDecision 活 动 。 我 们 将 
WriteLine 活 动 拖 上 忠 到 设计 器 中 ， 将 DisplayName 改 为 Greet User。 现 在 ， 如 果 你 将 鼠标 悬 停 在 Start 图 标 
上 , 会 发 现 四 个 方向 上 都 出 现 了 对 接 标记 。 单 击 并 按 住 对 接 标记 ， 然 后 拖 动 到 MriteLine 活 动 ， 这 样 会 
在 这 两 项 中 出 现 一 条 连接 线 ， 这 意味 着 工作 流 执行 的 第 一 个 活动 是 Greet User。 

现在 ， 与 本 章 第 一 个 示例 相同 ， 我 们 添加 一 个 名 为 UserName 的 无 默认 值 的 字符 串 类 型 的 工作 流 参 
数 (使 用 Argument 按 钮 )。 该 参数 将 通过 自 定义 的 Dictionary<> 对 象 动态 地 传人 。 最 后 ， 将 WriteLine 
活动 的 Text 属 性 设置 为 如 下 的 代码 语句 : 

"Hello" + UserName 

在 设计 器 中 再 添加 一 个 WriteLine 活 动 ， 并 连接 到 前 一 个 。 在 Text 属 性 中 硬 编码 字符 串 值 "Do you 
want me to list all machine drives?"， 并 将 DisplayName 属 性 改 为 Ask User。 图 26-8 显 示 了 当前 工作 
流 活动 的 连接 情况 。 
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© 节 Greet User 


Tedt Entero C#* expression 
Start 


医 Ask User 


Text “Do you want meto list all me 


图 26-8 ”流程 图 工作 流 将 活动 连接 到 一 起 


26.5.2 ”使 用 InvokeMethod 活 动 


由 于 大 多 数 工 作 流 都 使 用 XAML 以 声明 方式 定义 ， 因 此 我 们 可 以 很 好 地 使 用 InvokeMethod 活 动 ， 
在 工作 流 中 不 同 的 位 置 调用 真实 对 象 的 方法 。 将 该 活动 拖 中 到 设计 器 中 , 将 DisplayName 属 性 改 为 Get Y 
or N， 并 与 Ask User NMrilteLine 活 动 进行 连接 。 

InvokeMethod 活 动 要 配置 的 第 一 个 属性 为 TargetType, 它 表 示 类 的 名 称 , 我 们 要 调用 的 静态 成 员 就 
定义 在 该 类 中 。 使 用 InvokeMethod 活 动 中 TargetType 的 下 拉 列 表 框 ， 选 择 Browse for Types... 选 项 (如 


图 26-9 所 示 )。 
© 蓉 Greet User 


Text Entero C3 expressic 
Start 
芝 Ask User 
Tedt “Do you want meto list all me 


得 
部 GetYorN Er 









TargetType 
| fnulD 
TargetObject Boolean 
|Int32 
String 
Object 


MethodName 





图 26-9 ”指定 InvokeMethod 的 目标 类 型 


在 弹出 的 对 话 框 中 , 选择 mscorlib.dll 中 的 System.Console 类 ( 在 Type Name 编 辑 域 中 输入 类 型 名 称 ， 
对 话 框 将 自动 找到 该 类 型 )，。 找 到 System.Console 类 之 后 ， 单 击 OK 按 钮 。 

现在 , 使 用 设计 器 中 的 InvokeMethod 活 动 , 将 MethodName 属 性 设置 为 ReadLine。 在 工作 流 执行 到 这 
一 步 时 ，InvokeMethod 活 动 将 调用 Console.ReadLine() 方 法 。 
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我 们 知道 ，Console.ReadLine() 将 返回 回 车 键 按 下 之 前 通过 键盘 输入 的 字符 串 ， 我 们 需要 一 种 方 
法 来 得 到 这 个 返回 值 。 接 下 来 就 将 介绍 这 个 方法 。 


26.5.3 ”定义 工作 流 变量 


在 XAML 中 定义 变量 与 定义 参数 没什么 区 别 ， 因 此 可 以 直接 在 设计 器 中 进行 定义 (使 用 Variables 按 
钮 ), 所 不 同 的 是 , 参数 用 来 获取 宿主 程序 中 传人 的 数据 , 而 变量 只 是 工作 流 中 影响 运行 时 行为 的 数据 点 。 

单 击 设计 器 中 的 Variables 按 钮 ， 添 加 一 个 名 为 YesOrNo 的 string 变 量 。 注 意 ， 如 果 工 作 流 中 包含 多 
个 父 容器 ( 例如， 一 个 Flowchart 包 含 另 一 个 sequence )， 可 以 选择 变量 的 作用 域 。 在 此 ， 我 们 只 选择 
Flowchart 根 ( 如 图 26-10 所 示 )。 


MachinejnfoWF>xamP 1 Xx i 


Workfiowi Expand Al Collapse Al 
二 Show Machine Data Flowchart . 


大 Greet User 时 
> | 
T a py 对 


wat fntero Cs epression 
Start 


各 Ask User 


Text “Do you want meto jist all me 


Name Variable type Scope Defauit 
YesOrNo String Show Machine Data_ Enter o C# expression 
a Arguments mports 入 用 i00% 、 车 


图 26-10 ”定义 工作 流 变量 


接 下 来 , 在 工作 流 设 计 器 中 选择 InvokeMethod 活 动 , 使 用 Visual Studio 中 的 Properties 窗 口 , 将 Result 
属性 设置 为 刚刚 定义 的 变量 (如 图 26-11 所 示 )。 





DisplayName GetYorN 


GenericTypeArguments (Collection) 国 
MethodName ReadLine 
Parameters {Coliection) 圈 
Result YesOrNo| 图 
RunAsynchronously 加 

TargetObject Enter a C$ expre 图 
TargetType ISystem,Console . ™ 


图 26-11 InvokeMethod 的 完整 配置 
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既然 我 们 可 以 通过 调用 外 部 方法 获取 数据 ， 那 么 我 们 就 可 以 在 流程 图 中 使 用 FlowDecision 活 动 来 
做 运行 时 决策 。 


26.5.4 ”使 用 FlowDecision 活 动 


FlowDesicion 活 动用 来 提供 两 种 可 能 的 行为 ， 它 基于 布尔 变量 或 返回 布尔 值 的 语句 的 真 假 ， 来 决 
定 执 行 哪个 行为 。 将 该 活动 拖 蝶 到 设计 器 ， 与 InvokeMethod 活 动 相连 接 ( 如 图 26-12 所 示 )。 


区 Greet User 
© 到 
Teoxtt Ernier o CH expressio 


节 Ask User 


乾 


Text “Do you want me to list al me 


可 GetYorN 

TargetType [System.Console | 
TargetObject Entera C# expression 人 
MethodName ReadLine True False 


Decision 


图 26-12 ”FlowDecision 可 以 产生 两 个 方向 的 分 支 





说 明 如果 你 需要 在 流程 图 中 响应 多 个 分 支 条 件 ， 可 以 使 用 FlowSwitch<T> 活 动 。 它 支持 定义 多 个 路 
径 ， 根 据 定义 的 工作 流 变 量 的 值 来 决定 选择 哪 条 路 径 。 





用 下 面 的 代码 语句 来 设置 FlowDecision 活 动 的 Condition 属 性 ( 使 用 Properties 窗 口 )， 你 可 以 直接 
在 编辑 器 中 输入 这 些 代 码 ( 这 里 ,我 们 检查 Yes0rNo 变 量 的 大 写 形式 是 否 为 "Y" ): 


YesOrNo.ToUpper() == "Y" 


26.5.5 ”使 用 TerminateWorkflow 活 动 


现在 我 们 需要 构建 FlowDecision 活 动 两 端 将 发 生 的 活动 。 在 “false” 端 , 连接 一 个 WriteLine 活 动 ， 
输出 所 选择 的 硬 编码 消息 ， 紧 接着 是 一 个 TerminateWorkflow 活 动 ( 如 图 26-13 所 示 )。 
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© 苹 Greet User 


Tect Entergt 
Start 


其 Ask User 


冤 


© False 


Text “Do you want me to list all me 


六 GetYorN Decision 区 writeLine 

TargetType [SystemConsole Texdt "Too bad. All done" 
TargetObject Entera CY exesser 

MethodName ReadLine 人 TominatWiorow 大 


图 26-13 “false” 分 支 


严格 地 说 ， 没 有 必要 使 用 TerminateWorkflow 活 动 ， 因 为 当 工 作 流 到 达 false 分 支 的 末端 时 将 会 简单 
地 结束 。 但 是 , 使 用 该 活动 类 型 可 以 向 工作 流 宿主 抛 出 一 个 异常 , 通知 终止 的 原因 。 你 可 以 在 Properties 
窗口 中 配置 该 异常 。 

假设 在 设计 器 中 选择 了 TerminateWorkflow 活 动 ， 在 Properties 窗 口中 单 击 Exception 属 性 的 椭圆 形 
按钮 。 这 将 打开 一 个 编辑 器 ， 可 以 像 在 代码 中 那样 来 抛 出 异常 〈 如 图 26-14 所 示 )。 








Expression Edit 





Exception {Exception} 


Exceptionf "User said no")j| 








最 后 ， 将 该 活动 的 Reason 属 性 设置 为 “Yes Or No was flase”。 


26.5.6 ”构建 “true” 条 件 


要 构建 FlowDecision 的 “true” 条 件 ， 先 连接 一 个 WriteLine 活 动 ， 显 示 硬 编码 字符 串 ， 表 示 用 户 同 
意 继续 执行 。 然 后 , 连接 一 个 新 的 InvokeMethod 活 动 , 调用 System.Environment 类 的 GetLogicalDrives() 
方法 。 将 TargetType 属 性 设置 为 System.Environment ，MethodName 属 性 设置 为 GetLogicalDrives ( 如 图 
26-15 所 示 )。 
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TargetType [System.Environmt | 
TargetObject Entera C#expression 


MethodName GetLogicalDrives 


图 26-15 ”配置 InvokeMethod 活 动 


接 下 来 ， 添 加 一 个 工作 流 级 别 的 变量 (使 用 工作 流 设计 器 中 的 Variables 按 钮 ) DriveNames ， 其 类 
型 为 string[]。 要 指定 string 数 组 ， 需 要 在 Variable Type 的 下 拉 列 表 中 选择 Array of [T]， 然 后 在 弹出 的 
对 话 框 中 选择 String。 最 后 , 在 设计 器 上 选中 InvokeMethod 活 动 , 在 Properties 窗 口中 将 该 InvokeMethod 
活动 的 Result 属 性 设置 为 DriveNames 变 量 。 


26.5.7 ”使 用 ForEachxT> 活 动 


工作 流 接 下 来 的 部 分 就 是 要 在 控制 台 窗 口 打印 每 个 驱动 器 的 名 称 ， 这 意味 着 我 们 需要 循环 
DriveNames 变 量 ( string 数 组 对 象 ) 中 的 数据 。WF 中 的 ForEach<T> 活 动 等 价 于 C# 中 的 foreach 关 键 字 ， 
它们 的 配置 方式 也 十 分 类 似 ( 至 少 在 概念 上 是 这 样 )。 

将 一 个 ForEach<T> 活 动 拖 电 到 设计 器 中 ， 并 与 之 前 的 InvokeMethod 活 动 相连 接 。 稍 后 我 们 再 配置 
ForEach<T> 活 动 。 此 时 我 们 先 完成 tue 条 件 分 支 ， 将 最 后 一 个 WriteLine 活 动 放 到 设计 器 上 。 此 时 流程 
图 的 整体 结构 如 图 26-16 所 示 。 


司 As User 


Tea “De you want meto hist all me 


本 GetYorN 项 Wrteline 
TargetType System.Console ~ Tet Too bad Al done” 


TargetObject Entero Cam 


+ 
MethodName ReadLine © TeminateWorkfiow 


套 Writeline 


Ter “Wonderfukl 


相 InvokeMethod 
TargutType Spider 
TargetObject Eniero C= epe 


MethodName GatLogicalDrives 





图 26-16 ”完整 的 工作 流 
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为 了 避免 当前 设计 器 中 的 错误 ,需要 完成 ForEach<T> 活 动 的 配置 。 首 先 ， 使 用 Properties 窗 口 泛 型 
的 类 型 实 参 指定 为 string 类 型 。Values 属 性 表示 数据 的 来 源 ， 这 里 应 为 DriveNames 变 量 ( 如 图 26-17 
所 示 )。 


ForEach<String> 


Values DriveNames| 图 





图 26-17 设置 ForEach 枚 举 的 类 型 


这 个 特殊 的 活动 需要 进一步 的 编辑 , 在 设计 器 中 双击 该 活动 , 打开 一 个 该 活动 专用 的 迷你 设计 器 。 
并 非 所 有 的 WF 活动 都 可 以 双击 ， 但 活动 本 身 会 告诉 你 是 否 可 以 这 么 做 ( 显示 “Double-click to view” 
的 字样 )。 双 击 ForEach<String> 活 动 ， 添 加 一 个 WriteLine 活 动 ， 用 来 打印 DriveNames 返 回 值 中 每 个 
string 的 值 ( 如 图 26-18 所 示 )。 四 


司 ForEach< String> 
| Foreach item in DriveNames 


| Body 


| 
蕊 WriteLine 


Text item 


图 26-18 ”ForEach<string> 活 动 的 最 终 配置 


说 明 ”可 以 在 ForEach<T> 的 迷你 设计 器 中 添加 任意 多 个 活动 。 这 些 活动 将 在 循环 的 每 次 迭代 中 执行 。 


配置 好 ForEach<T> 的 “ 子 活动 ”之 后 ， 可 以 使 用 工作 流 设计 器 左上 角 的 链接 返回 到 工作 流 的 最 顶 
端 (在 你 深入 一 组 活动 中 时 ， 将 会 经 常 使 用 这 些 链 接 ; 请 看 图 26-19 中 的 鼠标 位 置 )。 
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MachineInfoWF.xamt* X 


Workflowi Show si Data.. ”ForEach<string> Expand Al Collapse Al 


如 ForEach<String> 





Foreach item in DrveNames 
Body 
天 WriteLine 
Text item 
Name Variable type Scope Default 
YesOrNo String Show Machin Entera C#expression ~ 
Variables Argurnents Imports 车 A 1005% = 瑟 中 


图 26-19 通过 工作 流 设 计 器 中 的 “链接 ”可 以 返回 活动 的 顶端 


26.5.8 完成 应 用 程序 


示例 就 要 完成 了 。 你 还 需要 做 的 是 更 新 Program 类 的 Main() 方 法 ， 捕 获 用 户 输 入 “NO” 时 触发 的 
异常 ( 触发 Exception 对 象 ), 按 如 下 的 代码 进行 更 新 ( 确保 代码 文件 引入 了 System.Collections.Generic 
命名 空间 )。 : 


static void Main(string[] args) 


{ 
try 


{ 
Dictionary<string, object> wfArgs = new Dictionary<string, object>(); 
wfArgs.Add("UserName", "Mel"); 
Activity workflow1 = new Workflow1(); 
WorkflowInvoker.Invoke(workflow1, wfArgs); 


catch (Exception ex) 


Console.WriteLine(ex.Message); 
Console.WritelLine(ex.Data[ "Reason"]); 


} 
注意 ， 异 常 的 “Reason” 可 以 通过 System.Exception 的 Data 属 性 获取 。 运 行 应 用 程序 ， 并 在 询问 
是 否 枚 举 驱 动 器 时 输入 “Y”， 输 出 结果 如 下 所 示 : 
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Hello Andrew 
Do you want me to list all machine drives? 


y 
Wonderful! 
CsN 

D:\ 
ESV 
F:\ 
人 
HSAN 
了 
Tha 


hanks for using this workflow 





es 


如 果 输 入 “N”( 或 其 他 非 “Y” 或 “y” 的 值 )， 将 得 到 如 下 结果 : 





Hello Andrew 
Do you want me to list all machine drives? 


n 
Too bad. All done 
YesOrNo was false 





26.5.9 我们 做 了 什么 


如 果 你 刚刚 接触 工作 流 环 境 ， 可 能 不 知道 我 们 使 用 WF XAML 而 非 纯 C# 代 码 编写 这 些 简单 的 业务 
逻辑 之 后 到 底 得 到 了 什么 。 毕 竟 , 你 可 以 完全 绕 开 Windows Workflow Foundation, 而 编写 如 下 的 C# 类 : 


class Program 


static void Main(string[] args) 
{ 

try 

{ 


ExecuteBusinessProcess(); 
catch (Exception ex) 


Console.WritelLine(ex.Message); 
Console.Writeline(ex.Data[ "Reason"]); 
} 
} 


private static void ExecuteBusinessProcess() 


string UserName = "Andrew"; 
Console.WritelLine("Hello {0}", UserName); 
Console.WriteLine("Do you want me to list all machine drives?"); 


string YesOrNo = Console.ReadLine(); 
if (YesOrNo.ToUpper() == "Y") 


Console.WriteLine("Wonderful!"); 
string[] DriveNames = Environment.GetLogicalDrives(); 
foreach (string item in DriveNames) 
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Console.WritelLine(item); 
Console.WriteLine("Thanks for using this workflow"); 


else 


{ 
Console.WritelLine("K, Bye.. 
Exception ex = new Excevtion(o User Said No!"); 
ex.Data[ "Reason"] = "YesOrNo was false"; 


} 

} 

这 段 程序 的 输出 结果 将 和 前 面 基 于 工作 流 的 XAML 的 输出 结果 完全 一 致 。 那 么 ， 我 们 为 什么 还 要 
去 的 这 些 活 动 呢 ?” 首先 ， 并 不 是 所 有 人 都 能 读 懂 Cyf 代 码 。 坦 诚 地 说 ， 如 果 你 需要 给 一 屋子 的 销售 人 员 
和 非 技术 管理 者 解释 这 个 业务 逻辑 ， 你 是 会 解释 这 段 C# 代 码 呢 ， 还 是 向 他 们 展示 这 个 流程 图 ? 更 重要 
的 是 ，WF API 包 含 了 众多 额外 的 运行 时 服务 , 包括 将 长 期 运行 的 工作 流 保 存 到 数据 库 、 自 动 跟踪 工作 
流 事 件 ， 等 等 〈 恕 不 一 一 列举 )。 如 果 要 把 这 些 功 能 复制 到 新 的 项 目 中 ，WF 所 需 的 工作 量 显 然 更 少 。 

尽管 WF API 并 不 一 定 是 所 有 .NET 程 序 的 正确 选择 ， 但 对 大 多 数 传统 业务 的 应 用 程序 来 说 ， 能 够 
以 这 种 方式 定义 、 承 载 、 执 行 和 监控 工作 流 确实 是 一 件 幸 事 。 和 其 他 新 技术 一 样 ， 你 需要 决定 它 是 否 
对 当前 项 目 有 用 。 让 我 们 来 看 看 WF API 的 另 一 个 示例 , 这 次 我 们 将 工作 流 包装 在 一 个 专门 的 *.dll 文 件 
中 。 


源 代码 ”EnumerateMachineDataWF 项 目的 源 代码 位 于 Chapter 26 子 目录 下 。 


26.6 ”在 专门 的 DLL 中 构建 Squence 工作 流 


尽管 Workflow Console Application 是 对 WF API 进 行 的 伟大 尝试 ， 但 一 个 准备 投产 的 工作 流 将 肯定 
被 打包 成 自 定义 的 .NET *.dll 程 序 集 。 这 样 就 可 以 在 多 个 项 目 中 重用 以 二 进 制 形式 存在 的 工作 流 。 

你 可 以 使 用 C# Class Library 项 目 建立 工作 流 库 , 但 最 简单 的 方法 是 使 用 Activity Library 项 目 , 它 位 
于 New Project 对 话 框 的 Workflow 节 点 下 。 使 用 该 项 目 类 型 的 好 处 是 , 它 自动 引用 了 所 和 需 的 WF 程序 集 ， 
并 给 出 了 一 个 *.xaml 文 件 用 于 创建 初始 的 程序 流 。 

在 本 节 的 工作 流 中 , 我 们 将 查询 AutoLot 数 据 库 , 检查 Inventory 表 中 是 否 包含 给 定 品牌 和 颜色 的 汽 
车 ， 并 对 这 一 过 程 进 行 建 模 。 如 果 被 请 求 的 汽车 有 现货 ， 则 构建 一 个 格式 良好 的 响应 ， 通 过 输出 
传递 给 宿主 程序 。 如 果 没 有 现货 ,将 生成 一 个 备忘录 ， 发 送 给 销售 部 门 的 负责 人 ， 请 求 他 们 找 出 一 
符合 条 件 的 汽车 。 


26.6.1 ”定义 初始 化 项 目 


创建 一 个 新 的 Activity Library 项 目 CheckInventoryWorkflowLib ( 如 图 26-20 所 示 )， 将 初始 的 
Activity1.xaml 文 件 改名 为 CheckInventory.xaml。 
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Type: Visual C# 
A blank Workflow Activity Library 


点 Activity Designer Library Visual C# 


4 Templates ee E 
# Visual C# 四 一 (9 
E Actvity Dbary 
Windows T! 、 A 
Web | | Activity Library 
于 i 
Office | WCF Workfiow Service Appli me me 
Cloud 
Reporting 
:SharePoint 
Silveright 
Toat 


Visual C# 


从 


Workflow Console Applicatior Visual C# 


CheckjnyentoryWearkflewLib 

CAMyCode [ ] 

ShecklnwartoryYiorkfiowtb © Create directory for solution 
{i Addto source control 


re 








图 26-20 ”创建 一 个 Activity Library 项 目 


不 幸 的 是 ， 当 为 一 个 工作 流 XAML 文件 重 命名 时 ， 后 台 的 类 将 不 会 被 重 命名 。 要 解决 这 个 问题 ， 
可 以 在 Solution Explorer 中 右键 点 击 CheckInventory.xaml 文 件 ， 选 择 查看 代码 。 修 改 <Activity> 根 元 素 
以 反映 真实 名 称 ， 如 下 所 示 : 


<Activity mc:Ignorable="sap sap2010 sads" 
x:Class="CheckInventoryWorkflowLib.CheckInventory" 


se 

该 工作 流 将 使 用 一 个 Sequence 活动 作为 主 活动 ， 而 不 是 Flowchart。 将 一 个 sequence 活动 拖 电 到 设 
计 器 中 (可 以 在 Toolbox 的 Control Flow 中 找到 它 )， 并 将 DisplayName 属 性 改 为 Look Up Product。 图 26-21 
展示 了 当前 的 设计 器 。 





Checkinventory.xamt” 石 XX | 人 
Activityl Expand Ai Collapse All 





tivity fere 





Variables Arguments Imports 4 A i00% 


图 26-21 最 顶端 的 Sequence 活 动 
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顾名思义 ，Sequence 活 动 将 帮助 你 轻松 地 创建 一 连 串 逐个 发 生 的 任务 。 但 这 并 不 意味 着 子 活动 也 
必须 遵循 严格 的 线性 路 径 。 序 列 中 可 以 包含 流程 图 、 其 他 序列 、 并 行 数据 处 理 、if/else 分 支 以 及 其 他 
可 能 为 正在 设计 的 业务 流程 带 来 重要 意义 的 活动 。 


26.6.2 引入 程序 集 和 命名 空间 


由 于 工作 流 将 与 AutoLot 数 据 库 进 行 交 互 , 我 们 下 一 步 要 做 的 是 使 用 Visual Studio 的 Add Renference 
对 话 框 添加 AutoLot.dll 程 序 集 的 引用 。 我 们 将 在 本 例 中 使 用 非 连 接 层 ， 因 此 我 建议 你 引用 第 22 章 创建 
的 程序 集 的 最 终 版 本 ( AutoLotDAL (Version 3) )。 

该 工作 流 还 将 使 用 LINQ to DataSet API 查 询 返 回 的 DataTable， 来 验证 所 请 求 的 项 是 否 有 现货 。 因 
此 还 需要 引用 System.Data.DataSetExtensions.dll ， 因 为 新 的 Activity Library 项 目 不 会 自动 引入 这 个 程 
序 集 。 

添加 了 这 些 程序 集 之 后 , 单 击 工作 流 设 计 器 底部 的 Imports 按 钮 。 在 该 编辑 器 顶端 的 文本 框 中 可 以 
输入 想 要 在 工作 流 作 用 域 中 使 用 的 .NET 命 名 空间 的 名 称 ( 可 以 将 这 个 区 域 看 做 是 C# using 关键 字 的 声 
明 式 版 本 )。 

你 可 以 在 Imports 编 辑 器 最 上 方 的 文本 框 中 输入 要 从 引用 的 程序 集中 添加 的 命名 空间 。 用 该 文本 框 
引入 AutoLotDisconnectedLayer 和 System.Data.DataSetExtensions。 这 样 在 引用 所 包含 的 类 型 时 就 不 必 
使 用 完全 限定 名 称 。 图 26-22 显 示 了 完成 之 后 的 Imports 区 域 。 


Checkinventory.xaml 过 XxX 2 小 





Activityl Expang AE Collapse All 


于 Sequence 


Drop activity here 


Enter or Select Namespace “ 


Imported namespaces 
AutoLotDisconnectedLayer 2 人 
System 
System.Collections.Generic 
System.Data 
SystemLinq 
System,Text 


Variables Arguments jmperts 省 内 100% ”站 图 


图 26-22 Imports 区 域 可 以 向 工作 流 中 引入 .NET 命 名 空间 
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26.6.3 ”定义 工作 流 参 数 


接 下 来 定义 两 个 工作 流 输入 参数 ，RequestedMake 和 RequestedColor ， 它 们 均 为 String 类 型 。 与 上 
例 类 似 ， 工 作 流 的 宿主 程序 将 创建 一 个 Dictionary 对 象 ， 包 含 映 射 到 这 些 参数 的 数据 ， 因 此 没有 必要 
在 Arguments 编 辑 器 中 指定 这 些 项 的 默认 值 。 正 如 你 猜测 的 那样 ， 工 作 流 将 使 用 这 些 传人 值 来 执行 数 
据 库 查询 。 

同样 ， 你 可 以 使 用 相同 的 Arguments 编 辑 器 定义 名 为 FormattedResponse 类 型 为 String 的 输出 参数 。 
当 需 要 工作 流向 宿主 程序 返回 数据 的 时 候 ， 你 可 以 创建 任意 数量 的 输出 参数 ， 这 些 输出 参数 可 以 在 工 
作 流 完成 时 被 宿主 程序 枚 举 。 图 26-23 显 示 了 当前 的 工作 流 设 计 器 。 





Name Direction Argument type Default value 


RequestedMake String Enter & CO# expression 


RequestedColor String Enter & CF gxiessios 


FormattedResponse String Defoult yalue not supported 


ment 
urnent 


滥用 10% vv， 加 图 


Variabies 





图 26-23 ”输入 和 输出 参数 


26.6.4 ”定义 工作 流 变量 


现在 , 我 们 需要 在 工作 流 中 声明 一 个 成 员 变 量 , 用 来 与 AutoLotDAL.dll 中 的 InventoryDALDisLayer 
类 通信 。 我 们 在 第 22 章 创建 的 这 个 类 可 以 获取 Inventory 中 的 所 有 数据 ， 并 保存 在 一 个 DataTable 中 。 
在 设计 颖 中 选择 Sequence 活 动 , 单 击 Variables 按 钮 , 创建 一 个 名 为 AutoLotInventory 的 变量 。 在 Variable 
Type 下 拉 列 表 杠 中， 选择 Browse For Types... 菜 单 选 项 ， 然 后 输入 InventoryDALDisLayer ( 如 图 26-24 


所 示 )。 
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| a 
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图 26-24 工作 流 变 量 可 以 在 某 个 作用 域内 以 声明 的 方式 定义 变量 


1 
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选中 新 建 的 变量 ， 在 Visual Studio 的 Properties 窗 口中 单 击 Default 属 性 旁 的 椭圆 形 按钮 。 这 将 打开 
一 个 代码 编辑 器 ， 你 可 以 根据 需要 调整 这 个 编辑 器 的 大 小 (在 输入 较 长 代码 时 非常 有 用 )。 如 果 在 设 
置 变量 时 需要 输入 复杂 的 代码 ， 该 编辑 器 也 很 好 用 。 输 入 下 面 的 (单行 ) 代码 ， 分 配 InventoryDAL- 
DisLayer 变 量 : 


new InventoryDALDisLayer(@"Data Source=(local)\SQOLEXPRESS;Initial Catalog=AutoLot;Integrated 
Security=Ture") 


使 用 WF 设计 器 再 声明 一 个 System.Data.DataTable 类 型 的 工作 流 变量 Inventory， 同 样 使 用 Browse 
For Types... 菜 单 选项 ， 将 默认 值 设置 为 nul1， 如 图 26-25 所 示 。 


Checkinventory,xaml* 六 X ， ， | 





Activityl Expand AH Collapse Ai 


他 Sequence 


Name Variable type Scope Default 
iAvtoLotinvyentory InventoryDALDisL: Sequence new InventoryDALDisLayer(@"Da: 
Inventory DataTable Sequence hu 11 | | 


Create Varioble 


Variables Arguments Imports 尖 A 100% 和 ba 加 
图 26-25 ”在 工作 流 中 声明 一 个 DataTable 变 量 
在 后 面 的 步骤 中 ,你 还 要 把 在 InventoryDALDisLayer 谈 量 上 调用 GetAllInventory() 的 结果 赋 给 
Inventory 变 量 。 
26.6.5 ”使 用 Assign 活 动 


Assign 活 动 可 以 设置 变量 的 值 ， 该 值 可 以 为 任何 有 效 的 代码 语句 的 输出 结果 。 将 Assign 活 动 (位 
于 Toolbox 的 Primitives 区 域内 ) 拖 电 到 Sequence 活 动 中 ( 如 图 26-26 所 示 )。 
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二 Sequence 和 


Ma Assign CE 


= Enterg C# expressi 


图 26-26 ”Assign 活 动 
在 左 侧 的 编辑 框 中 指定 Inventory 变 量 。 在 右 侧 的 编辑 框 中 输入 如 下 代码 : 


AutoLotInventory.GetAllInventory() 

当 工 作 流 执行 到 Assign 活 动 时 ， 将 得 到 包含 所 有 Inventory 表 中 记录 的 DataTable。 但 我 们 所 需要 
的 是 确定 与 宿主 程序 发 送 的 RequestedMake 和 RequestedColor 值 相符 的 项 是 否 存在 于 库存 中 。 这 需要 使 
用 LINQ to DataSet API 和 一 个 If 工作 流 活 动 。 


26.6.6 ”使 用 If 和 Switch 活动 
将 一 个 If 活 动 拖 中 到 Sequence 节 点 ， 放 置 在 Assign 活 动 下 面 ( 如 图 26-27 所 示 )。 


or o 四 


hog Assign 


Inventory = AutoLotinventory.G 


站 人 
全 王 二 从 
| Condition 

Enter a C¥ expression 


Then Else 


| 
{ 
| 
| 
| 


Drop activity here Drop octivity here 


| 
| 
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图 26-27 If 活动 
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由 于 If 活动 可 以 进行 运行 时 决策 ， 因 此 首先 需要 配置 If 活动 用 于 验证 的 Boolean 表 达 式 。 在 
Condition 编 辑 器 中 ， 输 入 如 下 的 验证 LINQ to DataSet 查 询 : 


(from car in Inventory.AsEnumerable() 
where (string)car["Color"] == RequestedColor && 
(string)car["Make"] == RequestedMake select car).Any() 


该 LINQ 查 询 使 用 工作 流 宿主 提供 的 RequestedColor 和 RequestedMake 参 数 获取 DataTable 中 所 有 符 
合 所 选 品 牌 和 颜色 的 记录 。 然 后 调用 Any() 扩 展 方法 ,根据 查询 是 否 有 结果 而 返回 true 或 false。 

下 一 步 的 任务 是 配置 一 些 当 指定 条 件 为 true 或 false 时 将 执行 的 任务 。 记 住 我 们 的 最 终 目标 是 , 如 
果 存 在 所 请 求 的 汽车 ， 则 向 用 户 返 回 一 个 格式 化 的 消息 。 不 过 ,为 了 增加 一 些 趣味 性 ， 我 们 返回 的 消 
息 根 据 调 用 者 所 请 求 的 汽车 品牌 (如 BMW 、Yugo 等 ) 的 不 同 而 有 所 区 别 。 

将 一 个 SwitchxT> 活 动 (位 于 Toolbox 的 Flow Control 区 域 ) 拖 电 到 If 活动 的 Then 区 域 。 这 时 ，Visual 
Studio 将 立即 显示 一 个 对 话 框 ， 询 问 泛 型 类 型 参数 的 类 型 。 这 里 我 们 指定 为 string。 这 时 ， 使 用 工作 
流 设 计 器 来 设置 Switch 活动 的 Expression 字 段 ， 输 入 RequestedMake ( 如 图 26-28 所 示 ) 。 


二 Sequence 
28 Assign 
Inventory = AutoLotinventory.C 
全 要 
Condition 


{from car in Inventory,AsEnumerable0 

Then Else 
a Switch<String> 
Expression RequestedMake 


Default 


Add new tase 


图 26-28 ”Switch 活动 


你 将 看 到 Switch 活动 的 默认 选项 , 但 必须 展开 才能 添加 子 活动 ( 单 击 “Add an Activity”)。 在 Default 
编辑 域 中 添加 一 个 单独 的 Assign 活 动 ， 然 后 用 如 下 的 代码 语句 设置 FormattedResponse 人 参数: 


String.Format("Yes, we have a {0} {1} you can purchase", 
RequestedColor, RequestedMake) 
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这 时 ，Switch 编 辑 器 将 如 图 26-29 所 示 。 


cs Switch<String> 
Expression RequestedMake 


Default 


i 


oi 
| 
! 
1 


| FormattedResponst = String.Format("Yes, | 


Add new case 


图 26-29 ”定义 Switch 活动 的 默认 任务 


现在 ， 单 击 “Add New Case” 链 接 ， 在 第 一 个 事例 (case ) 处 输入 BMW ( 不 加 双 引 号 )， 然 后 再 添 
加 一 个 Yugo 事 例 ( 同样 不 加 双 引 号 )。 在 这 些 事例 区 域 中 , 分 别 拖 电 一 个 Assign 活 动 , 并 且 都 为 Formatted- 
Response 变 量 赋值 。 对 于 BMW 事 例 ， 赋 值 语句 如 下 : 


String.Format("Yes sir! We can send you {0} {1} as soon as {2}!", 
RequestedColor, RequestedMake, DateTime.Now) 


对 于 Yugo 事 例 ， 使 用 如 下 的 表达 式 : 


String.Format("Please, we will pay you to get this {0} off our lot!", 
RequestedMake) 


现在 Switch 活动 的 外 观 大 致 如 图 26-30 所 示 。 


gE Switch<String> 


众 
Expression RequestedMake 
Default Assign 
Case BWM Assign 
Case Yugo 


Arg Assign 


FormattedRespcnst = String.Format("Plea 


Add nev cose 


图 26-30 ”最 终 的 Switch 活动 
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26.6.7 ”构建 自 定义 代码 活动 


”与 工作 流 设计 器 体验 一 样 富 于 表现 力 的 是 , 你 可 以 在 XAML 文 件 中 内 能 复杂 的 代码 语句 (和 LINQ 
查询 )， 在 专门 的 类 中 编写 代码 ， 这 样 的 需求 是 很 常见 的 。 使 用 WF API 有 很 多 种 方法 可 以 实现 这 个 目 
标 ， 但 最 直接 的 方式 是 创建 一 个 类 扩展 CodeActivity ， 或 者 如 果 活 动 需要 返回 值 的 话 ， 创 建 一 个 
CodeActivity<T> (T 为 返回 值 类 型 )。 

在 这 里 ,我 们 将 创建 一 个 简单 的 自 定义 活动 ， 将 数据 转 储 到 文本 文件 中 ， 并 通知 销售 人 员 库 存 系 
统 中 没有 当前 请 求 的 汽车 。 首 先 ， 单 击 Project| Add New Item 菜 单 选项 ,插入 一 个 Code Activity， 取 名 
为 CreateSalesMemoActivity.cs ( 如 图 26-31 所 示 )。 












































Pa Egg 
4 Installed Sort by: | Search installed Templates 
| UC i 
| 4 Visual Cs kems * 4 2 
Code PS Activity Visual C# ltems Type Wel fen 
An activity with execution logic writtenin | 
Data 多 时 _ code 
General 时 Activity Designer Visual Cs# ltems 
Windows Forms cviy NR Val Cr hem: 
WPF | CodeActivity E 
Reporting 各 WCF Workflow ServiE EU Cz ftems 
Workflow 
Graphics 
| Online 
| Name: CreateSalesMemoActivity.cs 











图 26-31 插入 新 的 Code Activity 


如 果 自 定义 活动 需要 输入 内 容 ， 可 以 用 InArgument<T> 类 型 的 属性 来 表示 。InArgument<T> 类 是 WF 
API 特 有 的 实体 ， 可 以 将 工作 流 提供 的 数据 传 入 自 定义 活动 类 的 内 部 。 我 们 的 活动 需要 两 个 这 样 的 属 
性 ,分 别 表示 没有 现货 的 汽车 的 品牌 和 颜色 。 

同样 ， 自 定义 代码 活动 需要 重 写 虚 方法 Execute()， 当 执行 到 该 活动 时 ,WF 运行 时 会 调用 该 方法 。 
该 方法 将 使 用 InArgument<> 属 性 ,为 了 得 到 实际 的 值 , 需要 间接 使 用 CodeActivityContext 的 GetValue() 
方法 。 

以 下 是 自 定义 活动 的 代码 ， 它 将 生成 一 个 *.txt 文 件 ， 用 来 向 销售 团队 描述 情况 : 

ee sealed class CreateSalesMemoActivity : CodeActivity 

// 自 定义 活动 的 两 个 属性 


public InArgument<string> Make { get; set; } 
public InArgument<string> Color { get; set; } 
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// 如 果 活 动 有 返回 值 ， 则 需要 继承 CodeActivity<TResult>， 并 在 Execute 方 法 中 返回 该 值 
protected override void Execute(CodeActivityContext context) 


// 将 消息 转 存 到 本 地 文本 文件 中 

StringBuilder salesMessage = new StringBuilder(); 
salesMessage.AppendLine("***** Attention sales team! *****"); 
salesMessage.AppendLine("Please order the following ASAP!"); 
salesMessage.AppendFormat("1 {0} {1i}\n", 


context.GetValue(Color), context.GetValue(Make)); 
salesMessage.AppendLine( 量 来 玉米 米 冰 米 玉米 玉米 玉 六 六 六 闵 阔 六 玉米 玉米 米 六 冰冰 米 米 六 来 玉米 玉米 中 ) > 


System.10.File.WriteAllText("SalesMemo.txt", salesMessage.ToString()); 


} 
} 


编译 工作 流程 序 集 。 确保 工 作 流 设计 器 在 Visual Studio IDE 中 处 于 激活 状态 。 检 查 Toolbox 的 上 方 ， 
将 看 到 我 们 的 自 定义 活动 及 其 说 明 ( 如 图 26-32 所 示 )。 






I TOOLBOX 0 vO XI 
Search Toolbox 
4 CheckinventoryWorkflowLib 
AN Pointer 
| 


4 Control Flow 
; | CreateSalesMemoActhity 
人 es | Version 1.0.00 
说 DowWhile | Managed NET Component 
ForEach< Th dd 
I 


Parallel 





















图 26-32” 自 定义 代码 活动 出 现在 Visual Studio 的 Toolbox 中 


首先 ， 将 一 个 新 的 Sequence 活 动 拖 中 到 If 活 动 的 Else 分 支 。 然 后 ,将 自 定义 活动 拖 忠 到 Sequence。 
这 时 ， 我 们 可 以 在 Properties 窗 口中 设置 暴露 出 来 的 属性 。 用 RequestedMake 和 RequestedColor 变 量 设置 
活动 的 Make 和 Color 属 性 ， 如 图 26-33 所 示 。 
PROPERTIES te 
CheckdnventoryWeorkflcowLibCreateSalesMemoActvity 
By Search: 
已 Misc 
Color RequestedColor 国 
DisplayName CreateSalesMemoActivity 
Make RequestedMake 加 





图 26-33 ”设置 自 定义 代码 活动 的 属性 
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最 后 , 拖 忠 一 个 Assign 活 动 到 Else 分 支 的 Sequence 活 动 中 , 并 设置 FormatedResponse 的 值 为 “Sorry, 
out of stock”。 图 26-34 显 示 了 最 终 的 If 活动 。 
总 
Condition 
(from car in Inventory.AsEnumerable0 


Then 


辣 Sequence 


» 


sE Switch<String> 


DS 


Expression RequestedMake 饥 CreateSalesMemoActivity 


Default 


Case BWM 


Assign aog Assign 
Case Yugo 


FormattedResponst = “Sorry, out of stock 


图 26-34 ”完整 的 If 活动 
编译 项 目 ， 接 下 来 是 本 章 的 最 后 一 部 分 ， 我 们 将 构建 一 个 使 用 该 工作 流 的 客户 端 宿主 程序 。 


源 代码 ”CheckInventoryWorkflowLib 项 目的 源 代码 位 于 Chapter 26 子 目录 下 。 


26.7 ”使 用 工作 流 库 


任何 类 型 的 应 用 程序 都 可 以 使 用 工作 流 库 。 但 这 里 我 们 简便 起 见 ， 创 建 一 个 工作 台 应 用 程序 ， 命 
名 为 WorkflowLibraryClient 。 建 好 之 后 ， 需 要 添加 的 引用 除了 CheckInventoryWorkflowLib.dll 和 
AutoLotDAL.dll， 还 包括 WF 主 库 System.Activities.dll。 将 这 些 库 添加 到 引用 。 

然后 ， 用 下 面 的 逻辑 更 新 Program.cs 文 件 : 

using System; 

using CheckInventoryWorkflowLib; 


namespace WorkflowLibraryClient 


class Program 
static void Main(string[] args) 


Console.WritelLine("**** Tnventory Look up ****"); 


// 获取 用 户 偏好 
Console.Write("Enter Color: "); 
string color = Console.ReadLine(); 
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Console.Write("Enter Make: "); 
string make = Console.ReadLine(); 


// 包装 工作 流 要 用 的 数据 


Dictionary<string, object> wfArgs = new Dictionary<string, object>() 


{"RequestedColor", color}, 
{"RequestedMake", make} 


; 
try 


// 向 工作 流 发 送 数 据 
WorkflowInvoker.Invoke(new CheckInventory(), wfArgs); 


catch (Exception ex) 


Console.Writeline(ex.Message); 


} 
} 
} 


与 其 他 示例 一 样 , 我 们 使 用 WorkflowInvoker 以 同步 的 方式 调用 工作 流 。 尽 管 这 一 切 看 上 去 都 不 错 ， 
但 我 们 如 何 获取 工作 流 的 返回 值 呢 ? 记 住 ， 当 工作 流 终止 的 时 候 ， 我 们 应 该 得 到 格式 化 的 响应 。 


获取 工作 流 的 输出 参数 


WorkflowInvoker.Invoke() 方 法 将 返回 一 个 实现 了 IDictionary<string, object> 接 口 的 对 象 。 由 于 四 
工作 流 可 以 返回 任意 数量 的 输出 参数 ， 因 此 你 需要 用 一 个 字符 串 值 来 指定 每 个 输出 参数 的 名 称 ， 来 作 
为 类 型 索引 器 。 用 如 下 代码 更 新 try/catch 逻 辑 : 


try 


// 向 工作 流 发 送 数 据 
IDictionary<string, object> outputArgs = 
WorkflowInvoker.Invoke(new CheckInventory(), wfArgs); 


// 打印 输出 的 消息 
Console.WriteLine(outputArgs["FormattedResponse" ]); 


catch (Exception ex) 


Console.WriteLine(ex.Message); 


现在 ， 返回 程序 ， 输入 一 个 已 经 存在 于 AutoLot 数 据 库 Inventory 表 中 的 汽车 的 品牌 和 颜色 ， 将 看 
到 如 下 的 输出 结果 : 


* 六 水 米 Tnventory Look up **** 

Enter Color: Black 

Enter Make: BMW 

Yes sir! We can send you Black BMW as soon as 2/17/2012 9:23:01 PM! 
Press any key to continue . .. 








RENEE eet 
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而 如 果 输 入 不 存在 的 项 ， 将 只 能 看 到 如 下 的 输出 结果 : 





六 沙沙 炒 Inventory Look up **** 
Enter Color: Pea Soup Green 
Enter Make: Viper 

Sorry, out of stock 

Press any key to continue . 





你 还 将 在 客户 端 应 用 程序 的 \bin\Debug 文 件 夹 下 找到 *.txt 文 件 。 打 开 该 文件 ,将 看 到 如 下 所 示 的 “ 销 
售 备 忘 ”: 





***《** Attention sales team! 冰冰 冰冰 
Please order the following ASAP! 


1 Pea Soup Green Viper 
六 六 六 永 闵 闵 冰 冰冰 冰冰 玉 玉米 冰冰 冰冰 六 闵 玉米 六 六 冰冰 冰 六 六 六 冰冰 冰 





这 就 是 我 们 对 于 WF API 的 简要 介绍 。 由 于 本 章 只 接触 了 .NET 平 台中 这 个 特殊 领域 的 一 些 主要 方 
面 ， 我 真诚 地 希望 如 果 你 感 兴趣 的 话 能 够 有 信心 深入 研究 这 个 话题 。 


源 代 码 WorkflowLibraryClient 项 目的 源 代码 位 于 Chapter 26 子 目录 下 。 


26.8 小 结 


从 本 质 上 讲 ，WF 人 允许 你 在 应 用 程序 内 直接 对 应 用 程序 的 内 部 工作 流 进行 建 模 。 但 是 ， 除 了 简单 
地 对 工作 流 建 模 ，WF 还 提供 了 完整 的 运行 时 引 敬 和 多 项 服务 ， 以 便 用 来 完成 该 API 的 所 有 功能 ( 持久 
化 、 跟 踪 服 务 等 )。 虽然 本 章 没 有 直接 介绍 这 些 服务 ,但 要 知道 的 是 一 个 产品 级 别 的 WF 应 用 程序 肯定 
会 使 用 这 些 工具 。 

在 本 章 的 介绍 中 ,你 学 习 到 了 两 个 顶级 的 活动 Flowchart 和 Sequence。 虽 然 这 两 个 类 型 以 不 同 的 方 
式 控制 逻辑 流 ， 但 他 们 可 以 包含 相同 种 类 的 子 活动 ， 并 且 以 相同 的 方式 被 宿主 程序 执行 ( 通过 
WorkflowInvoker 或 WorkflowApplication )。 你 还 学 习 了 如 何 使 用 泛 型 Dictionary 对 象 向 工作 流传 入 宿主 
参数 ， 以 及 如 何 使 用 泛 型 IDictionary 兼 容 的 对 象 从 工作 流 获取 输出 参数 。 





本 部 分 内 容 
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ON 


NET 1.0 中 ， 建 立 图 形 化 桌面 应 用 程序 可 以 使 用 两 个 API: Windows Forms 和 GDI+， 它 们 主 

十 要 位 于 System. Windows.Forms.dll 和 System.Drawing.dll 程 序 集 内 。 尽 管 Windows Forms/GDI+ 

对 于 构建 传统 的 桌面 GUI 来 说 是 非常 优秀 的 API， 但 微软 在 .NET 3.0 中 发 布 了 另 一 个 GUI 桌面 API 一 一 
WPF。 

作为 学 习 WPF 的 第 一 章 ， 本 章 首 先 研 究 这 个 全 新 的 GUI 框架 背后 的 动机 ， 这 将 有 助 于 你 理解 
Windows Forms/GDI+ 和 WPF 编 程 模 型 的 区 别 。 接 下 来 ， 我 们 将 介绍 该 API 所 支持 的 不 同类 型 的 WPF 应 
用 程序 ， 并 理解 一 些 重要 类 的 作用 ， 包括 Application、Window、ContentControl、Control、UIElement 
和 FrameworkElement。 在 此 期 间 ， 你 还 将 学 习 只 使 用 C# 代 码 捕获 键盘 和 鼠标 活动 ， 定 义 应 用 程序 范围 
的 数据 ， 以 及 其 他 常见 WPF 任 务 。 

这 一 章 余 下 部 分 会 介绍 一 种 全 新 的 基于 XML 的 语法 ， 即 XAML ( Extensible Application Markup 
Language, 可 扩展 应 用 程序 标记 语言 , 读 作 “zammel”)。 在 这 里 , 我 们 会 介绍 XAML 的 语法 和 语义 ( 包 
括 附加 属性 语法 、 类 型 转换 的 作用 、 标 记 扩 展 )， 并 理解 如 何在 运行 时 生成 、 加 载 和 解析 XAML。 同 
样 ， 你 还 将 学 习 如 何 将 XAML 数 据 整合 到 WPF 的 C# 代 码 库 〈 以 及 这 么 做 的 好 处 )。 

本 章 最 后 介绍 了 Visual Studio 中 集成 的 WPF 设 计 器 。 在 此 ， 我 们 将 构建 一 个 自 定义 的 XAML 编辑 
器 /解析 器 ， 可 以 演示 如 何在 运行 时 操纵 XAML 来 动态 地 构建 用 户 界面 。 


27.1 WPF 背后 的 动机 


近年 来 , 微软 已 经 开发 出 了 众多 的 GUI 开发 工具 包 ( 原始 的 C/C++/Windows API 开 发 、VB6、MFC， 
等 等 ) 用 以 创建 桌面 可 执行 程序 。 这 些 GUI API 各 自 都 提供 了 用 以 代表 GUI 应 用 程序 基本 要 素 的 代码 库 ， 
这 些 基 本 要 素 包 括 主 窗 体 、 对 话 框 、 控 件 、 菜 单 系统 以 及 其 他 一 些 必需 的 要 素 。 随 着 .NET 平 台 的 发 布 ， 
Windows Forms API 开 发 模型 任 借 其 简单 而 又 强大 的 对 象 模 型 ， 快 速成 为 UI 开 发 的 首选 。 

虽然 许多 功能 完整 的 桌面 应 用 程序 已 经 通过 使 用 Windows Forms 成 功 地 开发 出 来 ， 但 事实 上 现在 
的 桌面 开发 编程 模型 是 非常 不 对 称 的 。 简 单 地 说 ，System.Windows.Forms.dll 和 System.Drawing.dll 没 有 
对 创建 完全 成 熟 的 桌面 应 用 程序 所 需 的 许多 技术 提供 直接 的 支持 。 为 了 说 明 这 一 点 ,考虑 一 下 在 WPF 
发 布 之 前 进行 GUI 桌面 开发 时 的 混乱 局 面 ( 如 表 27-1 所 示 )。 

正如 你 所 看 到 的 ，Windows Forms 开 发 人 员 必 须 引 入 来 自 多 种 不 同 API 和 对 象 模型 的 类 型 。 尽 管 使 
用 这 些 不 同 种 类 的 API 可 能 在 语法 上 看 起 来 比较 相似 (毕竟 都 是 C# 代 码 ), 但 你 也 应 该 承认 每 种 技术 都 
需要 截然 不 同 的 思维 方式 。 比 如 , 使 用 DirectX 创 建 三 维 呈 现 动 画 时 所 需要 的 技巧 ,与 将 数据 绑 定 到 网 
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格 时 所 需要 的 技巧 完全 不 一 样 。 肯 定 地 讲 ， 要 一 个 Windows Forms 编 程 人 员 掌 握 所 有 这 些 锭 异 的 API 
是 非常 困难 的 。 


表 27-1 WPF 之 前 为 所 需 功 能 提供 的 解决 方案 





所 要 求 的 功能 技 术 
构建 带 控件 的 表单 Windows Forms 
2D 图 形 支持 GDI+ ( System.Drawing.dll ) 
3D 图 形 支 持 DirectX API 
对 流 视频 的 支持 Windows Media Player API 
对 流 文档 的 支持 编程 操作 PDF 文 件 


27.1.1 统一 多 种 不 同 的 API 

WPF (在 .NET 3.0 中 引入 的 ) 正 是 本 着 要 将 这 些 之 前 不 相关 的 编程 任务 融合 为 一 个 统一 对 象 模型 
的 目的 而 开发 出 来 的 。 这样， 如 果 你 需要 创建 一 段 三 维 动画 ， 就 没有 必要 使 用 DirectX API 进 行 手工 编 
程 ， 因 为 这 个 功能 已 经 被 直接 内 散在 WPF 中 了 。 要 了 解 情况 变 得 何等 简化 ， 如 表 27-2 所 示 ， 它 简要 说 
明了 .NET 3.0 桌 面 开发 模型 。 


表 27-2 NET 3.0 对 所 要 求 的 功能 的 解决 方案 


所 要 求 的 功能 技 术 
构建 带 控件 的 表单 WPF 
2D 图 形 支持 WPF 
3D 图 形 支持 WPF 
对 流 视频 的 支持 WPF 
对 流 文档 的 支持 WPF 


一 个 显而易见 的 好 处 是 ， 现 在 .NET 开 发 者 拥有 一 个 单一 、 对 称 的 API， 可 以 满足 所 有 常见 的 GUI 
桌面 程序 的 需要 。 在 学 习 完 WPF 主 要 程序 集 的 功能 和 XAML 的 语法 之 后 ,你 会 惊 许 于 创建 一 个 复杂 芯 
UI 是 如 此 快速 。 


27.1.2 ”通过 XAML 将 关注 点 分 离 


也 许 WPF 最 引 人 注 目的 好 处 之 一 就 是 ， 它 提供 了 一 种 方法 ， 能 将 GUI 应 用 程序 的 界面 外 观 与 驱动 
它们 的 编程 逻辑 清晰 地 相互 分 离 。 使 用 XAML， 可 以 利用 标记 ( markup ) 来 定义 一 个 应 用 程序 的 UI。 
这 种 标记 理想 状态 下 由 Microsoft Visual Studio 或 Microsoft Expression Blend 工 具 来 创建 ) 随后 可 以 连接 
到 一 个 相关 的 C# 代 码 文件 ， 由 它 提 供 相 应 的 程序 功能 。 

WPF 妖 外 一 个 引 人 注 目的 特点 就 是 这 种 “桌面 标记 ”所 提供 的 灵活 性 。 在 XAML 标 记 中 ， 你 不 仅 
可 以 定义 简单 的 UI 元 素 〈 按钮、 网 格 、 列 表 框 等 )， 而 且 还 可 以 定义 交互 的 二 维和 三 维 图 像 、 动 画 、 
数据 绑 定 逻辑 以 及 多 媒体 功能 (如 视频 回放 )。 
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说 了 明 XAML 不 仅仅 局 限于 WPF 应 用 程序 。 任 何 应 用 程序 都 可 以 使 用 XAML 来 描述 .NET 对 象 树 ， 即 
使 和 可 视 化 用 户 界 面 没 有 什么 关系 。 例如， 可 以 使 用 基于 XAML 的 语法 为 WF API 定 义 业 务 流 
程 和 自 定义 活动 。 同 样 ， 其 他 .NET GUI 框架 ， 如 Silverlight、Windows Phone 7 和 Windows 8 应 
用 程序 ， 都 使 用 了 XAML。 


XAML 还 大 大 简化 了 自 定义 控件 如 何 呈 现 其 可 视 外 观 。 比 如 ， 定 义 一 个 以 一 家 公司 商标 为 动画 背 
景 的 圆 形 按钮 控件 ， 只 需 短 短 几 行 标记 语言 。 如 第 31 章 中 所 示 ，WPF 控 件 还 可 以 通过 样式 和 模板 来 加 
以 修饰 ， 这 样 就 使 你 能 够 独立 于 核心 程序 来 处 理 代码 ， 花 最 少 精力 就 可 改变 一 个 应 用 程序 整体 的 界面 
外 观 。 和 Windows Forms 开 发 不 同 ， 从 头 构建 自 定 义 WPF 控 件 的 唯一 可 能 的 原因 就 是 我 们 需要 改变 控件 
的 行为 ( 如 增加 自 定义 方法 、 属 性 或 事件 、 重 写 既 有 控件 的 虚拟 成 员 等 )。 如 果 你 只 需要 改变 控件 的 观 
感 ( 又 如 圆 形 按钮 )， 完 全 可 以 通过 标记 来 实现 。 


27.1.3 ”提供 优化 的 呈现 模型 


Windows Forms、MFC、VB6 这 样 的 GUI 工具 在 执行 所 有 的 图 形 呈 现 请 求 ( 包括 呈现 按钮 、 下 拉 
框 这 样 的 UI 元 素 ) 时 ， 都 使 用 一 个 低级 别 的 、 基 于 C 的 API ( GDI )， 它 作为 Windows 操 作 系 统 的 一 部 
分 已 经 很 多 年 了 。GDI 为 典型 的 商业 应 用 或 简单 的 图 形 程序 提供 了 足够 的 性 能 ， 但 如 果 UI 应 用 程序 需 
要 更 高 性 能 的 图 形 ， 就 需要 DirectX 了 。 

WPF 编 程 模型 则 完全 不 同 , 它 在 呈现 图 形 数据 时 不 使 用 GDI。 所 有 呈现 操作 ( 如 2D 图 形 、3D 图 形 、 
动画 、 控 件 呈 现 等 ) 都 使 用 DirectX API。 最 显而易见 的 好 处 是 ，WPF 应 用 程序 将 自动 利用 软 硬 件 优化 
的 优势 。 同 样 ，WPF 应 用 程序 还 能 使 用 丰富 的 图 形 服务 ( 模糊 效果 、 抗 锯齿 、 透 明度 等 )， 并 且 避 免 
了 直接 使 用 DirectX API 进 行 编程 所 带 来 的 复杂 性 。 


说 明 尽管 WPF 将 所 有 的 呈现 请 求 都 推 入 DirectX 层 ， 但 这 并 不 意味 着 WPF 应 用 程序 能 达到 直接 使 用 
非 托管 CH+ 和 DirectX 时 的 执行 速度 。 如 果 要 构建 最 快速 的 桌面 应 用 ( 如 3D 视 频 游戏 )， 非 托管 
C++ 和 DirectX 仍 然 是 最 佳 方案 。 


27.1.4 ”简化 复杂 的 UI 编程 


总 结 一 下 ，WPF ( Windows Presentation Foundation ) 是 一 个 新 的 API， 它 可 以 构建 将 各 种 桌面 API 
整合 到 一 个 对 象 模型 中 的 桌面 应 用 程序 ， 并 通过 XAML 提供 彻底 的 关注 点 分 离 。 除 了 这 些 要 点 ，WPF 还 
能 以 十 分 简单 的 方式 在 程序 中 集成 服务 ， 而 这 在 之 前 是 相当 复杂 的 。 下 面 是 这 些 核心 WPF 特 性 的 简介 。 

口 众多 对 放置 操作 和 内 容重 定位 提供 完全 支持 的 布局 管理 器 ( 远 远 多 于 Windows Forms )。 

口 使 用 增强 型 的 数据 绑 定 引擎 ， 支 持 多 种 方式 的 内 容 到 UI 元 素 的 绑 定 。 

口 一 个 内 置 的 样式 引擎， 允许 你 为 WPF 程 序 定义 “主题 "。 

口 使 用 矢量 图 形 ， 人 允许 图 像 自动 调整 大 小 来 适应 承载 应 用 程序 的 屏幕 的 大 小 和 分 辩 率 。 

口 支持 2D 和 3D 图 形 、 动 画 、 视 频 以 及 音频 回放 。 

口 丰富 的 印刷 API， 如 支持 XML 文件 规范 (XPS ) 文档 、 固 定 文档 ( WYSIWYG )、 流 文档 以 及 

文档 注释 〈 如 粘 滞 便 签 API )。 
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口 支持 与 遗留 GUI 模型 ( 如 Windows Forms 、ActiveX 以 及 Win32 HWND ) 的 互 操作 。 例 如 ， 可 以 
在 WPF 应 用 程序 中 应 用 自 定义 的 Windows Forms 控 件 ， 反 之 亦 然 。 
现在 我 们 已 经 对 WPF 有 了 初步 的 认识 ， 下 面 我 们 来 看 看 可 以 使 用 该 API 创 建 的 不 同类 型 的 应 用 程 
序 。 放 心 ， 这 些 特性 将 会 在 后 面 的 章节 里 详细 介绍 。 


27.2 各 种 形式 的 WPF 应 用 程序 


WPF API 可 以 用 于 构建 各 种 GUI 相关 的 应 用 程序 ， 它 们 在 导航 结构 和 部 署 模型 方面 都 不 同 。 这 部 
分 内 容 会 大 致 介绍 每 一 个 选项 。 


27.2.1 传统 的 桌面 应 用 程序 


第 一 个 ( 最 熟悉 ) 选项 是 运行 于 本 地 计算 机 的 传统 的 可 执行 程序 集 。 例 如 ,我 们 可 以 使 用 WPF 来 
构建 文本 编辑 器 、 绘 图 程序 或 者 诸如 数字 播放 器 、 图 片 查看 器 等 多 媒体 程序 。 和 其 他 桌面 应 用 程序 相 
似 ， 这 些 *.exe 文 件 可 以 使 用 传统 的 方式 进行 安装 ( 安装 程序 、Windows 安 装 包 等 ) 或 通过 ClickOnce 
技术 允许 桌面 应 用 程序 通过 远程 Web 服 务 器 分 布 和 安装 。 

从 编程 角度 说 ， 这 个 类 型 的 WPF 应 用 程序 ( 至 少 ) 会 使 用 Window 和 Application 类 类 型 ， 以 及 对 话 
框 、 工 具 条 、 状 态 栏 、 菜 单 系统 和 其 他 UI 元 素 。 

现在 , 你 肯定 可 以 使 用 WPF 构 建 这 种 基本 的 、 没 有 任何 特效 的 商业 应 用 , 但 只 有 加 入 这 些 特 性 时 ， 
WPF 才 会 真正 闪光 。 图 27-1 显 示 了 一 个 WPF 示 例 桌 面 应 用 ， 可 以 查看 医疗 系统 中 患者 记录 。 
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图 27-1 使 用 了 一 些 WPF API 的 WPF 桌 面 应 用 程序 
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遗憾 的 是 ， 截 屏 无 法 显示 该 程序 的 全 部 特性 。 比 如 ， 如 果 你 能 看 到 运行 中 的 该 程序 ， 注 意 主 窗口 
的 右上 方 显 示 的 是 患者 窦 性 心率 的 实时 图 像 。 单 击 右 下 方 的 Patient Details 按 钮 ， 将 启动 一 些 动画 ， 使 
UI 翻转 、 旋 转 、 变 换 成 如 图 27-2 所 示 的 外 观 。 
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图 27-2 WPF 中 的 变换 和 动画 是 十 分 简单 的 
我 们 能 用 WPF 创 建 一 个 相同 的 应 用 程序 吗 ?” 当然 可 以 。 但 是 代码 很 多 也 很 复杂 。 


说 明 ”该 示例 应 用 以 及 很 多 其 他 应 用 都 可 以 在 WPF 的 官方 网 站 http://windowsclient.net 上 下 载 。 你 可 以 
在 这 个 网 站 上 找到 很 多 WPF ( 和 Windows Forms ) 白皮书 、 示 例 项 目 、 技 术 演练 和 讨论 。 





27.2.2 ”基于 导航 的 WPF 应 用 程序 


WPF 应 用 程序 可 以 选择 使 用 基于 导航 的 结构 ， 它 是 基于 Web 浏 览 器 应 用 程序 的 传统 桌面 应 
序 。 使 用 这 个 模型 ， 我 们 可 以 构建 桌面 *.exe 来 提供 “向 前 ”和 “向 后 ”按钮 ， ww 
页 面 之 间 切 换 。 

这 种 类 型 的 应 用 程序 维护 了 每 一 个 页 面 的 列表 ,并 且 提供 了 在 它们 之 间 导 航 、 在 页 面 之 间 传 递 数 
据 (和 基于 Web 的 应 用 程序 变量 相似 ) 以 及 维护 历史 列表 的 必要 基础 结构 。Windows 资 源 管理 器 ( 如 
图 27-3 所 示 ) 是 一 个 实际 的 例子 ， 它 就 使 用 了 这 样 一 种 功能 。 注 意 窗 体 左 上 方 的 导航 按钮 ( 以 及 历史 
列表 )。 
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图 27-3 ”基于 导航 的 桌面 程序 


尽管 WPF 桌 面 应 用 程序 可 以 使 用 和 Web 相 似 的 导航 结构 ,但 这 只 是 UI 设 计 问 题 。 应 用 程序 本 身 只 是 
运行 于 桌面 计算 机 的 可 执行 程序 ， 并 且 除 了 看 上 去 有 点 相似 之 外 ， 和 Web 应 用 程序 没什么 相关 性 。 从 编 
程 角度 来 说 ， 这 类 WPF 应 用 程序 使 用 诸如 Application、Page 、NavagationWindow 和 Frame 的 类 进行 表示 。 


27.2.3 XBAP 应 用 程序 


WPF 还 允许 我 们 构建 可 以 在 Web 浏 览 器 中 承载 的 应 用 程序 。 这 种 形式 的 WPF 应 用 程序 叫做 XAML 
浏览 器 应 用 程序 或 XBAP。 在 这 个 模型 下 ,终端 用 户 导 航 到 某 个 URL，XBAP 应 用 程序 ( 从 本 质 上 说 ， 
它 是 Page 对 象 的 集合 ) 从 这 个 点 透明 下 载 并 且 安 装 在 本 地 机 器 上 。 然 而 和 可 执行 应 用 程序 传统 的 
ClickOnce 不 同 的 是 ，XBAP 程 序 直接 在 浏览 器 中 承载 并 且 采 用 了 浏览 器 的 原生 导航 系统 。 图 27-4 演 示 
运行 中 的 XBAP 程 序 ( ExpenseIt WPF 示 例 程序 ， 可 以 在 http://windowsclient.net 找 到 )。 
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图 27-4 XBAP 程 序 下 载 到 本 地 机 器 并 且 在 Web 浏 览 器 中 进行 承载 
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XBAP 的 一 个 好 处 是 ， 与 用 HTML 和 JavaScript 构 建 的 典型 Web 页 面相 比 ， 它 创建 的 UI 更 复杂 ， 也 
更 富 于 表现 力 ( 当然 ，HTML5 改 善 了 这 一 局 面 )。 一 个 XBAP Page 对 象 可 以 像 在 桌面 WPF 应 用 程序 中 
那样 使 用 WPF 服 务 ， 包 括 动画 、 二 维和 三 维 图 形 、 主 题 等 。 实 际 上 ，Web 浏 览 器 只 是 WPF Page 对 象 的 
容器 ， 而 不 是 在 显示 ASPNET 页 面 。 

不 过 ， 这 些 page 对 象 部 署 在 远程 Web 服 务 器 上 ，XBAP 可 以 轻松 地 对 它们 进行 版 本 化 和 更 新 ， 而 
不 需要 在 用 户 桌面 上 重新 部 署 可 执行 文件 。 与 传统 Web 程 序 类 似 ， 你 可 以 简单 地 更 新 Web 服 务 器 上 的 
Page 对 象 ， 用 户 访问 URL 时 将 得 到 “最 新 最 好 ”的 页 面 。 

这 种 形式 的 WPF 可 能 有 一 个 缺点 ，XBAP 必 须 承 载 于 微软 IE 或 FireFox 浏 览 器 中 。 如 果 我 们 在 公司 
局 域 网 中 部 署 这 样 的 XBAP， 浏 览 器 兼容 性 可 能 不 是 问题 ， 因 为 系统 管理 员 可 以 决定 用 户 的 机 器 上 需 
要 安装 哪个 浏览 器 。 然 而 ， 如 果 你 希望 外 部 世界 能 使 用 XBAP 的 话 ， 就 不 可 能 确保 每 一 个 终端 用 户 都 
使 用 IE 或 FireFox， 因 此 一 些 外 部 用 户 可 能 就 不 能 查看 我 们 的 WPF XBAP 应 用 程序 。 

男 一 个 要 注意 的 问题 是 ， 浏 览 XBAP 的 计算 机 必须 安装 .NET Framework， 因 为 page 对 象 需要 像 本 
地 运行 的 应 用 程序 那样 使 用 .NET 程 序 集 。 因 此 ，XBAP 仅 限于 Windows 操 作 系 统 ， 不 能 在 Mac OS X 或 
Linux 上 浏览 。 


27.2.4 WPF/Silverlight 关 系 


WPF 和 XAML 还 提供 了 一 个 叫做 Silverlight 的 基础 结构 , 用 于 WPF 技 术 的 跨 平台 和 跨 浏览 器 。 你 可 
以 将 Silverlight 看 成 是 Adobe Flash 的 竞争 者 , 它 使 用 的 是 C# 和 XAML ,而 不 是 新 的 工具 和 语言 Silverlight 
是 WPF 功 能 的 子 集 ， 可 以 为 大 型 HTML Web 页 面 构建 高 交互 性 的 插件 。 然 而 实际 上 ，Silverlight 是 .NET 平 
台 一 个 完全 独立 的 部 分 ， 它 包含 “迷你 ”的 CLR 和 .NET 基 础 类 库 的 “迷你 ”版 本 。 

与 XBAP 不 同 ， 用 户 计 算 机 不 必 完 整 安装 .NET Framework。 只 需要 安装 Silverlight 运 行 时 ， 浏 览 器 
就 可 以 自动 加 载 Silverlight 运 行 时 并 显示 Silverlight 应 用 程序 。 更 妙 的 是 ，Silverlight 插 件 不 局 限于 
Windows 操 作 系统 。 微 软 也 为 Mac OS X 创 建 了 Silverlight 运 行 时 。 

使 用 Silverlight， 我 们 可 以 构建 功能 非常 丰富 的 ( 交互 式 ) Web 应 用 程序 。 例 如 ， 和 和 WPF 相似 ， 
Silverlight 有 基于 向 量 的 图 形 系统 、 动 画 支 持 以 及 多 媒体 支持 。 此 外 ， 我 们 可 以 把 .NET 基 础 类 库 的 子 
集 集成 到 我 们 的 应 用 程序 中 。 这 个 子 集 包括 了 LINQ APTI. 泛 型 集合 、WCF 支 持 以 及 mscorlib.dll 子 集 ( 文 
件 IO 、XML 操 作 等 )。 


说 明 本 书 不 会 介绍 Silverlight, 但 是 大 部 分 WPF 知 识 会 直接 映射 到 SilverLight Web 插 件 的 构建 。 如 果 
你 希望 更 了 解 这 个 API 的 话 ， 可 以 访问 www.silverlight.net。 


27.3 ”WPF 程序 集 


不 管 我 们 希望 构建 何 种 类 型 的 WPF 应 用 程序 ，WPF 最 终 只 是 .NET 程 序 集中 包含 的 一 些 类 型 的 集 
合 。 表 27-3 描 述 了 用 于 构建 WPF 应 用 程序 的 主要 程序 集 ， 每 一 个 都 会 在 新 建 项 目的 时 候 被 引用 。 正 如 
你 期 望 的 那样 ，Visual Studio WPF 项 目 会 自动 引用 必要 的 程序 集 )。 
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表 27-3 WPF 核心 程序 集 


程 序 集 作 用 

PresentationCore.d]1 这 个 程序 集 定义 了 许多 构成 WPF GUI 层 基础 的 命名 空间 。 例 如 ， 这 个 程序 集 包 含 
了 WPF Ink API ( 用 于 Pocket PC 和 Tablet PC 笔 针 输入 的 编程 ) 的 支持 、 动 画 基 元 
以 及 几 个 图 形 演 染 类 型 

PresentationFramework.d]1 这 个 程序 集 包含 大 量 WPF 控 件 、Application 和 Window 类 、 对 交互 的 二 维 几 何 图 形 
的 支持 以 及 大 量 用 于 数据 绑 定 的 类 型 

System.Xam1.d]] 该 程序 集 提供 的 命名 空间 允许 在 运行 时 对 XAML 文 档 进行 编程 。 总 体 上 来 说 ， 只 
有 在 编写 WPF 支 持 工 具 或 需要 在 运行 时 完全 控制 XAML 时 ， 才 会 用 到 这 个 库 

WindowsBase.d]1 这 个 程序 集 定 义 了 构成 WPF API 基 础 结构 的 核心 类 型 ， 其 中 包括 表示 WPF 线 程 类 


型 、 安 全 类 型 、 各 种 类 型 转换 器 以 及 对 依赖 属性 和 路 由 事件 的 支持 ( 见 第 31 章 ) 


总 之 ， 这 4 个 程序 集 定义 了 许多 新 的 命名 空间 以 及 数 以 百 计 的 新 的 .NET 类 、 接 口 、 结 构 体 、 枚 举 
以 及 委托 。 你 可 以 查看 .NET Framework 4.5 SDK 文 档 来 了 解 全 部 细节 ， 表 27-4 列 出 了 你 需要 留意 的 部 
分 核心 命名 空间 的 作用 。 

| 表 27-4 ” WPF 核心 命名 空间 





命名 空间 作 用 

System.Windows 这 是 WPF 的 根 命名 空间 。 在 这 里 你 将 找到 所 有 WPF 桌 面 项 目 所 需要 的 核心 类 ( 如 
Application 类 和 Window 类 ) 

System.Windows.Controls 包括 用 于 构建 菜单 系统 、 工 具 提 示 以 及 众多 布局 管理 器 的 多 种 类 型 

System.Windows .Data 包含 用 于 WPF 数 据 绑 定 引擎 的 类 型 ， 并 且 支 持 数据 绑 定 模 板 

System.Windows.Documents 包含 用 于 文档 API 的 类 型 ， 可 以 通过 XML Paper Specification ( XPS ) 协议 , 在 WPF 
应 用 程序 中 集成 PDF 样 式 功能 

System.Windows.Ink 支持 Ink API， 可 用 于 捕获 手写 笔 或 鼠标 的 输入 ， 响 应 输入 笔 势 等 。 主 要 用 于 平板 
电脑 编程 ， 但 所 有 WPF 应 用 都 可 以 使 用 该 API 

System.Windows.Markup 这 个 命名 空间 定义 了 一 些 用 来 解析 和 编程 处 理 XAML 标 记 ( 以 及 等 价 的 二 进 制 格 
式 ，BAML ) 的 类 型 

System.Windows.Media 这 是 多 个 以 媒体 为 主 的 命名 空间 的 根 空间 。 在 这 些 命名 空间 中 ， 你 将 找到 那些 用 


于 动画 、 三 维 显 示 、 文 本 显示 以 及 其 他 多 媒体 用 途 的 类 型 
System.Windows.Navigation 这 个 命名 空间 提供 了 解释 XAML 浏 览 器 程序 (XBAP ) 和 需要 导航 页 面 模型 的 标准 
桌面 应 用 程序 所 用 的 导航 逻辑 的 多 种 类 型 
System.Windows. Shapes 这 个 命名 空间 定义 了 一 些 类 ， 人 允许 呈现 自动 响应 鼠标 输入 的 交互 式 二 维 图 形 


在 开始 介绍 WPF 编 程 模型 之 前 ， 我 们 先 来 研究 一 下 在 所 有 传统 桌面 开发 中 都 很 常见 的 System. 
Windows 命 名 空间 中 的 两 个 成 员 ，Application 类 和 Window 类 。 


说 明 如果 你 曾经 使 用 Windows Forms API 创 建 过 桌面 UI， 要 注意 System.Windows.Forms.* 和 System. 
Drawing.* 程 序 集 与 WPF 无 关 。 这 些 库 表示 原来 的 .NET GUI 工 具 一 一 Windows Forms/GDI+。 








896 第 27 章 WPF 和 XAML 


27.3.1 Application 类 的 作用 


System.Windows.Application 类 代表 了 一 个 运行 中 的 WPF 应 用 程序 的 全 局 实例 。 这 个 类 提供 了 一 个 
Run() 方 法 (用 以 启动 这 个 应 用 程序 )、 一 系列 可 处 理 的 事件 ( 如 Startup 和 Exit， 用 于 在 程序 生命 期 内 
与 其 进行 交互 ) 以 及 一 些 专 为 XAML 浏 览 器 程序 设置 的 成 员 ( 如 为 页 面 间 的 用 户 导 航 而 触发 的 事件 )。 
表 27-5 列 出 了 其 一 部 分 主要 成 员 。 


表 27-5 ”Application 类 型 的 关键 属性 


属 性 作 用 
Current 这 个 静态 属性 让 你 能 够 在 代码 中 的 任何 地 方 访问 正在 运行 的 Application 对 象 。 当 窗口 或 对 话 框 需 
要 访问 创建 它 的 Application 对 象 时 ， 特 别 是 访问 应 用 程序 范围 内 的 变量 和 函数 时 ，Current 很 有 用 











MainWindow 这 个 属性 允许 你 通过 编程 来 获取 或 设置 应 用 程序 的 主 窗口 

Properties 这 个 属性 使 你 可 以 建立 和 获取 整个 WPF 应 用 程序 中 可 以 访问 的 数据 ( 如 窗口 、 对 话 框 等 ) 

StartupUri 这 个 属性 可 以 获取 或 设置 一 个 URI， 指 定 在 应 用 程序 启动 时 自动 打开 的 窗口 或 页 面 

Windows 这 个 属性 返回 一 个 WindowCollection 类 型 , 通过 它 可 以 访问 由 创建 当前 Application 对 象 的 线程 所 创 
建 的 每 个 窗口 。 在 迭代 应 用 程序 的 每 个 打开 窗口 和 改变 其 状态 ( 如 最 小 化 所 有 窗口 ) 时 , 这 个 属性 
会 起 作用 


1. 构造 Application 类 

任何 WPF 应 用 程序 都 需要 定义 扩展 自 Application 的 类 。 在 该 类 中 , 你 将 定义 程序 的 入 口 点 (Main() 
方法 )， 创 建 该 子 类 的 实例 并 处 理 Startup 和 Exit 事 件 。 稍 后 ， 我 们 将 构建 完整 的 示例 项 目 ， 在 此 我 们 
先 来 看 一 个 快速 示例 : 

// 为 WPF 程 序 定义 全 局 应 用 程序 对 象 

class MyApp : Application 


[STAThread] 
static void Main(string[] args) 


{ 
// 创建 应 用 程序 对 象 
MyApp app = new MyApp(); 
// 注册 Startup/Exit 事 件 
app.Startup += (s, e) => { /* Start up the app */ }; 
app.Exit += (s, e) => { /* Exit the app */ }; 
} 
在 Startup 事 件 处 理 程序 中 , 通常 会 处 理 一 些 传人 的 命令 行 参数 , 并 启动 程序 的 主 窗 口 。Exit 事 件 
处 理 程序 可 以 为 程序 编写 任何 必要 的 关闭 逻辑 ( 如 保存 用 户 首选 项 ， 写 Windows 注 册 表 )。 
2. 枚 举 Windows 集 合 
Application 公 开 的 男 一 个 有 趣 的 属性 是 Windows ， 可 以 用 来 访问 当前 WPF 应 用 程序 加 载 到 内 存 中 
的 窗口 集合 。 在 新 建 Window 对 象 时 ， 会 自动 将 它们 添加 到 Application.Windows 集 合 。 下 面 的 示例 方法 
将 应 用 程序 中 的 所 有 窗口 最 小 化 ( 可 能 是 响应 用 户 触 发 的 键盘 手势 菜单 选项 ): 


27.3 WPF 程序 集 897 


static void MinimizeAllWindows() 
foreach (Window wnd in Application.Current.Windows) 
wnd.WindowState = WindowState.Minimized; 
1 } 
你 将 在 接 下 来 的 示例 中 创建 一 个 完整 的 派生 于 Application 的 类 型 。 在 那 之 前 , 让 我 们 先 来 查看 一 
下 Window 类 型 的 核心 功能 和 主要 的 WPF 基 类 。 


27.3.2 ”Window 类 的 作用 


System.Windows.Nindow 类 ( 位 于 PresentationFramework.dll 程 序 集 ) 表示 继承 自 Application 的 类 所 
拥有 的 一 个 窗口 ， 包 括 由 主 窗口 显示 的 所 有 对 话 框 。 可 能 你 已 经 想到 了 ，Window 类 有 一 系列 的 父 类 ， 
每 个 父 类 都 有 许多 功能 。 请 看 图 27-5 ， 其 中 显示 了 通过 Visual Studio 对 象 浏览 器 看 到 的 
System.Windows.Window 类 型 的 继承 关系 链 ( 以 及 实现 的 接口 )。 


Object Browser  X MainWindowxaml M inWindow Bs 0 
Browse: My Solution -| 




















<Search> 生 
4 indow| ~  @ Activate0 ^ 
4 困 8aseTypss ®, ArangeOQverride(System.Windows.Size} [ 
| 4 $y ContentControl ® Closel) 
| 4 Wo Control @ DragMovel) 
| 4 $s FrameworkElement @ GatWindow(System.Windows,Dependenc 
| b> “0 FrameworkinputElement @ Hide0 
| 9 HnputElement ®, MeasureOverride(System.Windows.Size) 
| “0 JQueryAmbient H, OnActivatedlSystem.EventArgs) | 
| “0 ISupportinitialize | Op su 县 SR | | 
| 
| “人 a public dass Window : 
System.Windows.Controls.ContentControl 
*0 HnputElement ES Member of System Windows 
4 Wy Visua | 过 
4 二 DependencyObject Summary: 
4 ts DispatcherObject provides the ability to create, configure, show, 
se Object and manage the lifetime of windows sand 
"0 IAddChild 司 dialog boxes. 


图 27-5 Window 类 的 层次 结构 


在 学 习 本 章 的 过 程 中 , 你 会 逐渐 理解 这 些 基 类 提供 的 各 种 功能 。 不 过 为 了 暂时 吊 一 下 大 家 的 胃口 ， 
后 面 的 几 节 将 分 解 每 个 基 类 的 作用 ( 要 了 解 完整 的 细节 ， 请 参见 .NET Framework 4.5 SDK 文 档 )。 

1. System.Windows.Controls.ContentControl 的 作用 

Window 类 的 直接 父 类 是 ContentControl 类 ， 而 该 类 是 所 有 WPF 类 中 最 迷人 的 。 这 个 基 类 为 它 派生 
的 类 型 提供 了 承载 内 容 ( 简单 地 说 ， 就 是 一 组 通过 Content 属 性 放 在 控件 表面 的 可 视 数据 ) 的 能 力 。 
WPF 内 容 模型 大 大 简化 了 自 定义 内 容 控 件 的 基本 外 观 。 

例如 ， 对 于 典型 的 “按钮 ”控件 ， 其 内 容 往 往 是 简单 的 字符 串 ( OK 、Cancel、Abort 等 )。 如 果 使 
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用 XAML 来 描述 WPF 控 件 , 并 希望 设置 Content 属 性 的 值 为 简单 字符 串 , 可 以 像 下 面 这 样 在 元 素 的 开放 
式 定义 中 设置 Content 属 性 (不必 担心 确切 的 标记 ): 


《1-- 在 开放 式 元 素 中 设置 Content 的 值 --> 
<Button Height="80" Width="100" Content="OK"/> 


说 明 ”也 可 以 在 C# 代 码 中 设置 Content 属 性 ， 这 样 就 可 以 在 运行 时 改变 控件 的 内 容 。 


但 是 ， 内 容 几 乎 可 以 是 任何 东西 。 例如， 假设 你 希望 “按钮 ”显示 更 有 趣 的 事情 而 不 仅仅 是 简单 
的 字符 串 ， 如 自 定 义 图 形 或 一 大 段 文本 。 在 Windows Forms 这 种 UI 框架 中 ， 你 需要 构建 自 定 义 控件 ， 
这 会 带 来 大 量 的 代码 ， 并 且 需 要 维护 一 个 新 类 。 使 用 WPF 内 容 模型 就 没有 必要 这 样 了 。 

如 果 不 希 望 Content 属 性 的 值 是 简单 的 字符 数组 ,那么 就 无 法 在 控件 的 开放 式 定义 中 用 特性 来 设置 
它 。 我 们 必须 在 元 素 的 作用 域内 隐 式 定义 内 容 数据 。 例 如 ， 以 下 的 <Button> 包 含 一 个 <stackPanel> 作 
为 其 内 容 ， 而 <StackPanel> 本 身 包 含 一 些 数 据 (确切 地 说 是 一 个 <Ellipse> 和 一 个 <Label> ): 


《<1-- 使 用 复杂 数据 隐 式 设置 Content 属 性 --> 
<Button Height="80" Width="100"> 
<StackPanel> 
<Ellipse Fill="Red" Width="25" Height="25"/> 
<Label Content ="OK!"/> 
</StackPanel> 
</Button> 


我 们 也 可 以 使 用 XML 的 属性 元 素 语法 来 设置 复杂 的 内 容 。 考 虑 如 下 功能 等 价 的 <Button> 定 义 ， 它 
使 用 属性 元 素 语法 设置 Content 属 性 ( 在 本 章 中 你 会 发 现 更 多 有 关 XAML 的 信息 , 在 这 里 不 要 过 多 关注 
细节 ): 


《<1-- 使 用 属性 元 素 语法 设置 Content 属 性 --> 
<Button Height="80" Width="100"> 
<Button.Content> 
<StackPanel> 
<Ellipse Fill="Red" Width="25" Height="25"/> 
<Label Content ="OK!"/> 
</StackPanel> 
</Button.Content> 
</Button> 


但 请 务必 注意 ， 并 不 是 每 个 WPF 控 件 都 派生 自 ContentControl 类 ， 因 此 并 不 是 所 有 控件 都 支持 这 
种 独特 的 内 容 模 型 (但 大 多 数 都 支持 )。 同 样 ， 一 些 WPF 控 件 改进 了 刚才 介绍 的 基本 内 容 模型 。 第 28 
章 将 详细 介绍 WPF 内 容 的 作用 。 

2. System.Windows.Controls.Control 的 作用 

不 同 于 ContentControl 类 ， 所 有 WPF 控 件 都 共享 Control 基 类 ， 并 将 其 作为 公共 的 父 类 。 这 个 基 类 
提供 了 众多 负责 基本 UI 功能 的 核心 成 员 。 例 如 ，Control 类 定义 了 多 种 属性 ， 用 于 设置 控件 大 小 、 透 
明度 、 焦 点 切换 顺序 逻辑 、 光 标 显 示 、 背 景 颜色 ,等 等 。 此 外 ,这 个 父 类 还 提供 了 对 模板 服务 的 支持 。 
如 第 30 章 中 所 示 ，WPF 控 件 可 以 使 用 模板 和 样式 动态 地 改变 它们 的 外 观 。 表 27-6 按 功能 相关 性 分 类 ， 
列 出 了 Control 类 型 的 主要 成 员 。 
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表 27-6 ”Control 类 型 的 核心 成 员 


成 员 


作 用 








Background、Foreground、BorderBrush、Border- 
Thickness 、Padding、HorizontalContentAlignment 
和 VerticalContentAlignment 


FontFamily、 FontSize 、FontStretch 和 Fontweight 
IsTabstop 和 TabIndex 


MouseDoubleClick 和 previewMouseDoubleClick 


Template 


这 些 属性 允许 我 们 进行 有 关 控 件 如 何 被 呈现 和 定位 的 基本 
设置 


这 些 属 性 控制 各 种 字体 相关 的 设置 
这 些 属性 用 于 创建 窗口 上 控件 之 间 的 Tab 次 序 
这 些 事件 处 理 组 件 的 双击 行为 


这 个 属性 用 来 获取 和 设置 可 用 于 改变 控件 泻 染 输出 的 控件 
模板 


3. System.Windows .FrameworkElement 的 作用 
基 类 提供 了 许多 在 WPF 框 架 中 都 会 用 到 的 底层 成 员 ， 可 用 于 支持 情节 提要 ( 在 动画 中 使 用 )、 数 
据 绑 定 以 及 命名 成 员 ( 通过 Name 属 性 )， 获 取 由 派生 类 型 定义 的 资源 ， 创 建 派生 类 型 的 整体 大 小 。 





表 27-7 列 出 了 主要 的 成 员 。 
表 27-7 FrameworkElement 类 型 的 主要 成 员 
成 员 作 用 


ActualHeight 、ActualWidth、MaxHeight 、MaxWidth、 
MinHeight 、MinWidth 、Height 和 width 

ContextMenu 

Cursor 

HorizontalAlignment 和 VerticalAlignment 

Name 


Resources 


ToolTip 


控制 派生 类 型 的 大 小 


获取 或 设置 和 派生 类 型 关联 的 弹出 菜单 

获取 或 设置 和 派生 类 型 关联 的 鼠标 指针 

控制 类 型 如 何在 容器 中 定位 ( 如 面板 或 列表 框 ) 

允许 为 类 型 赋 一 个 名 字 ， 这 样 就 可 以 在 代码 文件 中 访问 其 功能 


提供 了 对 任何 由 类 型 定义 的 资源 的 访问 ( 对 于 WPF 资 源 系统 的 
研究 ， 见 第 30 章 ) 
获取 或 设置 和 派生 类 型 关联 的 工具 提示 





4. System.Windows .UIElement 的 作用 


在 Window 继 承 链 的 所 有 类 型 中 ，UIElement 基 类 提供 的 功能 最 多 。UIElement 的 主要 任务 是 提供 一 
组 可 以 允许 其 子 类 获取 焦点 并 处 理 输 入 请 求 的 事件 。 比 如 ， 该 类 提供 了 许多 负责 拖 放 、 鼠 标 移动 、 键 
盘 输入 和 笔 输入 〈 为 Pocket PC 与 Tablet PC 提供 的 ) 等 的 操作 事件 。 

第 29 章 会 深入 研究 WPF 事 件 模型 ， 不 过 你 对 许多 核心 事件 应 该 感到 很 熟悉 ( MouseMove 、KeyUp、 
MouseDown 、MouseEnter 、MouseLeave 等 )。 除 了 定义 许多 事件 之 外 ， 父 类 还 提供 了 许多 属性 来 处 理 控件 
焦点 、 启 用 状态 、 可 见 性 以 及 命中 测试 逻辑 ， 如 表 27-8 所 示 。 
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表 27-8 ”UIElement 类 型 的 核心 成 员 


成 员 作 用 
Focusable 和 IsFocused 这 些 属性 用 来 设置 某 个 派生 类 型 的 焦点 
IsEnabled 这 些 属性 用 来 控制 某 个 派生 类 型 是 否 启 用 
IsMouseDirect1yOver 和 IsMouse0ver 这 些 属性 提供 了 简单 的 方式 来 进行 命中 测试 逻辑 
IsVisible 和 visibility 这 些 属性 用 来 对 派生 类 型 进行 可 见 性 设置 
RenderTransform 这 些 属性 用 来 创建 会 用 于 泻 染 派生 类 型 的 转换 


5. System.Windows .Media.Visual 的 作用 

Visual 类 提供 了 WPF 中 的 核心 显示 支持 ， 包 括 图 像 数 据 的 命中 测试 、 坐 标 变换 以 及 边框 计算 。 事 
实 上 ，Visual 类 与 DirectX 子 系统 交互 ， 并 在 屏幕 上 绘制 数据 。 第 29 章 中 会 介绍 ，WPF 提 供 了 3 个 可 能 
的 形式 用 来 泻 染 图 形 数据 ， 每 一 个 在 功能 和 性 能 上 都 不 一 样 。 使 用 Visual 类 型 ( 及 其 子 类 型 ， 如 
DrawingVisual ) 提 供 了 最 轻 量 的 方式 来 浑 染 图 形 数据 , 但 是 需要 很 多 手动 代码 来 处 理 所 有 必要 的 服务 。 
同样 ， 更 多 细节 见 第 29 章 。 

6. System.Windows.Dependencyobject 的 作用 

WPF 支 持 一 类 称 为 依赖 属性 的 特殊 属性 。 简 单 地 讲 ， 这 种 属性 风格 提供 额外 的 代码 ， 可 以 使 属性 
响应 多 种 WPF 技 术 ， 如 样式 、 数 据 绑 定 、 动 画 等 。 为 了 让 类 型 支持 这 个 新 的 属性 架构 ， 类 型 就 需要 从 
Dependency0bject 基 类 派生 。 虽 然 依赖 属性 是 WPF 开 发 的 重点 ， 但 大 多 数 情况 下 它们 的 细节 都 被 隐藏 了 。 
第 28 章 会 深入 讨论 依赖 属性 。 

7. System.Windows.Threading.DispatcherObject 的 作用 

Window 类 型 的 最 后 一 个 基 类 ( 除了 System.0bject 类 ， 对 此 我 认为 不 需要 在 这 里 给 出 更 多 的 解释 ) 是 
DispatcherObject 。 这 个 类 型 提供 了 一 个 有 趣 的 属性 Dispatcher， 它 可 以 返回 相关 联 的 Systenm. 
Windows.Threading.Dispatcher 对 象 。 这 个 Dispatcher 类 是 WPF 应 用 程序 事件 队列 的 入 口 点 , 它 提供 了 用 于 
处 理 并 发 和 线程 的 基本 构造 。 


27.4 ”创建 不 使 用 XAML 的 WPF 应 用 程序 


考虑 到 所 有 的 功能 都 是 由 Window 类 型 的 父 类 提供 的 ， 在 应 用 程序 中 可 以 通过 直接 创建 一 个 Window 
对 象 , 或 将 其 用 作 一 个 强 类 型 子 类 的 父 类 的 方式 来 表示 一 个 窗 体 。 让 我 们 在 下 面 这 段 代 码 示例 中 探讨 
一 下 这 两 种 方式 。 虽 然 大 部 分 WPF 应 用 程序 都 会 使 用 XAML， 但 这 完全 是 可 选 的 。XAML 能 够 表现 的 
任何 东西 都 完全 可 以 通过 代码 来 表现 ， 反 之 亦 然 。 如 果 你 愿意 ， 可 以 使 用 底层 的 对 象 模型 和 过 程 代 码 
创建 一 个 完整 的 WPF 项 目 工程 。 

举例 说 明 , 让 我 们 直接 使 用 Application 类 和 Window 类 而 不 使 用 XKAML 来 创建 一 个 最 简化 的 完整 的 
应 用 程序 。 先 创建 一 个 新 控制 台 应 用 程序 WpfAppAllCode( 不 必 担 心 , 本 章 后 面 将 使 用 Visual StudioWPF 
项 目 模 板 )。 接 着 ， 访 问 Project 一 AddReference 菜 单项 打开 AddReference 对 话 框 ， 并 添加 对 
WindowsBase.dll 、PresentationCore.dll 、System.Xaml.dll 和 PresentationFramework.dll 的 引用 。 

现在 ,， 用 下 述 代 码 更 新 初始 的 C# 文 件 , 它 将 创建 有 适量 功能 的 窗 体 ( 这 里 我 只 显示 了 必须 引入 来 
编译 代码 的 命名 空间 ， 请 自行 忽略 那些 自动 添加 的 using 语 句 ): 
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// 不 使 用 XAML 写 的 一 个 简单 的 WPF 应 用 程序 
using System; 

using System.Windows; 

using System.Windows.Controls; 


namespace WpfAppAllCode 
// 在 这 第 一 个 示例 中 ， 为 了 表示 应 用 程序 本 身 和 其 主 窗口 ， 我 们 定义 了 一 个 简单 的 类 


class Program : Application 


[STAThread] 
static void Main(string[] args) 


// 处 理 Startup 和 Exit 事 件 ， 随 后 运行 应 用 程序 
Program app = new Program(); 
app.Startup += AppStartUp; 
app.Exit += AppExit; 
app.Run(); // 触发 Startup 事 件 
} 


static void AppExit(object sender, ExitEventArgs e) 


MessageBox.Show("App has exited"); 


static void AppStartUp(object sender, StartupEventArgs e) 


// 创建 一 个 Nindow 对 象 ， 同 时 设置 一 些 基本 属性 

Window mainWindow = new Window(); 

mainWindow.Title = "My First WPF App!"; 

mainWindow.Height = 200; 

mainWindow.Width = 300; 

mainWindow.WindowStartupLocation = WindowStartupLocation.CenterScreen; 
mainWindow. Show(); 


说 明 WPF 应 用 程序 的 Main() 方 法 必须 标记 [STAThread] 特 性 ， 这 能 确保 应 用 程序 所 用 的 所 有 遗留 
COM 对 象 都 是 线程 安全 的 。 否 则 ， 将 会 引发 运行 时 异常 。 


请 注意 ，Program 类 扩展 了 System.Windows.Application 类 。 在 这 个 类 型 的 Main() 方 法 中 ， 我 们 创 
建 了 一 个 应 用 实例 , 并 且 使 用 方法 组 转换 的 语法 处 理 了 startup 和 Exit 事 件 。 回想 一 下 第 10 章 所 学 的 内 
容 , 这 种 简写 方法 无 须 手 工 指定 对 应 的 委托 。 当 然 , 如 果 你 愿意 , 你 可 以 直接 用 名 字 指 定 对 应 的 委托 。 

在 下 面 这 个 经 过 修改 的 Main() 方 法 中 , 请 注意 startup 事 件 被 连接 到 了 StartupEventHandler 这 个 委 
托 上 ， 而 这 个 委托 只 能 指向 以 0bject 对 象 作 为 第 一 个 参数 ， 并 以 StartupEventArgs 作 为 第 二 个 参数 的 
那些 方法 。 另 一 方面 ，Exit 事 件 与 ExitEventHandler 这 个 委托 协作 ， 这 个 委托 要 求 其 指向 的 方法 必须 
以 一 个 ExitEventArgs 类 型 作为 第 二 个 参数 。 

[STAThread] 

static void Main(string[] args) 


{ 
// 这 一 次 ， 指 定 对 应 的 委托 
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Program app = new Program(); 

app.Startup += new StartupEventHandler(AppStartUp); 
app.Exit += new ExitEventHandler(AppExit); 
app.Run(); // 触发 Startup 事 件 


AppStartup() 方 法 被 配置 后 ， 用 来 创建 Window 对 象 ， 建 立 一 些 非常 基本 的 属性 设置 , 并 调用 Show() 
方法 来 在 屏幕 上 显示 这 个 无 模式 风格 (ShowDialog() 方 法 可 以 用 来 启动 一 个 模式 对 话 框 ) 的 窗 体 。 而 
AppExit() 方 法 只 是 简单 地 利用 了 WPF 中 的 MessageBox 类 ， 在 程序 被 终止 时 显示 一 条 诊断 信息 。 

执行 这 个 程序 ， 你 会 看 到 一 个 非常 简单 的 主 窗 体 ， 它 可 被 最 小 化 、 最 大 化 和 关闭 。 为 了 增加 一 些 
趣味 性 , 我 们 还 要 再 加 入 一 些 用 户 界面 元 素 。 不 过 在 我 们 这 样 做 之 前 , 让 我 们 先 来 将 代码 库 加 以 重 构 ， 
使 之 成 为 一 个 强 类 型 的 、 封 装 良好 的 Window 派 生 类 。 


27.4.1 创建 强 类 型 的 Window 类 


目前 ,我们 的 Application 派 生 类 在 应 用 程序 启动 时 直接 创建 一 个 Window 类 型 的 实例 ,理想 状况 下 ， 
我 们 应 当 创 建 一 个 继承 自 Window 类 的 类 以 封装 它 的 外 观 和 功能 。 假 设 我 们 已 经 在 当前 的 WpfAppCode 命 
名 空间 中 创建 了 如 下 类 定义 ( 如 果 在 新 的 C# 文 件 放 置 这 个 类 ， 一 定 要 导入 System.Windows 命 名 空间 ): 


class MainWindow : Window 
public MainWindow(string windowTitle, int height, int width) 


this.Title = windowTitle; 
this.WindowStartupLocation = WindowStartupLocation.CenterScreen; 
this.Height = height; 
this.Width = width; 
} 
现在 我 们 可 以 更 新 startup 事 件 处 理 程序 , 简单 地 直接 创建 一 个 MainWindow 类 型 的 实例 , 如 下 所 示 : 


static void AppStartUp(object sender, StartupEventArgs e) 


// 创建 一 个 MainWindow 对 象 
MainWindow wnd = new MainWindow("My better WPF App!", 200, 300); 
wnd. Show(); 


当 程序 被 重新 编译 和 执行 后 ,输出 是 相同 的 。 这 样 做 一 个 明显 的 好 处 就 是 我 们 现在 可 以 在 一 个 强 
类 型 的 表示 主 窗 体 的 类 的 基础 之 上 开始 我 们 的 工作 了 。 





说 明 当 你 创建 一 个 Window (或 者 派生 自 NWindow ) 的 对 象 时 ， 它 将 被 自动 加 入 到 Application 类 的 
Windows 集 合 中 (这 是 通过 Nindow 类 本 身 的 一 些 构 造 函数 遇 辑 实现 的 )。 因此， 现在 可 以 在 内 存 
中 通过 Application.Windows 属 性 迭代 Nindow 对 象 列表 。 





27.4.2 创建 简单 的 用 户 界 面 
问 C# 代 码 中 的 Window 添 加 UI 元 素 ( 如 Button )， 步 又 如 下 所 示 。 
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(1) 定义 一 个 成 员 变量 来 代表 所 需 的 控件 ; 

(2) 在 创建 Window 时 配置 这 个 控件 的 外 观 和 行为 ; 

(3) 将 控件 分 配给 继承 的 Content 属 性 ， 或 作为 AddChild() 方 法 的 参数 。 

WPF 控 件 的 内 容 模型 要 求 只 能 为 一 个 元 素 设置 Content 属 性 。 当 然 ， 只 包含 单一 UI 控件 的 Window 
是 没什么 用 的 。 因 此 ,几乎 在 所 有 情况 下 ， 分 配给 Content 属 性 的 “单一 内 容 ” 实 际 上 是 一 个 布局 管理 
器 ， 如 Dockpanel 、Grid、Canvas 或 StackpPanel。 在 布局 管理 器 内 ， 可 以 对 控件 进行 任意 组 合 ， 甚 至 可 
以 内 藤 另 一 个 布局 管理 器 (关于 WPF 开 发 的 这 方面 内 容 ， 详 见 第 28 章 )。 

现在 ， 我 们 在 这 个 Window 派 生 类 中 添加 一 个 Button 控 件 。 单 击 该 按钮 将 关闭 当前 窗口 ， 这 会 间接 
终止 应 用 程序 ， 因 为 内 存 中 已 经 没有 其 他 窗口 了 。 请 思考 下 面 这 段 对 MainWindow 类 的 更 新 的 代码 ( 确 
保 导 入 System.Windows.Controls 以 便 可 以 访问 Button 类 ): 


class MainWindow : Window 


// 我 们 的 UI 元 素 
private Button btnExitApp = new Button(); 


public MainWindow(string windowTitle, int height, int width) 


// 配置 按钮 并 设置 子 控件 

btnExitApp.Click += new RoutedEventHandler(btnExitApp Clicked); 
btnExitApp.Content = "Exit Application"; 

btnExitApp.Height = 25; 

btnExitApp.Width = 100; 


// 将 窗 体 的 内 容 设置 为 一 个 按钮 
this.Content = btnExitApp; 


// 配置 窗 体 

this.Title = windowTitle; 

this.WindowStartupLocation = WindowStartupLocation.CenterScreen; 
this.Height = height; 

this.Width = width; 

this. Show(); 


private void btnExitApp Clicked(object sender, RoutedEventArgs e) 


{ 
// 关闭 窗 体 
this.Close(); 

} 

但 是 请 务必 注意 ， 这 个 WPF 按 钮 的 Click 事 件 与 一 个 名 为 ReutedEventHandler 的 委托 相 协 作 ， 你 当 
然 会 问 , “什么 是 路 由 事件 ? ”你 将 在 第 28 章 学 习 这 个 新 的 WPF 事 件 模型 。 现 在 只 需要 了 解 
RoutedEventHandler 委 托 的 目标 必须 提供 一 个 object 作 为 第 一 个 参数 ，RoutedEventArgs 作 为 第 二 个 
参数 。 

不 管 怎 么 样 ， 编 译 并 运行 这 个 应 用 程序 后 ， 就 可 以 发 现 如 图 27-6 所 示 的 自 定义 窗口 。 注 意 我 们 
的 按钮 自动 放 在 了 窗口 客户 端 区 域 的 正中 间 ， 对 于 没有 放 到 WPF 面 板 类 型 中 的 内 容 来 说 ， 这 是 默认 
行为 。 
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图 27-6 “一 个 用 100%C# 吾 言 编写 的 简单 的 WPF 应 用 程序 


27.4.3 与 应 用 程序 级 别 的 数据 交 


回忆 一 下 ，Application 类 定义 了 一 个 叫 Properties 的 属性 ， 它 允许 我 们 通过 类 型 索引 器 定义 一 个 
名 称 / 值 对 的 集合 。 因 为 这 个 索引 需 被 定义 为 操作 System.0bject 类 型 ， 所 以 我 们 可 以 在 这 个 集合 中 保 
存 任何 项 (包括 自 定义 类 )， 之 后 使 用 友好 名 来 获取 。 使 用 这 个 方式 ， 就 可 以 在 WPF 应 用 程序 中 跨越 
所 有 窗口 来 共享 数据 。 

为 了 演示 , 我 们 更 新 当前 的 Startup 事 件 处 理 程序 来 检查 传人 的 命令 行 参数 中 叫 /GODMODE 的 值 ( 许 
多 PC 视频 游戏 的 作 次 码 )。 如 果 我 们 找到 了 这 样 的 标识 ， 就 在 属性 集合 中 以 相同 名 字 创 建 一 个 bool 值 
并 设置 为 true ( 否则 设置 值 为 false )。 

听 上 去 很 简单 ， 但 是 还 有 一 个 问题 ， 那 就 是 我 们 怎么 把 命令 行 参数 (一般 从 Main() 方 法 中 获得 ) 
传 给 startup 事 件 处 理 程序 呢 ? 一 个 方法 是 调用 静态 的 Environment .GetCommandLineArgs() 方 法 。 然 而 ， 
这 些 参 数 会 自动 加 到 传人 的 StartupEventArgs 参 数 中 并 且 可 以 通过 Args 属 性 直接 获取 。 那 么 ， 这 里 就 
是 我 们 的 首次 更 新 : 


private static void AppStartUp(object sender, StartupEventArgs e) 


// 检查 传 入 的 命令 行 参数 来 看 是 否 它们 指定 了 /GODMODE 标 识 
Application.Current.Properties["GodMode"] = false; 
foreach(string arg in e.Args) 


if (arg.ToLower() == "/godmode") 


Application.Current.Properties["GodMode"] = true; 
break; 


// 创建 一 个 MainWindow 对 象 
MainWindow wnd = new MainWindow("My better WPF App!", 200, 300); 
应 用 程序 范围 数据 可 以 在 WPF 应 用 程序 中 的 任何 地 方 进行 访问 。 我 们 需要 做 的 只 是 (通过 
Application.Current ) 获取 指向 全 局 应 用 程序 对 象 的 访问 点 并 且 查 看 集合 。 例 如 ,我们 可 以 这 样 更 新 
主 窗口 Button 类 型 的 Click 事 件 处 理 程序 : 
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private void btnExitApp Clicked(object sender, RoutedEventArgs e) 
// 用 户 启 动 了 /godmode 吗 
if((bool)Application.Current.Properties["GodMode" |]) 

MessageBox.Show("Cheater!"); 


this.Close(); 


这 样 ， 如 果 用 户 按 如 下 所 示 启 动 程序 : 
WpfAppAllCode.exe /godmode 
他 就 会 在 应 用 程序 终止 时 看 到 一 个 丢脸 的 对 话 框 。 





说 明 ”你 可 以 在 Visual Studio 中 提供 命令 行 参数 。 双 击 Solution Explorer 中 的 Properties 图 标 ， 在 弹出 的 
编辑 器 中 单 击 Debug 选 项 卡 ， 在 Command line arguments 框 中 输入 /godmode。 





27.4.4 处理 Window 对 象 的 关闭 


终端 用 户 可 以 使 用 许多 内 置 的 系统 级 别 的 技术 来 关闭 窗口 (如 单 击 窗口 框架 的 X 关 闭 按钮 )， 或 者 间 
接 调 用 Close() 方 法 来 响应 一 些 用 户 交 互 元 素 ( 如 File 一 Exit )。 不 管 怎样 ， 可 以 拦截 WPF 提 供 的 两 个 事 
件 来 检测 用 户 是 否 真 的 要 关闭 窗口 并 且 从 内 存 中 移 除 。 第 一 个 事件 是 Closing， 它 和 CancelEventHandler 
委托 一 起 使 用 。 

这 个 委托 期 望 目标 方法 接受 System.ComponentModel.CancelEventArgs 作 为 第 二 个 参数 。 
CancelEventArgs 提 供 了 Cancel 属 性 ， 将 它 设置 为 ture 可 以 防止 窗口 真正 关闭 ( 如果 你 问 用 户 是 否 真 的 
希望 关闭 窗口 或 需要 保存 它们 工作 的 话 就 有 用 )。 

如 果 用 户 确 实 希望 关闭 窗口 ， 可 以 把 cancelEventArgs.Cancel 设 置 为 fale (默认 ) 。 然 后 就 会 触发 
Closed 事 件 ( 和 System.EventHandler 委 托 一 起 使 用 )， 这 个 时 候 窗 口 就 会 真正 关闭 。 

向 当前 构造 函数 中 添加 下 列 代 码 语句 来 更 新 MainWindow 类 ,以 便 处 理 这 两 个 构造 函数 ,如 下 所 示 : 


public MainWindow(string windowTitle, int height, int width) 
{ 


this.Closing += MainWindow Closing; 
this.Closed += MainWindow Closed; 


} 
现在 ， 按 如 下 所 示 实 现 相应 的 事件 处 理 程序 : 


private void MainWindow Closing(object sender, 
System.ComponentModel .CancelEventArgs e) 


// 用 户 是 否 真正 希望 关闭 这 个 窗口 
string msg = "Do you want to close without saving?"; 
MessageBoxResult result = MessageBox.Show(msg, 

"My App”, MessageBoxButton.YesNo, MessageBoxImage.Warning); 
if (result == MessageBoxResult.No) 


{ 
// 如 果 用 户 不 希望 关闭 ， 则 取消 关闭 
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e.Cancel = true; 


private void MainWindow Closed(object sender, EventArgs e) 


MessageBox.Show("See ya!l"); 


现在 运行 程序 ， 并 通过 单 击 窗口 右上 角 的 “x ”图 标 或 按钮 控件 来 关闭 窗口 。 你 将 看 到 如 图 27-7 
所 示 的 确认 对 话 框 。 








My App 









F Do you want to close without saving? 





图 27-7 ”捕获 Window 的 Closing 事 件 
单 击 Yes 按 钮 ， 应 用 程序 将 被 关闭 。 单 击 No 按钮 ， 窗 口 将 仍然 保留 在 内 存 中 。 


27.4.5 “拦截 鼠标 事件 


WPF API 提 供 了 我 们 可 以 捕获 的 事件 来 和 鼠标 交互 。 具 体 而 言 ，UIElement 基 类 定义 了 许多 鼠标 相 
关 的 事件 ， 如 MouseMove 、MouseUp 、MouseDown 、MouseEnter 、MouseLeave 等 。 

例如 ， 处 理 MouseMove 事 件 。 这 个 事件 和 System.Windows.Input.MouseEventHandler 委 托 一 起 使 用 ， 
它 期 望 其 目标 接受 System.Windows.Input.MouseEventArgs 类 型 作为 第 二 个 参数 。 使 用 MouseEventArgs ， 
我 们 可 以 提取 出 鼠标 的 (x, y) 位 置 以 及 其 他 细节 。 考 虑 如 下 部 分 定义 : 


public class MouseEventArgs : InputEventArgs 


public Point GetPosition(IInputElement relativeTo); 
public MouseButtonState LeftButton { get; } 

public MouseButtonState MiddleButton { get; } 
public MouseDevice MouseDevice { get; } 

public MouseButtonState RightButton { get; } 
public StylusDevice StylusDevice { get; } 

public MouseButtonState XButton1 { get; } 

public MouseButtonState XButton2 { get; } 


说 明 XButton1 和 XButton2 属 性 用 来 与 “和 鼠标 扩展 按钮 ”交互 (如 某 些 鼠标 的 “next” 和 “previous” 
按钮 )。 它 们 常用 于 浏览 器 的 历史 列表 ， 可 以 在 访问 过 的 页 面 之 间 进行 导航 。 
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GetPosition() 方 法 允许 我 们 获取 窗口 上 相对 UI 元 素 的 (x, y) 值 。 如 果 你 对 捕获 相对 激活 窗口 的 位 置 
有 兴趣 的 话 ， 只 需要 传人 this。 在 MainWindow 类 的 构造 函数 中 人 处理 MouseMove 事 件 ， 如 下 所 示 : 


public MainWindow(string windowTitle, int height, int width) 


this.MouseMove += MainWindow MouseMove; 


这 里 是 MouseMove 的 事件 处 理 程序 ， 它 会 在 窗口 的 标题 区 域 中 显示 鼠标 的 位 置 ( 注意 ， 我 们 通过 
ToString() 把 返回 的 Point 类 型 转换 成 字符 串 ): 


private void MainWindow MouseMove(object sender, 
System.Windows.Input.MouseEventArgs e) 


// 将 窗口 的 标题 设置 为 鼠标 当前 的 (xy) 
this.Title = e.GetPosition(this).ToString(); 


} 


27.4.6 ”拦截 键盘 事件 


处 理 当前 窗 体 的 键盘 事件 仍然 很 简单 -UIElement 定 义 了 许多 我 们 可 以 捕获 的 事件 来 拦截 活动 元 素 
上 的 键盘 敲 击 ( 如 KeyUp、KeyDown 等 ), KeyUp 和 KeyDown 事 件 都 和 System.Windows.Input.KeyEventHandler 
委托 一 起 使 用 ， 它 期 望 目 标的 第 二 个 事件 处 理 程 序 是 KeyEventArgs 类 型 的 ， 它 定义 了 几 个 有 趣 的 公共 
属性 ， 如 下 所 示 : 


public class KeyEventArgs : KeyboardEventArgs 


public bool IsDown { get; } 

public bool IsRepeat { get; } 
public bool IsToggled { get; } 
public bool IsUp { get; } 

public Key Key { get; } 

public KeyStates KeyStates { get; } 
public Key SystemKkey { get; } 


我 们 使 用 下 面 的 代码 来 演示 对 MainWindow 构 造 函 数 中 添加 的 KeyDown 事 件 的 处 理 ( 与 前 面 的 那些 事 
件 一 样 )， 它 用 当前 按键 的 值 修改 按钮 的 内 容 : 


private void MainWindow KeyDown(object sender, System.Windows.Input.KeyEventArgs e) 


// 显示 按钮 上 的 按键 
btnExitApp.Content = e.Key.ToString(); 


双击 Solution Explorer 的 Properties 图 标 ， 在 Application 选 项 卡 中 将 Output Type 设置 为 Windows 
Application， 这 样 可 以 避免 启动 控制 台 窗 口 。 图 27-8 显 示 了 第 一 个 WPF 程 序 的 最 终 情 况 。 

至 此 ，WPF 看 上 去 只 是 一 个 新 的 GUI 框 架 ， 它 ( 只 不 过 ) 提供 了 和 Windows Forms 、MFC 或 VB6 
相同 的 服务 。 如 果真 是 这 样 的 话 ， 你 肯定 要 质疑 男 一 个 UI 工具 包 存 在 的 意义 。 为 了 真正 看 到 WPF 的 独 
特 之 处 ， 需 要 理解 新 的 基于 XML 的 语法 ，XAML。 
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图 27-8 ”第 一 个 WPF 程 序 ， 百 分 之 百 不 含 XAML 


源 代码 ”WpfAppAllCode 项 目的 源 代码 位 于 Chapter 27 子 目录 下 。 


27.5” 仅 使 用 XAML 构建 WPF 应 用 程序 


典型 的 WPF 应 用 程序 并 不 像 第 一 个 示例 那样 完全 由 代码 组 成 。 相 反 ，C# 代 码 文件 将 与 相关 的 
XAML 源 文件 成 对 出 现 ， 它 们 表示 给 定 的 Window 或 Application 的 整体 ， 以 及 其 他 还 没有 介绍 的 类 型 ， 
如 UserControl 和 Page。 

这 种 方法 称 为 构建 WPF 应 用 程序 的 代码 文件 法 ， 本 书 其 余 WPF 相 关 的 部 分 将 广泛 使 用 这 种 技术 。 
但 在 这 之 前 , 我们 先 来 演示 如 何 只 用 XAML 文 件 构建 WPF 应 用 程序 。 尽管 并 不 推荐 这 种 “100% XAML” 
的 方法 ， 但 这 有 助 于 你 理解 有 多 少 标记 被 转换 为 相应 的 C# 代 码 ， 并 最 终 编 译 为 ,NET 程序 集 。 


说 明 下 面 的 示例 会 用 到 很 多 XAML 技 术 , 这 将 在 后 面 正 式 介绍 , 因此 如 果 遇 到 不 熟悉 的 语法 请 不 必 
担心 。 你 可 以 简单 地 将 文件 加 载 到 文本 编辑 器 中 查看 ， 但 别 使 用 Visual Studio。 下 面 示例 中 的 
一 些 XAML 无 法 在 Visual Studio 可 视 化 设计 器 中 显示 。 


一 般 来 说 ,，XAML 文 件 包 含 描述 窗口 外 观 的 标记 ， 而 C# 人 代码 文件 包含 实现 逻辑 。 例 如 ，Window 的 
XAML 文 件 会 描述 整个 布局 系统 及 其 内 部 的 控件 ,指定 不 同事 件 处 理 程序 的 名 称 。 而 相关 的 C# 文 件 则 
包含 这 些 事件 处 理 程序 的 实现 逻辑 和 应 用 程序 所 需 的 自 定义 代码 。 

XAML( Extensible Application Markup Language, 可 扩展 应 用 程序 标记 语言 ) 是 一 套 新 的 基于 XML 
的 语法 , 它 人 允许 你 通过 标记 来 定义 一 个 .NET 类 型 的 状态 ( 也 可 以 是 功能 )。 虽 然 XAML 往 往 用 于 为 WPF 
创建 UI[， 事实 上 它 可 以 用 来 描述 任何 非 抽 象 的 .NET 类 型 树 ( 包括 你 在 自 定 义 的 .NET 程 序 集中 定义 的 
自 定义 类 型 ), 前 提 是 每 个 类 型 都 提供 一 个 默认 的 构造 函数 。 你 将 会 看 到 ， 在 一 个 *.xaml 文 件 中 建立 的 
标记 会 被 转化 为 一 个 直接 映射 到 相关 的 .NET 命 名 空间 中 的 一 个 完整 的 对 象 模 型 。 

因为 XAML 是 基于 XML 的 语法 ， 我 们 获得 了 XML 带 给 我 们 的 所 有 好 处 与 坏处 。 从 好 的 方面 来 说 ， 


27.5” 仅 使 用 XAML 构建 WPF 应 用 程序 909 


XAML 文 件 具 有 非常 好 的 自 描述 性 ( 就 像 任何 XML 文档 一 样 ),。 一 般 来 讲 ，XAML 文 件 中 的 每 个 元 素 都 
代表 某 个 .NET 命 名 空间 中 的 一 个 类 型 名 称 ( 例如 Button、Window 或 者 Application )。 一 个 起 始 元 素 范围 
内 的 特性 (一 般 说 来 ) 将 映射 到 这 个 特定 类 型 的 特性 (Height、Width 等 ) 和 事件 ( Startup、Click 等 )。 

由 于 XAML 只 是 定义 对 象 状态 的 一 种 声明 方式 ， 还 可 以 通过 标记 或 程序 代码 来 定义 一 个 WPF 组 
件 。 例 如 ， 如 下 所 示 的 XAML: 


<1-- 使 用 XAML 定 义 一 个 WPF 按 钮 --> 
<Button Name = "btnClickMe" Height = "40" Width = "100" Content = "Click Me" /> 


可 用 如 下 的 编程 方式 来 表示 : 


// 定义 原来 那个 在 C# 代 码 中 定义 过 的 WPF 按 知 
Button btnClickMe = new Button(); 
btnClickMe.Height = 40; 

btnClickMe.Width = 100; 

btnClickMe.Content = "Click Me"; 


从 坏 的 方面 来 说 ，XAML 比 较 元 长 并 且 区 分 大 小 写 ( 跟 XML 文 档 一 样 )。 同 样 ， 复杂 的 XAML 
定义 将 产生 大 量 的 标记 。 大 多 数 开发 人 员 都 不 必 手 工 编 写 WPF 应 用 程序 的 完整 XAML 描 述 。 而 这 个 
工作 的 绝 大 部 分 ( 幸好 是 绝 大 部 分 ) 将 交 给 开发 工具 来 完成 , 例如 Visual Studio、Microsoft Expression 
Blend, 或 者 一 些 第 三 方 产品 。 当 这 些 工 具 生成 基本 的 标记 之 后 , 你 就 可 以 根据 需要 对 XAML 定 义 进 
行 细 调 了 。 


27.5.1 用 XAML 定 义 窗 体 对 象 


虽然 工具 可 以 为 你 生成 大 量 的 XAML, 但 了 解 XAML 语 法 的 基本 工作 原理 以 及 这 些 标记 最 终 如 何 
被 转化 为 一 个 有 效 的 .NET 程 序 集 对 你 来 讲 非常 重要 。 为 了 说 明 XAML 语 法 的 基础 , 我 们 的 下 一 个 示例 
将 只 使 用 一 组 .xaml 文 件 来 实现 前 面 的 WPF 应 用 程序 。 
目前 ， 我 们 的 MainWindow 是 在 C# 中 定义 为 一 个 扩展 了 System.Windows .Window 基 类 的 类 。 这 个 类 包 
含 了 一 个 Button 对 象 ， 在 它 被 单 击 时 会 调用 一 个 注册 了 的 事件 处 理 程序 。 用 XAML 语 rt 
Window 类 型 可 由 如 下 代码 完成 。 首先 , 使 用 简单 的 文本 编辑 器 ( 如 Notepad ) 新 建 一 个 MainWindow.xaml 
文件 ， 并 将 其 保存 在 从 C: 盘 可 以 很 容易 访问 的 子 目 录 中 ， 因 为 我 们 会 通过 命令 行 处 理 该 文件 。 现 在 添 
加 如 下 的 XAML: 
<1-- 这 里 是 我 们 的 窗 体 定义 --> 
<Window x:Class="WpfAppAllXam] .MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="A Window built using 100% XAML" 


Height="200" Width="300" 
WindowStartupLocation ="CenterScreen"> 


《1-- 该 窗 体 以 单个 按钮 作为 其 内 容 --> 
<Button x:Name="btnExitApp" Width="133" Height="24" 
Content = "Close Window" Click ="btnExitApp Clicked"/> 


《1-- 按钮 的 Click 事 件 处 理 方法 的 实现 --> 
<x:Code> 
<![CDATA[ 
private void btnExitApp_Clicked(object sender, RoutedEventArgs e) 
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this.Close(); 


} 
]]> 
</x:Code> 
</Window> 


首先 , 注意 根 元 素 <window> 使 用 了 Class 特 性 指定 C# 类 的 名 称 , 在 处 理 该 XAML 文 件 时 将 自动 生成 
这 个 C# 类 。 同 时 还 要 注意 Class 特 性 的 前 级 为 x: 标 签 。 在 <Window> 开 放 元 素 内 ， 这 个 XML 标 签 前 缀 被 
设置 为 字符 串 “http:/schemas.microsoft.com/winfx/2006/xaml” 来 建立 一 个 XML 命名 空间 声明 。 本 章 稍 
后 将 详细 介绍 XML 命名 空间 的 定义 ， 此 时 只 需要 注意 在 引用 “http://schemas. microsoft.com/winfx/ 
2006/xaml” 命 名 空间 定义 的 项 时 ， 必 须 使 用 x: 前 级 。 

在 起 始 标签 cWindow> 的 范围 内 , 我 们 已 经 为 Title、Height、Width 和 windowStartupLocation 特 性 赋 
了 值 ， 你 可 以 看 到 这 是 对 PresentationFramework.dll 程 序 集 中 System.Windows .Window 类 提供 的 同名 属性 
的 一 个 直接 映射 。 

接 下 来 ， 请 注意 在 窗 体 定义 的 范围 内 ， 我 们 创建 了 描述 Button 对 象 的 外 观 和 行为 的 标记 。 它 将 被 
用 于 设置 窗 体 的 Content 属 性 。 除 了 设置 变量 名 ( 使 用 x:Name XAML 标 记 ) 和 总 的 尺寸 以 外 , 我 们 还 处 
理 了 Button 类 型 的 Click 事 件 ， 设置 了 Click 事 件 发 生 时 的 委托 处 理 方法 。 

XAML 文 件 最 后 一 部 分 内 容 是 <x:Code> 元 素 ， 毫 不 奇怪 ， 它 允许 我 们 在 一 个 *.xaml 文 件 中 直接 编 
写 事件 处 理 方法 和 该 类 的 其 他 方法 。 作 为 一 种 安全 措施 ,代码 本 身 被 封装 在 一 个 CDATA 范 围 内 ,以 防止 
XML 人 解析 器 试图 直接 解析 这 些 数据 ( 对 于 现在 这 个 示例 而 言 ， 这 不 是 必需 的 )。 

有 必要 说 明 一 下 ， 不 推荐 在 <Code> 元 素 中 编写 功能 函数 。 虽 然 这 种 “单一 文件 方式 ”将 所 有 的 行 
为 都 隔离 在 一 个 地 方 ， 但 内 艇 代码 并 没有 为 我 们 提供 标记 与 逻辑 关注 点 之 间 的 清晰 分 离 。 在 大 多 数 
WPF 应 用 程序 中 , “真正 的 代码 ”都 会 放 在 一 个 相关 联 的 部 分 C# 类 中 (我 们 最 后 会 这 样 做 )。 


27.5.2 ”用 XAML 定 义 应 用 对 象 


请 记 住 XAML 可 以 用 来 通过 标记 来 定义 任何 非 抽 象 的 提供 默认 构造 函数 的 .NET 类 。 因 此 , 我 们 当 
然 也 可 以 用 标记 来 定义 应 用 对 象 。 参 考 下 面 这 段 新 文 件 MyApp.xaml 中 的 内 容 : 


<!-- 看 起 来 main() 方 法 不 见 了 ! 不 过 StartupUri 特 性 在 功能 上 是 等 价 的 --> 

<Application x:Class="WpfAppAllXaml .MyApp" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 

</Application> 


你 可 能 会 同意 ， 这 里 的 Application 继 承 类 与 其 XAML 描述 之 间 的 映射 并 不 像 MainWindow 类 与 其 
XAML 描 述 间 的 映射 那么 清晰 。 具 体 看 ， 似 乎 没有 任何 Main() 方 法 的 踪迹 。 考 虑 到 任何 .NET 程 序 都 必 
须要 有 一 个 程序 人 口 点 ， 你 可 能 会 假设 这 个 人 口 点 会 基于 StartupUri 属 性 部 分 ， 在 编译 时 被 创建 ， 你 
是 正确 的 。 赋 给 StartUupuri 的 值 表示 应 用 程序 启动 时 加 载 哪个 XAML 资 源 。 在 本 例 中 ， 我 们 将 
StartupUri 设 置 为 定义 初始 窗 体 对 象 的 XAML 资 源 的 名 称 MainWindow.xaml。 

虽然 Main() 方 法 会 在 编译 时 被 自动 创建 ， 如 果 我 们 愿意 ,我 们 可 以 使 用 <x:Code> 元 素来 捕获 其 
他 C# 代 码 块 。 例 如 ， 如 果 想 在 程序 关闭 时 显示 一 条 消息 ， 可 以 处 理 Exit 事 件 并 按 如 下 所 示 实 现 它 ( 注 
意 开放 的 <Application> 元 素 现 在 设置 了 Exit 特 性 ， 来 捕获 Application 类 的 Exit 事 件 ): 





27.5 仅 使 用 XAML 构建 WPF 应 用 程序 911 


<Application x:Class="SimpleXamlApp.MyApp" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml" Exit ="AppExit"> 
<x:Code> 
<![CDATA[ 
private void AppExit(object sender, ExitEventArgs e) 


MessageBox.Show("App has exited"); 
} 
]]> 


</x:Code> 
</Application> 


27.5.3 ”通过 msbuild.exe 处 理 XAML 文 件 


到 现在 , 我 们 已 经 准备 好 将 我 们 的 标记 转换 为 一 个 有 效 的 .NET 程 序 集 。 但 如 果 要 这 样 做 ,我 们 还 
不 能 直接 利用 C# 编 译 器 。 到 目前 为 止 ，C# 编 译 器 还 不 能 直接 理解 XAML 标 记 。 不 过 ， 命 令 行 工具 
msbuild.exe 懂 得 如 何 将 XAML 转 换 为 C# 代 码 并 且 在 获知 正确 的 *.targets 文 件 后 ， 在 运行 时 编译 这 些 
代码 。 

msbuild.exe 工 具 根 据 基 于 XML 构 建 的 脚本 中 的 指令 来 编译 .NET 代 码 ,。 这 些 构建 脚本 文件 所 包含 的 
数据 与 Visual Studio 生 成 的 *.csproj 文 件 中 的 内 容 完全 相同 。 因 此 ，.NET 程 序 可 以 用 msbuild.exe 在 命令 
行 中 编译 ， 也 可 以 用 Visual Studio 本 身 。 


说 明 ”对 msbuild.exe 工 具 的 完整 介绍 超出 了 本 章 的 范围 ,要 了 解 更 多 内 容 , 可 以 在 .NETFramework 4.5 
SDK 文 档 中 搜索 “MSBuild” 话 题 。 


以 下 是 一 个 非常 简单 的 构建 脚本 WpfAppAllXaml.csproj ， 它 仅 包 含 足 够 的 信息 供 msbuild.exe 将 
XAML 文 件 转换 为 相关 的 C# 人 代码 库 : 


<Project DefaultTargets="Build" 
xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> 
<PropertyGroup> 
<RootNamespace>WpfAppAllXaml</RootNamespace> 
<AssemblyName>WpfAppAllXaml</AssemblyName> 
<OutputType>winexe</O0utputType> 
</PropertyGroup> 
<ItemGroup> 
<Reference Include="System" /> 
<Reference Include="WindowsBase" /> 
<Reference Include="PresentationCore" /> 
<Reference Include="PresentationFramework” /> 
</ItemGroup> 
<ItemGroup> 
<ApplicationDefinition Include="MyApp.xaml" /> 
<Page Include="MainWindow.xaml" /> 
</ItemGroup> 
<Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" /> 
<Import Project="$(MSBuildBinpath)\Microsoft.WinFX.targets" /> 
</Project> 
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说 明 ”该 *.csproj 文 件 不 能 直接 被 Visual Studio 加 载 ， 因 为 它 只 包含 用 于 在 命令 行 构建 应 用 程序 的 最 少 


指令 。 


这 里 的 <PropertyGroup> 元 素 用 来 指定 编译 中 的 一 些 基 本 属性 , 例如 根 命 名 空间 、 最 终生 成 的 程序 
集 的 名 称 以 及 输出 类 型 ( 等 价 于 csc.exe 的 选项 /target:winexe )。 

第 一 个 cItemGroup> 指 定 了 当前 编译 过 程 中 要 引用 的 外 部 程序 集 集合 。 可 以 看 到 , 它们 就 是 本 章 前 
面 探讨 过 的 那些 WPF 核 心 程序 集 。 

第 二 个 <ItemGroup> 则 有 趣 得 多 。 请 注意 <ApplicationDefinition> 元 素 的 Include 特 性 指向 定义 应 用 
对 象 的 *.xaml 文 件 。<Page> 的 Include 特 性 则 可 以 用 来 列举 余下 的 每 个 *.xaml 文 件 , 这 些 *.xaml 文 件 定 义 
了 由 该 应 用 对 象 所 处 理 的 窗 体 (还 有 页 面 ， 它 们 经 常 被 用 于 构建 XAML 浏 览 器 程序 )。 

不 过 ， 这 个 构建 文件 的 奥秘 却 在 于 最 后 的 那些 <Import> 子 元 素 。 请 注意 我 们 的 编译 脚本 引用 了 两 
个 *.targets 文 件 ， 每 一 个 都 包含 了 编译 过 程 中 的 许多 其 他 指令 。Microsoft.WinFX.targets 文 件 包 含 了 将 
XAML 定 义 转换 为 等 价 C# 代 码 文件 所 需 的 那些 编译 设置 ， 而 Microsoft.CSharp.targets 文 件 则 包含 了 与 
C# 编 译 需 交互 的 数据 。 

不 管 怎样 ， 你 现在 可 以 打开 Developer Command Prompt， 使 用 msbuild.exe 来 处 理 这 些 XAML 数据 。 定 
位 到 MainWindow.xaml、MyApp.xaml 和 WpfAppAllXaml.csproj 文 件 所 在 的 目录 ， 输 入 下 面 的 命令 : 

msbuild WpfAppAllXaml .csproj 

构建 成 功 之 后 ， 你 会 在 工作 目录 中 看 到 \bin 和 \obj 子 目录 ( 与 Visual Studio 项 目 一 样 )。 打 开 
\bin\Debug 文 件 夹 ， 会 看 到 一 个 新 的 .NET 程 序 集 SimpleXamlApp.exe。 在 ildasm.exe 中 打开 该 程序 集 ， 
可 以 看 到 XAML 已 经 被 转换 为 有 效 的 可 执行 应 用 程序 ( 如 图 27-9 所 示 )。 





广 
pF WptAppAiXaml.exe - IL DASM 2 
File View Help 
SS- WpfAppAlXaml.exe 
bp MANIFEST 
al 
用 wpfappAalxaml.Mainwindow 
pb ,dass pubic auto ansi beforefieldinit 
pb extends [PresentationFramework]System.Windows. Window 
Pp implements [WindowsBase]System.Windows.Markup.IComponentConnector 
> contentLoaded : private bool 
~ btnExitApp ; assembly class [PresentationFramework]System,Windows.Controls,Button 
国 .ctor ; void0) 
各 InitializeComponent : void() 
罩 5ystem.Windows.Markup.IComponentConnector.Connect ; void(int32,0bject) 
加 btnExitApp_Clicked : void(object, class [PresentationCore]System, Windows.RoutedEventArgs) 
提 甩 :WpfAppAlxami.MyApp 
j .class public auto ansi beforefieldinit 
jextends [PresentationFramework]System.Windows.Application 
葵 .ctor ; void(0) 
加 AppExi : void(object, class [PresentationFramework]System., Windows.ExitEventArgs) 
加 InitiaizeComponent : void() 
网 Main : void() 











pth WpfappAlxamml 














图 27-9 ”将 XAML 标 记 转 换 成 一 个 .NET 可 执行 文件 ? 很 有 意思 
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如 果 双 击 可 执行 程序 来 运行 程序 ， 将 在 屏幕 上 看 到 主 窗口 。 


27.6 ”将 标记 转换 为 .NET 程序 集 


为 了 准确 地 理解 我 们 的 标记 是 如 何 被 转换 为 .NET 程 序 集 的 , 我 们 需要 深入 一 点 了 解 msbuild.exe 的 
处 理 过 程 ， 并 研究 一 些 编译 器 生成 的 文件 ， 包 括 在 编译 时 舱 入 到 程序 集中 的 特定 二 进 制 资源 。 首 先 ， 
学 习 一 下 *.xaml 文 件 是 如 何 转换 成 相应 的 C# 代 码 库 的 。 


27.6.1 将 窗口 XAML 标 记 映 射 到 C# 代 码 


在 一 个 msbuild 脚 本 中 指定 的 那些 *.targets 文 件 包含 许 多 将 XAML 元 素 翻译 为 C# 代 码 的 指令 。 当 
msbuild.exe 处 理 我 们 的 *.csproj 文 件 时 ， 它 以 *.g.cs ( 这 里 的 g 代 表 自 动 生 成 的 意思 ) 的 形式 生成 两 个 文 
件 ， 它 们 被 保存 在 \obj\Debug 目 录 下 。 根 据 *.xaml 文 件 的 名 字 ， 生 成 的 C# 文 件 也 就 是 MainWindow.g.cs 
和 MyApp.g.cs。 

如 果 打 开 文 件 MainWindow.g.cs ， 你 会 找到 那个 扩展 了 Window 基 类 的 Mainwindow 类 。 该 名 称 与 
<Window> 开始 标记 中 x:Class 特 性 的 值 相同 。 同 时 ， 这 个 类 还 定义 了 一 个 System.Nindows . 
Controls.Button 的 成 员 变 量 btnExitApp。 在 本 例 中 , 控件 的 名 称 基 于 <Button> 开 放声 明 中 x:Name 特 性 的 
值 。 该 类 还 包含 按钮 的 Click 事 件 的 处 理 程序 btnExitApp_Clicked() 。 以 下 是 这 个 编译 器 生成 的 
MainWindow.g.cs 文 件 的 部 分 代码 : 


public partial class MainWindow : 
System.Windows.Window, System.Windows.Markup.IComponentConnector 


internal System.Windows.Controls.Button btnExitApp; 
private void btnExitApp Clicked(object sender, RoutedEventArgs e) 


this.Close(); 


这 个 类 定义 了 一 个 私有 的 boo1 类 型 的 私有 成 员 变 量 ( 名 为 _contentLoaded )， 它 并 不 直接 对 应 于 
XAML 标 记 。 该 数据 成 员 用 来 判断 (和 确保 ) 窗口 的 内 容 只 能 设置 一 次 : 


public partial class MainWindow : 
System.Windows.Window, System.Windows.Markup.IComponentConnector 


// 很 快 会 解释 这 个 成 员 变 量 
private bool contentLoaded; 


} . 
注意 ， 编 译 器 生成 的 类 显 式 地 实现 了 定义 在 System.Windows.Markup 命 名 空间 中 的 WPF ICom- 
ponentConnector 接 口 。 这 个 接口 定义 了 一 个 方法 Connect() ， 它 已 被 实现 ， 用 来 构建 在 原始 的 Main 
Window.xaml 文 件 中 定义 的 事件 逻辑 。 在 该 方法 完成 前 ，_contentLoaded 成 员 变 量 被 设 为 ture。 下 面 是 
该 方法 的 关键 部 分 : 


void System.Windows.Markup.IComponentConnector.Connect(int connectionId, object target) 
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switch (connectionId) 


case 1: 
this.btnExitApp = ((System.Windows.Controls.Button)(target)); 


this.btnExitApp.Click += new 
System.Windows.RoutedEventHandler(this.btnExitApp_Clicked); 


return; 


this. contentLoaded = true; 


} 
最 后 ，MainWindow 类 也 定义 并 实现 了 一 个 名 为 InitializeComponent() 的 方法 。 你 可 能 会 认为 该 方法 


会 设置 不 同 的 属性 (Height 、Width、Content 等 ) 来 建立 各 个 控件 的 外 观 。 然 而 事实 并 非 如 此 。 那 么 ， 
这 些 控 件 是 如 何 正 确 地 放置 在 UI 上 的 呢 ? InitializeComponent() 中 的 逻辑 定位 了 一 个 内 艇 的 程序 集 
资源 ， 它 的 名 称 与 初始 的 *.xaml 文 件 相 同 ， 如 下 所 示 : 
public void InitializeComponent() 
if (_contentLoaded) 
return; 
_ContentLoaded = true; 
System.UTi resourceLocater = new 
System.Uri("/WpfAppAllXaml] ;component/mainwindow.xaml", 


System.Urikind.Relative); 
System.Windows.Application.LoadComponent(this, resourceLocater); 


至 此 ， 问 题 变 成 了 : 这 个 内 散 的 资源 到 底 是 什么 ? 


27.6.2 BAML 的 作用 
当 msbuild.exe 处 理 *.csproj 文 件 时 ， 它 还 生成 了 一 个 以 *baml 为 扩展 名 的 文件 。 它 是 根据 初始 的 
MainWindow.xaml 的 文件 名 来 命名 的 ， 因 此 你 应 该 能 在 \obj\Debug 文 件 夹 下 看 到 文件 MainWindow.baml 


( 如 图 27-10 所 示 )。 





New folder 


| Organize ~ _j DOpen Bum 


Name 


富 Favortes 3 
i Desitop | MainWindowibami NR 
茵 Downloads | MainWindow.g.cs 
3 Recent Places | 者 MyApp.g.cs 
| ResoiveAssemblyReference.cache 
于 Libraries EWpfAppAlXaml.exe 
[3] Documents __ WpfAppAliXaml.g.resources 
od Music 局 WpfAppAllxami.pdb 
ka) Pictures _ WpfAppAlXaml_MarkupCompile.cache 


志 Videos 





MainWindowbaml Date modified 3/11/2012 4:41 PM Date craated: 3/11/2012 4:37 PM 
BANML File Size: 797 bytes 





图 27-10 BAML 只 是 XAML 的 简洁 二 进 制版 本 


27.6 ”将 标记 转换 为 .NET 程序 集 915 


可 能 你 已 经 从 它 的 名 字 中 猜 到 了 ， 二 进 制 应 用 程序 标记 语言 (BAML ) 是 XAML 的 一 种 二 进 制 表 
示 。 这 个 *.baml 文 件 作为 资源 ( 通过 一 个 生成 的 *.g.resources 文 件 ) 内 艇 在 编译 好 的 程序 集中 。 

BAML 资 源 包 含 用 于 建立 UI 部 件 外 观 所 需 的 所 有 数据 ( 同样 ， 例 如 窗 体 的 Height 和 Width 属 性 )。 
事实 上 ， 如 果 通 过 Visual Studio 打 开 *.baml 文 件 ， 你 就 能 看 到 初始 的 XAML 特 性 的 踪迹 ( 见 图 27-11 )。 





0120 77 73 42 61 ?3 65 2C 20 56 65 72 73 69 6F 6E 3D wsBase, Version= ~» 
0130 33 2E 30 2E 30 2E 30 2C 20 43 75 6C 74 75 72 65 3.0.0.0, Culture 
0140 3D 6E 65 75 74 ?72 61 6C 2C 20 50 ?5 62 6C 69 63 =neutral, Public 
0150 4B 65 79 54 6F 6B 65 6E 3D 33 31 62 66 33 38 35 KeyToken=31bf385 
Qi60 36 61 64 33 36 34 65 33 35 14 44 00 39 68 74 74 bad364e35.D. 9htt 
0170 70 3A 2F 2F 73 63 68 65 86D 61 73 2E 6D 69 63 72 p://schemas .nmicr 
0180 6F 73 6F 66 74 2E 63 6F 6D 2F ?7 69 6E 66 78 2F Osoft .com winfx/ 
0190 32 30 30 36 2F ?8 61 6D 6C 2F 70 72 65 73 65 6E 2006/xaml/presen 
Oia0 74 61 ?4 69 6F 6E 03 00 01 00 02 00 03 00 35 03 tation........ 5 

0ib0 00 00 00 03 00 00 00 14 38 01 78 2C 68 ?474 70 ........ 8.x,http 
Dlic0 3A 2F 2F ?3 63 68 65 6D 61 ?3 2E 6D 69 63 72 6F ://schenas micro | 
01d0 ?73 6F 66 74 2E 63 6F 6D 2F 77 69 6E 66 78 2F 32 soft.com/winfx/2 | 
a0 30 30 36 2F 78 61 6D 6C 03 00 01 00 02 00 03 00 LB me 

1 4 

0200 
0210 
0220 
0230 
0240 
0250 
0260 | 
0270 69 6F 6E 24 12 01 60 0C 43 65 6E 74 65 ?2 53 63 ion$....CenterSc | 
0280 72 65 65 6E 3D FF 35 07 00 00 00 03 00 00 00 2E reen=.5......... 
0290 F2 FF 35 QA 00 00 860 04 00 00 00 03 C9 FF 00 2D ..5............ 一 











图 27-11 BAML 包 含 用 于 在 运行 时 构建 对 象 的 属性 值 


这 里 最 重要 的 是 要 理解 WPF 应 用 程序 本 身 包含 标记 的 二 进 制 表示 ( BAML )。 在 运行 时 ，BAML 
从 资源 容器 中 被 取出 ， rep pier 

同样 还 要 记 住 ， 该 二 进 制 资源 的 名 称 与 你 编写 的 独立 的 * xaml 文 件 的 名 称 完全 相同 。 但 这 并 不 意 
easy 同 发 布 。 除 非 WPF 应 用 程序 要 在 运行 时 动态 加 载 和 
解析 *.xaml 文 件 ， 否 则 永远 没有 必要 发 布 原始 的 标记 。 


27.6.3 ”将 应 用 程序 XAML 标 记 映 射 到 C# 代 码 


自动 生成 的 代码 谜 题 的 最 后 一 关 出 现在 MyApp.g.cs 文 件 中 。 在 这 里 ， 我们 看 到 了 派生 自 
Application 的 类 有 一 个 适当 的 Main() 入 口 点 方法 。 这 个 方法 的 实现 调用 了 这 个 Application 派 生 类 的 
InitializeComponent() 方 法 ， 它 反 过 来 又 为 startupUri 属 性 赋 了 值 ， 从 而 使 得 每 个 对 象 都 可 以 根据 二 
进 制 的 XAML 定 义 来 为 其 自身 建立 正确 的 属性 设置 。 


namespace WpfAppAllXaml 
public partial class MyApp : System.Windows.Application 
void AppExit(object sender, ExitEventArgs e) 
{ 


MessageBox.Show("App has exited"); 
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[System.Diagnostics.DebuggerNonUserCodeAttribute()] 
public void InitializeComponent() 


this.Exit += new System.Windows.ExitEventHandler(this.AppExit); 
this.StartupUri = new System.Uri("MainWindow.xaml", System.UriKind.Relative); 


[System.STAThreadAttribute()] 
[System.Diagnostics.DebuggerNonUserCodeAttribute()] 
public static void Main() { 


SimpleXamlApp.MyApp app = new SimpleXamlApp.MyApp(); 
app.InitializeComponent(); 
app.Run(); 


} 
} 


27.6.4 XAML 到 程序 集 的 过 程 摘要 


本 章 到 此 为 止 ， 我 们 只 用 了 两 个 XAML 文 件 和 一 个 相关 的 构建 脚本 创建 了 一 个 完整 的 WPF 程 序 。 
可 以 看 到 ， 在 编译 的 过 程 中 ，msbuild.exe 使 用 了 定义 在 *.targets 文 件 中 的 辅助 设置 来 处 理 这 些 XAML 
文件 ( 并 生成 *.baml )。 图 27-12 对 编译 期 处 理 *.xaml 文 件 的 过 程 做 了 全 程 图 解 。 





输出 到 \Obj\Debug 目 录 













MainWindow.xaml 
MyApp.xmal 
*.Cspro]j 


msbuild.exe、 
必需 的 C# 
和 WPF 部 件 









MainWindow.g.cs 
My App.g.cs 
MainWindow.baml 
WpfAppAll.g.resources 









WpfAppAllXaml.exe 







C# 编 译 器 


内 代 的 一 编译 Ch 文件 | 
BAML 资 源 一 将 #.g.resources 作 为 资源 嵌入 | 


图 27-12 XAML 到 程序 集 的 编译 期 处 理 过 程 


硕 望 你 已 经 理解 了 如 何 使 用 XAML 数据 来 构建 .NET 应 用 程序 。 接 下 来 我 们 来 看 一 下 XAML 的 语法 
和 语义 。 





源 代码 ”WpfAppAllXaml 项 目的 源 代 码 位 于 Chapter 27 子 目录 下 。 





27.7 WPF XAML 语法 


产品 级 的 WPF 应 用 程序 通常 会 使 用 专门 的 工具 来 生成 必要 的 XAML。 理解 XAML 标 记 的 整个 结构 
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与 这 些 工具 一 样 ， 是 十 分 有 用 的 。 为 了 帮助 我 们 的 学 习 过 程 ， 我 将 介绍 一 个 十 分 流行 (并 且 免 费 ) 的 
工具 ， 可 以 用 来 简单 地 体验 XAML。 


27.7.1 Kaxaml 


在 首次 学 习 XAML 语 法 时 , 使 用 免费 工具 Kaxaml 是 十 分 有 帮助 的 。 这 个 流行 的 XAML 编 辑 器 /解析 
器 可 以 在 网 站 http:/www.kaxaml.com 下 载 。 

Kaxaml 是 非常 有 帮助 的 , 它 不 关心 C# 源 代码 、 事 件 处 理 程序 或 实现 逻辑 , 使 用 它 测 试 XAML 片段 
比 使 用 Visual Studio WPF 项 目 模 板 要 更 加 简单 直接 。 同 样 ，Kaxaml 还 包含 很 多 集成 工具 ， 如 颜色 选择 
器 、XAML 片 段 管理 器 ， 其 至 还 包括 根据 设置 格式 化 XAML 的 “XAML 清 理 器 ”"。 首 次 打开 Kaxaml 时 ， 
将 看 到 一 个 简单 的 <Page> 控 件 标记 ， 如 下 所 示 : 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Grid> 


</Grid> 
</Page> 
与 Nindow 类 似 ，Page 也 包含 不 同 的 布局 管理 器 和 控件 。 但 与 Mindow 不 同 的 是 ，Page 对 象 不 能 作为 
独立 的 实体 运行 ， 它 们 必须 被 放置 在 合适 的 宿主 中 ， 如 NavigationWindow、Frame 或 Web 浏 览 器 (此 时 
创建 的 是 一 个 XBAP )。 不 过 在 <Page> 和 <Window> 的 作用 域内 ， 我 们 可 以 输入 相同 的 标记 。 


说 明 ”在 Kaxaml 标 记 窗 口内 将 cPage> 和 </Page> 元 素 更 改 为 <Window> 和 </Window>， 按 下 F5 键 即 可 在 屏 
幕 上 加 载 新 的 窗口 。 


在 该 工具 下 方 的 XAML 面 板 内 输入 如 下 标记 ， 来 进行 最 初 的 测试 : 


《Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Grid> 

<1-- 包含 自 定义 内 容 的 按钮 --> 
<Button Height="100" Width="100"> 
<Ellipse Fill="Green" Height="50" Width="50"/> 
</Button> 
</Grid> 
</Page> 


你 可 以 在 Kaxaml 编 辑 器 上 方 看 到 所 呈现 的 页 面 ( 如 图 27-13 所 示 )。 

使 用 Kaxaml 时 要 记 住 ， 它 不 允许 你 编写 任何 需要 代码 编译 的 标记 (但 可 以 使 用 x:Name )， 包 括 定 
义 x:Class 特 性 ( 为 指定 代码 文件 )、 在 标记 中 输入 事件 处 理 程序 的 名 称 以 及 使 用 其 他 需要 代码 编译 的 
XAML 关 键 字 ( 如 FieldModifier 或 ClassModifier )。 和 否则 ， 将 导致 标记 错误 。 
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My default xaml - Kaxaml 


, eth eanit 


YY snippats 
Find 
砚 Color picker 
园 snapshot 
[ 入 Xamil Scrubber 
攻 Settings 


About 
cj <page 
wins="http://schemas.microsoft.com/winfx/2006/xaml/presentation” 
xslns:xe"http://schemas.microsoft .com/winfx/28006/xaml”> 
El “Grid 
< A button with custom 
| <Button Height="100" Wic 
<Ellipse Fill="Green” Netght= "50” Width="598"/> 
lButton> 


</Page> 








图 27-13 ”Kaxaml 是 学 习 XAML 语 法 非常 有 帮助 (是 免费 ) 的 工具 


27.7.2 XAML XML 命名 空间 和 XAML 关键 字 


WPF 相 关 的 XAML 文 件 的 根 元 素 ( 如 <Window>、<Page>、<UserControl> 或 <cApplication> 定 义 ) 一 
般 定 义 为 引用 两 个 XML 命名 空间 : 
<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 


xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Grid> 


</Grid> 
</Page> 


第 一 个 XML 命 名 空间 http://schemas.microsoft.com/winfx/2006/xaml/presentation 映 射 许多 当前 
*.xaml 文 件 使 用 的 WPF .NET 命 名 空间 ( System.Windows 、System.Windows.Controls 、System.Windows. Data、 
System.Windows.Ink 、System.Windows.Media 和 System.Windows.Navigation 等 )。 

这 个 一 对 多 的 映射 其 实 使 用 程序 集 级 别 的 [XmlnsDefinition] 特 性 硬 编码 在 WPF 程 序 集中 
( WindowsBase.dll 、PresentationCore.dll 和 PresentationFramework.dll )。 例 如 ， 打 开 Visual Studio 对 象 浏 
览 器 并 选择 PresentationCore.dll 程 序 集 , 会 看 到 下 面 的 列表 , 它 实 际 上 导入 了 System. Windows 命 名 空间 : 


[assembly: XmlnsDefinition("http://schemas.microsoft.com/winfx/2006/xaml/presentation", 
"System.Windows")] 


第 二 个 XML 命 名 空间 es microsoft.com/winfx/2006/xaml 用 于 包含 XAML 特 定 的 关键 字 
和 System.Windows .Markup 命 名 空间 中 的 类 型 的 子 集 ， 如 下 所 示 : 


[assembly: XmlnsDefinition("http://schemas.microsoft.com/winfx/2006/xaml", 
"System.Windows .Markup" )] 
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格式 明确 的 XML 文档 ( 记 住 ，XAML 是 基于 XML 的 语法 ) 必须 定义 一 个 根 元 素来 指定 一 个 XML 
命名 空间 作为 主 命 名 空间 ， 它 一 般 是 包含 大 多 数 公共 使 用 项 的 命名 空间 。 如 果 根 元 素 需要 包含 其 他 二 
级 命名 空间 ( 如 这 里 )， 就 必须 使 用 唯一 前 组 来 定义 (来 解决 可 能 的 命名 冲突 )。 作 为 惯例 ， 前 缀 只 是 
x， 然 而 也 可 以 是 我 们 需要 的 特殊 表示 ， 如 Xam1SpecificStuff: 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:XamlSpecificStuff="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Grid> 
《<1-- 具有 自 定义 内 容 的 按钮 --> 
<Button XamlSpecificStuff:Name="button1" Height="100" Width="100"> 
<Ellipse Fill="Green" Height="50" Width="50"/> 
</Button> 
</Grid> 
</Page> 


定义 这 么 长 的 XML 命 名 空间 前 缀 的 明显 缺点 是 ， 每 次 XAML 文 件 需 要 引用 定义 在 这 个 XML 命 名 
空间 中 的 类 型 时 ， 就 需要 写 XamlSpecificStuff。 由 于 XamlSpecificstuff 需 要 许多 额外 的 键盘 敲 击 ， 我 
们 还 是 使 用 x 吧 。 

不 管 怎样 , 除了 x:Name 、x:Qass 和 x: Code 关 键 字 以 外 , http://schemas.microsoft.com/winfx/2006/xaml XML 
命名 空间 还 提供 了 对 其 他 XAML 关 键 字 的 访问 ， 表 27-9 列 出 了 一 些 主要 的 关键 字 。 


表 27-9 XAML 关 键 字 


XAML 关 键 字 作 用 

x:Array 在 XAML 中 表示 .NET 数 组 类 型 

x:ClassModifier 用 来 定义 由 Class 关 键 字 定义 的 类 类 型 的 可 见 性 ( 内 部 的 或 公开 的 ) 

x:FieldModifier 用 来 为 任何 根 的 命名 子 元 素 ( 如 <Window> 元 素 中 的 <Button> ) 定义 类 型 成 员 的 可 见 性 ( 内 
部 的 、 公 开 的 、 私 有 的 或 受 保护 的 )。 命 名 元 素 是 使 用 XAML Name 关 键 字 定义 的 元 素 

x:Key 用 来 为 要 放 到 字典 元 素 中 的 XAML 项 创建 一 个 键 值 

x:Name 用 来 为 给 定 的 XAML 元 素 指定 生成 的 C# 名 称 

x:Null 表示 nul1 引 用 

x:Static 用 来 引用 类 型 的 静态 成 员 

x:Type C# typeof 操 作 符 的 XAML 等 价 形式 ( 它 会 根据 提供 的 名 字 产 生 System.Type ) 

x:TypeArguments 用 来 使 用 指定 的 类 型 参数 以 泛 型 类 型 创建 元 素 


除了 这 两 个 必要 的 XML 命名 空间 的 声明 ,还 有 可 能 ( 有 时 会 必须 ) 在 XAML 文档 的 开放 元 素 内 定 
义 其 他 标签 前 级 。 当 你 需要 在 XAML 中 描述 外 部 程序 集 定义 的 .NET 类 时 ， 通 常 需 要 这 么 做 。 

例如 ， 你 构建 了 一 些 自 定 义 WPF 控 件 ， 并且 将 它们 打包 到 一 个 MyControls.dll 库 中 。 现 在 ， 如 果 你 希 
望 创建 使 用 这 些 控 件 的 Window， 可 以 使 用 clr-namespace 和 assembly 标 记 建 立 一 个 自 定义 的 XML 命 名 空 
间 , 使 其 映射 到 自 定义 库 。 以 下 是 一 些 示 例 标 记 , 创建 了 一 个 myCtrls 标 签 前 级 , 可 用 来 访问 库 中 的 控件 : 


<Window x:Class="WpfApplication1.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:myCtrls="clr-namespace:MyControls;assembly=MyControls" 
Title="MainWindow" Height="350" Width="525"> 
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<Grid> 
<myCtrls:MyCustomControl /> 

</Grid> 

</Window> 


clr-namespace 标 记 用 来 设置 程序 集中 .NET 命 名 空间 的 名 称 ，assembly 标 记 用 来 设置 外 部 *.dll 程 序 
集 的 友好 名 称 。 你 可 以 对 任何 希望 在 标记 中 进行 操作 的 外 部 .NET 库 使 用 该 语法 ,虽然 此 时 不 必 这 么 做 ， 
但 后 续 的 章节 会 要 求 我 们 定义 自 定义 XML 命 名 空间 声明 ， 来 在 标记 中 描述 类 型 。 


说 明 如 果 要 在 标记 中 定义 的 类 属于 当前 程序 集 ， 但 位 于 不 同 的 .NET 命 名 空间 ， 那 么 xmlns 标 签 后 面 
就 不 需要 定义 assembly= 特 性 。 例 如 : 


xmlns:myCtrls="clr-namespace: SomeNamespaceInMyApp" 


27.7.3 ”控制 类 和 成 员 变 量 的 可 见 性 


在 必要 的 时 候 ， 我 们 会 演示 这 些 关 键 字 ， 作 为 一 个 简单 的 示例 ， 考 虑 如 下 XAML <Window> 定 义 ， 
它 使 用 了 ClassModifier 和 FieldModifier 关 键 字 以 及 x:Name 和 x:Class ( 要 记 住 ，kaxaml.exe 不 允许 使 用 
任何 会 产生 代码 编译 的 XAML 关 键 字 ， 如 x:Code、x:FieldModifier 或 x:ClassModifier ): 


《<1-- 这 个 类 在 *.g.cs 文 件 中 被 声明 为 内 部 的 --> 

<Window x:Class="MyWPFApp.MainWindow" x:ClassModifier ="internal" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 


<1-- 这 个 按钮 在 *.g.cs 文 件 中 会 是 公开 的 --> 
<Button x:Name ="myButton" x:FieldModifier ="public" Content = "OK"/> 
</Window> , 
默认 情况 下 ， 所 有 CWXAML 类 型 定义 都 是 公开 的 ， 而 成 员 默 认 都 是 内 部 的 。 然 而 ， 根 据 我 们 的 
XAML 定 义 ， 最 后 自动 生成 的 文件 会 包含 一 个 具有 一 个 公开 Button 变 量 的 内 部 类 类 型 . 


internal partial class MainWindow : System.Windows .Window, 
System.Windows.Markup.IComponentConnector 


public System.Windows.Controls.Button myButton; 


} 


27.7.4 XAML 元 素 、XAML 特 性 和 类 型 转换 器 


创建 了 根 元 素 和 任何 必需 的 XML 命名 空间 之 后 , 下 一 个 任务 就 是 为 根 元 素 填充 子 元 素 。 在 一 个 真 
实 的 WPF 应 用 程序 中 ， 子 元 素 可 能 是 一 个 布局 管理 器 (如 Grid 或 stackPanel )， 它 包含 许多 描述 用 户 界 
面 的 其 他 元 素 。 下 一 章 会 详细 研究 这 些 布局 管理 器 ， 现 在 假设 我 们 的 <Window> 类 型 会 包含 一 个 Button 
元 素 。 

在 本 章 中 你 已 经 看 到 了 , XAML 元 素 映射 到 某 个 .NET 命 名 空间 中 的 类 或 结构 类 型 ,而 开始 元 素 标 
签 中 的 特性 映射 到 类 型 的 属性 或 事件 。 为 了 演示 ， 在 Kaxaml 中 输入 如 下 <Button> 定 义 : 
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<Page 
nea ire AENona microsdi con/ in /presenkation 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Grid> 
《1-- 配置 按钮 的 外 观 --> 
<Button Height="50" Width="100" Content="OK!" 
FontSize="20" Background="Green" Foreground="Yellow"/> 
</Grid> 
</Page> 


注意 , 为 每 个 属性 设置 的 值 都 是 简单 的 文本 值 。 这 看 上 去 似乎 完全 不 匹配 ， 因 为 如 果 在 C# 代 码 中 
设置 Button 的 这 些 属性 ， 就 不 能 使 用 这 些 字 符 串 对 象 ， 而 必须 使 用 指定 的 数据 类 型 。 例 如 ， 下 面 的 代 
码 包含 了 一 个 相同 的 按钮 : 


public void MakeAButton() 


{ 
Button myBtn = new Button(); 
myBtn.Height = 50; 
myBtn.Width = 100; 
myBtn.FontSize = 20; 
myBtn.Content = "OK!"; 
myBtn.Background = new SolidColorBrush(Colors.Green); 
myBtn.Foreground = new SolidColorBrush(Colors.Yellow); 


} 

事实 上 ，WPF 发 布 了 很 多 类 型 转换 器 类 ， 可 以 将 简单 的 文本 值 转换 为 正确 的 数据 类 型 。 这 个 处 理 
过 程 是 透明 的 ( 也 是 自动 的 )。 

尽管 这 些 已 经 很 好 了 ， 但 很 多 时 候 你 需要 为 XAML 特 性 设置 比 简 单字 符 串 要 更 复杂 的 值 。 例 如 ， 
假设 你 要 为 Button 的 Background 属 性 设置 一 个 自 定义 画 刷 。 如 果 在 代码 中 构建 画 刷 ， 则 相当 容易 ， 如 
下 所 示 : 

void MakeAButton() 


// 用 来 设置 背景 的 画 刷 
LinearGradientBrush fancyBruch = 
new LinearGradientBrush(Colors.DarkGreen, Colors.LightGreen, 45); 
myBtn.Background = fancyBruch; 
myBtn.Foreground = new SolidColorBrush(Colors.Yellow); 


} 
但 是 ,你 能 用 字符 串 表示 这 个 复杂 的 画 刷 吗 ?当然 不 行 。 幸 好 ，XAML 提 供 了 一 种 特殊 的 语法 一 
一 属性 元 素 语法 ， 可 以 将 属性 值 设 置 为 复杂 的 对 象 。 


27.7.5 XAML 属 性 元 素 语 法 


属性 元 素 语 法 允许 为 属性 赋予 复杂 的 对 象 。 这 里 是 按钮 的 一 个 XAML 描 述 ， 它 使 用 
LinearGradientBrush 来 设置 Background 属 性 : 


<Button Height="50" Width="100" Content="OK!" 
FontSize="20" Foreground="Yellow"> 
<Button.Background> 
<LinearGradientBrush> 
<GradientStop Color="DarkGreen" Offset="0"/> 
<GradientStop Color="LightGreen" Offset="1"/> 
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</LinearGradientBrush> 
</Button.Background> 
</Button> 


注意 ， 在 <Button> 和 </Button> 标 记 的 作用 域内 ， 我 们 定义 了 一 个 子 作用 域 <Button.Background>。 
在 该 作用 域内 ， 定 义 了 一 个 <LinearGradientBrush> ( 不 用 担心 画 刷 的 具体 代码 ， 我们 将 在 第 29 章 中 学 
习 WPF 图 形 )。 
一 般 来 说 ， 任 何 属性 都 能 用 属性 元 素 语法 进行 设置 ， 它 们 总 是 可 以 分 解 为 以 下 模式 : 
<DefiningClass> 
<DefiningClass.PropertyOnDefiningClass> 
《<1-- 属性 的 值 --> 


</DefiningClass.PropertyOnDefiningClass> 
</DefiningClass> 


尽管 任何 属性 都 能 使 用 这 种 语法 , 但 如 果 仅 仅 是 要 捕获 简单 字符 串 的 值 , 这 样 就 会 浪费 输入 时 间 。 
例如 ， 像 下 面 这 样 设置 Button 的 Midth 显 得 有 点 嘱 嗪 : 


<Button Height="50" Content="OK!" 
FontSize="20" Foreground="Yellow"> 


<Button.Width> 
100 
</Button.Width> 
</Button> 


27.7.6 XAML 附 加 属性 


除了 属性 元 素 语法 以 外 ，XAML 还 定义 了 特殊 语法 用 来 定义 附加 属性 。 从 根本 上 说 ， 附 加 属性 允 
许 子 元 素 为 定义 在 父 元 素 中 的 属性 定义 唯一 值 。 模 板 通 常 如 下 所 示 : 


<ParentElement> 
<ChildElement ParentElement.PropertyOnParent = "Value"> 
</ParentElement> 


附加 属性 最 常见 的 用 处 就 是 在 WPF 布 局 管理 器 类 ( Grid、DockPanel 等 ) 中 定位 UI 元 素 。 下 一 章 会 
深入 这 些 面 板 的 细节 ， 下 面 在 Kaxaml 中 输入 如 下 代码 : 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Canvas Height="200" Width="200" Background="LightBlue"> 
<Ellipse Canvas.Top="40" Canvas.Left="40" Height="20" Width="20" Fill="DarkBlue"/> 
</Canvas> 
</Page> 


我 们 在 这 里 定义 了 一 个 包含 ELlipse 的 Canvas 布 局 管理 器 。 注 意 ，E11ipse 使 用 了 附加 属性 语法 ， 
通知 父 元 素 ( Canvas ) 它 距离 左上 角 的 位 置 。 

关于 附加 属性 ， 有 几 个 注意 事项 。 首 先 也 是 最 重要 的 ， 它 并 不 是 一 个 全 功能 的 语法 ， 不 能 用 于 所 
有 父 类 型 的 所 有 属性 上 。 例 如 ， 下 面 的 XAML 不 能 通过 解析 : 


《<1-- 错误 | 不 能 用 附加 属性 设置 Canvas 的 Background 属 性 --> 
<Canvas Height="200" Width="200"> 
<Ellipse Canvas.Background="LightBlue" 
Canvas.Top="40" Canvas.Left="90" 
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Height="20" Width="20" Fill="DarkBlue"/> 
</Canvas> 


其 实 ，WPF 包 含 一 种 特定 概念 ， 称 为 依赖 属性 ， 附 加 属性 是 它 的 特殊 形式 。 除 非 属 性 以 某 种 特殊 
的 方式 实现 ， 否 则 不 能 对 其 使 用 附加 属性 语法 。 我 们 将 在 第 31 章 中 详细 介绍 依赖 属性 。 


说 明 ”Kaxaml、Visual Studio、Expression Blend 都 包含 智能 感知 ， 可 以 显示 给 定 元 素 中 有 效 的 依赖 属性 。 


27.7.7 XAML 标 记 扩 展 


如 前 所 述 ， 属 性 值 通常 表示 为 简单 字符 串 或 属性 元 素 语法 。 另 一 种 指定 XAML 特 性 值 的 方法 是 使 
用 标记 扩展 。 它 允许 XAML 解 析 器 从 专门 的 外 部 类 中 获取 属性 的 值 。 这 是 非常 有 好 处 的 ， 因 为 有 些 属 
性 需要 一 些 代码 语句 来 计算 其 值 。 

标记 扩展 使 用 新 的 功能 来 干净 地 扩展 XAML 的 语法 。 它 由 MarkupExtension 的 派生 类 来 表示 。 注意 ， 
你 几乎 不 需要 构建 自 定义 标记 扩展 ,但 实际 上 很 多 XAML 关 键 字 ( 如 x:Array x:Null x:Static、x:Type ) 
都 是 变相 的 标记 扩展 。 

标记 扩展 包含 在 大 括号 内 ， 如 : 


¢Element PropertyToSet = "{MarkUpExtension} /> 
为 了 学 习 标 记 扩 展 ， 在 Kaxaml 中 编写 如 下 标记 : 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:CorLib="clr-namespace:System;assembly=mscorlib"> 


<StackPanel> 
《<1-- Static 标 记 扩 展 从 类 的 静态 成 员 中 获取 值 --> 
<Label Content ="{x:Static CorLib:Environment.0SVersion}"/> 
<Label Content ="{x:Static CorLib:Environment.ProcessorCount}"/> 


<!-- Type 标记 扩展 是 C# typeof 操 作 符 的 XAML 版 本 --> 
<Label Content ="{x:Type Button}" /> 
<Label Content ="{x:Type CorLib:Boolean}" /> 


<1-- 用 字符 囊 数组 填充 ListBox --> 
<ListBox Width="200" Height="50"> 
<ListBox.ItemsSource> 
<x:Array Type="CorLib:String"> 
<CorlLib:String>Sun Kil Moon</CorlLib:String> 
<CorLib:String>Red House Painters</CorLib:String> 
<CorLib:String>Besnard Lakes</CorlLib:String> 
</x:Array> 
</ListBox.ItemsSource> 
</ListBox> 
</StackPanel> 
</Page> 


首先 ， 注 意 <Page> 定 义 了 新 的 XML 命名 空间 声明 ， 可 以 访问 mscorlib.dll 中 的 System 命名 空间 。 有 
了 这 个 XML 命名 空间 ， 我 们 先 使 用 x:Static 标 记 扩 展 ， 并 获取 System.Environment 类 的 0SVersion 和 
ProcessorCount 的 值 。 
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x:Type 标 记 扩 展 可 以 用 来 访问 指定 项 的 元 数据 描述 。 这 里 ,我 们 简单 输出 WPF Button 和 
System.Boolean 类 型 的 完全 限定 名 。 
最 有 趣 的 部 分 是 ListBox。 我 们 用 一 个 完全 声明 在 标记 内 部 的 字符 串 数组 来 设置 ItemSource 属 性 。 
注意 x:Array 标 记 扩 展 是 如 何在 作用 域内 指定 多 个 子 项 的 : 
<x:Array Type="CorlLib:String"> 
<CorLib:String>Sun Kil Moon</CorLib:String> 
《<CorLib:String>Red House Painters</CorLib:String> 


<CorLib:String>Besnard Lakes</CorLib:String> 
</x:Array> 








说 明 上 面 的 XAML 示 例 仅 仅 为 了 演示 标记 扩展 。 你 将 在 第 28 章 中 看 到 更 简单 的 生成 ListBox 控 件 的 
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图 27-14 ”扩展 标记 可 以 通过 专门 的 类 来 设置 值 
此 时 , 你 已 经 看 到 了 很 多 展示 XAML 语 法 各 个 核心 部 分 的 示例 。 你 肯定 会 同意 XAML 是 如 此 有 趣 ， 
它 能 使 你 以 声明 的 方式 描述 .NET 对 象 树 。 这 在 配置 图 形 用 户 界 面 时 十 分 有 用 , 但 要 记 住 , XAML 可 以 
描述 任何 程序 集中 的 任何 类 型 ， 只 要 它 是 一 个 非 抽象 类 型 ， 并 且 包 含 默 认 构造 函数 。 


27.8 使 用 代码 隐藏 文件 构建 WPF 应 用 程序 


本 章 的 前 两 个 示例 演示 了 构建 WPF 应 用 程序 的 极端 情况 ， 仅 使 用 代码 或 仅 使 用 XAML。 但 推荐 的 
构建 WPF 应 用 的 方式 是 使 用 代码 文件 。 在 这 种 模型 下 ,项 目 中 的 XAML 文 件 只 包含 描述 类 一 般 状态 的 
标记 ， 而 代码 文件 包含 了 实现 的 细节 。 
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27.8.1 ”为 MainWindow 类 添加 代码 文件 


为 了 演示 这 种 方法 ,我 们 让 WpfAppAllIXaml 示 例 使 用 代码 文件 。 复 制 整个 文件 夹 ， 并 改名 为 
WpfAppCodeFiles。 现 在 ， 在 该 目录 下 创建 新 的 C# 代 码 文件 MainWindow.xamlcs ( 按照 惯例 ，C# 代 码 
隐藏 文件 的 名 称 为 *.xaml.cs 的 形式 )。 在 文件 中 添加 如 下 代码 : 


// MainWindow.xaml.cs 

using Systemj 

using System.Windows ; 

using System.Windows.Controls; 


namespace WpfAppAllXaml 
{ 
public partial class MainWindow : Window 
public MainWindow() 
{ 


// 记 住 ， 该 方法 定义 在 自动 生成 的 MainWindow.g.cs 文 件 中 
InitializeComponent(); 


} 


private void btnExitApp Clicked(object sender, RoutedEventArgs e) 
this.Close(); 


} 
} 
这 里 , 我 们 定义 了 一 个 包含 事件 处 理 逻 辑 的 分 部 类 , 它 将 与 *.g.cs 文 件 中 定义 的 相同 类 型 的 分 部 类 
进行 合并 。 由 于 InitializeComponent() 定 义 在 MainWindow.g.cs 文 件 中 , 窗口 的 构造 函数 调用 该 方法 来 
加 载 和 处 理 内 众 的 BAML 资 源 。 
MainWindow.xaml 文 件 也 需要 更 新 。 要 取出 前 面 示例 中 的 所 有 C# 代 码 : 
<Window x:Class="WpfAppAllXaml .MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="A Window built using Code Files!" 


Height="200" Width="300" 
WindowStartupLocation ="CenterScreen"> 


《<1-- 事件 处 理 程 序 现在 位 于 代码 文件 中 --> 
<Button x:Name="btnExitApp" Width="133" Height="24" 
Content = "Close Window" Click ="btnExitApp Clicked"/> 
</Window> 


27.8.2 ”为 MyApp 类 添加 代码 文件 


如 果 需 要 ， 也 可 以 为 Application 的 派生 类 型 构建 代码 隐藏 文件 。 由 于 大 多 数 行为 发 生 在 MyApp.g.cs 
文件 中 ， 因 此 MyApp.xaml.cs 中 也 不 过 是 下 面 这 样 : 

// MYyYApp.xaml.cs 

using System; 

using System.Windows ; 
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using System.Windows.Controls; 
namespace WpfAppAllXaml 
public partial class MyApp : Application 


private void AppExit(object sender, ExitEventArgs e) 


{ 
MessageBox.Show("App has exited"); 


} 
} 


MyApp.xaml 文 件 现在 是 这 样 的 : 


<Application x:Class="WpfAppAllXaml .MyApp" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml" 
Exit ="AppExit"> 

</Application> 


27.8.3 ”用 msbuild.exe 处 理 代码 文件 


在 使 用 msbuild.exe 重 新 编译 文件 之 前 ， 需 要 更 新 *.csproj 文 件 ， 使 用 <Compile> 元 素 ( 加 粗 显 示 )， 
使 其 在 编译 过 程 中 包含 新 增加 的 C# 文 件 : 


<Project DefaultTargets="Build”xmlns= 
"http://schemas.microsoft.com/developer/msbuild/2003"> 
<PropertyGroup> 
<RootNamespace>WpfAppAllXaml</RootNamespace> 
<AssemblyName>WpfAppAllXaml</AssemblyName> 
<OutputType>winexe</OutputType> 
</PropertyGroup> 
<ItemGroup> 
<Reference Include="System" /> 
<Reference Include="WindowsBase” /> 
<Reference Include="PresentationCore" /> 
<Reference Include="PresentationFramework" /> 
</ItemGroup> 
<ItemGroup> 
<ApplicationDefinition Include="MyApp.xaml" /> 
<Compile Include = "MainWindow.xaml.cs"” /> 
<Compile Include = "MyApp.xaml.cs" /> 
<Page Include="MainWindow.xaml” /> 
</ItemGroup> 
<Import Project="$(MSBuildBinpath)\Microsoft.CSharp.targets" /> 
<Import Project="$(MSBuildBinpath)\Microsoft.WinFX.targets" /> 
</Project> 


将 构建 脚本 传递 给 msbuild.exe: 

msbuild WpfAppAllXaml .csproj 

你 会 发 现 再 次 生成 了 WpfAppAlIXaml 应 用 程序 的 可 执行 程序 集 ( 还 记得 吗 ， 位 于 bin\Debug 文 件 
夹 )。 就 开发 而 言 ， 我 们 将 外 观 (XAML ) 与 编程 逻辑 ( C# ) 进行 了 彻底 分 离 。 
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这 是 WPF 开 发 的 推荐 方法 ， 在 使 用 Visual Studio ( 或 Expression Blend ) 创建 WPF 应 用 程序 时 ， 将 
总 是 使 用 这 种 代码 隐藏 模型 。 


源 代码 WpfAppCodeFiles 项 目的 源 代码 位 于 Chapter 27 子 目录 下 。 


27.9 使 用 Visual Studio 构建 WPF 应 用 程序 


到 现在 为 止 ， 我 们 都 使 用 普通 的 文本 编辑 器 、 命 令 行 编译 器 和 Kaxaml 来 创建 示例 。 当 然 ， 这 样 做 
是 为 了 更 多 关注 WPF 应 用 程序 的 核心 语法 ， 而 不 是 图 形 化 设计 器 的 各 种 功能 。 然 而 ， 既 然 我 们 已 经 了 
解 如 何 构建 WPF 应 用 程序 ， 下 面 让 我 们 研究 一 下 Visual Studio 是 如 何 简化 构建 WPF 程 序 工 作 的 。 


说 明 我 将 在 本 章 指 出 一 些 使 用 Visual Studio 构 建 WPF 应 用 程序 的 关键 特征 。 下 一 章 会 在 必要 的 时 候 
演示 这 个 IDE 的 其 他 部 分 。 


27.9.1 WPF 项 目 模 板 


Visual Studio 的 New Project 对 话 框 定义 了 一 组 WPF 相 关 的 项 目 模 板 ， 可 以 在 Visual C# 根 的 Window 
节点 下 找到 所 有 的 项 。 此 处 ,我们 可 以 选择 WPF Application、WPF User Control Library、WPF Custom 
Control Library 和 WPF Browser Application ( 如 XBAP )。 我 们 创建 一 个 名 为 WpfTesterApp 的 WPF 
Application ( 如 图 27-15 所 示 )。 
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节点 下 


图 27-15 Visual Studio 的 WPF 项 目 模 板 位 于 Windows 
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它 除了 添加 对 所 有 WPF 程 序 集 ( PresentationCore.dll 、PresentationFramework.dll、System.Xaml.dll 
和 WindowsBase.dll ) 的 引用 之 外 ， 还 为 我 们 提供 了 使 用 代码 文件 和 XAML 表 示 的 初始 的 Window 和 
Application 派 生 类 型 。 图 27-16 所 示 显 示 了 新 的 WPF 项 目的 Solution Explorer 窗 口 。 
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图 27-16 ”WPF 应 用 程序 项 目的 初始 文件 





27.9.2 ”工具 箱 和 XAML 设 计 器 /编辑 器 


Visual Studio 提 供 了 一 个 工具 箱 ( 可 通过 View 菜 单打 开 )， 其 中 包含 很 多 WPF 控 件 ( 如 图 27-17 
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图 27-17 工具 箱 所 包含 的 WPF 控 件 可 以 置 于 设计 器 表面 上 
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使 用 标准 的 鼠标 拖 忠 操作 ， 可 以 将 这 些 控件 放置 于 窗口 设计 器 上 ,或 拖 忠 到 设计 器 下 方 的 XAML 
标记 编辑 器 中 。 然 后 将 自动 生成 XAML。 用 鼠标 将 一 个 Button 和 一 个 Calendar 控 件 拖 忠 到 设计 器 上 。 然 
后 注意 我 们 可 以 重新 放置 控件 ,或 改变 控件 的 尺寸 ( 同时 注意 观察 根据 我 们 的 编辑 而 生成 的 结果 
XAML )。 

除了 可 以 通过 鼠标 和 工具 箱 构建 UI， 也 可 以 在 集成 的 XAML 编 辑 器 中 手工 输入 这 些 标 记 。 如 
图 27-18 所 示 ， 在 输入 标记 时 可 得 到 智能 感知 支持 。 例 如 ， 在 开放 的 <Window> 元 素 中 添加 Background 
属性 。 

花 几 分 钟 时 间 直 接 在 XAML 编辑 器 中 添加 一 些 属 性 。 我 敢 肯 定 还 是 在 WPF 设 计 器 中 添加 属性 更 加 
轻松 。 
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图 27-18 ”WPF 窗 口 设计 革 


27.9.3 ”使 用 Properties 窗 口 设置 属性 


将 控件 放置 到 设计 器 上 ( 或 在 编辑 器 中 手工 定义 ) 之 后 ， 可 以 使 用 Properties 窗 口 设置 所 选 控件 的 
属性 值 和 事件 处 理 程序 ,我 们 进行 一 个 简单 的 测试 , 在 设计 器 中 选择 Button 控 件 。 然后 , 使 用 Properties 
窗口 中 集成 的 画 刷 编辑 器 修改 Button 的 背景 色 ( 如 图 27-19 所 示 , 我 们 将 在 第 29 章 介绍 WPF 图 像 时 详细 
介绍 画 刷 编辑 器 )。 
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说 明 ”Properties 窗 口 的 最 上 方 有 一 个 搜索 文本 框 。 可 以 在 其 中 输入 属性 的 名 称 以 快速 找到 想 要 的 项 。 
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图 27-19 ”Properties 窗 口 可 以 用 来 配置 WPF 控 件 的 UI 
用 画 刷 编辑 器 修改 完 之 后 ， 检 查 生 成 的 标记 ， 可 能 会 如 下 所 示 : 


<Button Content="Button”Height="23”HorizontalAlignment="Left”Margin="12,12,0,0" 
Name="button1" VerticalAlignment="Top" Width="75"> 
<Button.Background> 
<LinearGradientBrush EndPoint="1,0.5" StartPoint="0,0.5"> 
<GradientStop Color="#FF7488CE" Offset="0" /> 
<GradientStop Color="#FFC11E1E" Offset="0.837" /> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 


27.9.4 ”使 用 Properties 窗 口 处 理事 件 


如 果 你 想 处 理 给 定 控件 的 事件 , 也 可 以 使 用 Properties 窗 口 , 但 这 时 要 点 击 Properties 窗 口 右 上 方 的 
Events 按 钮 ( 找到 闪电 图 标 )。 确 保 选 中 设计 器 中 的 按钮 ， 单 击 Eventes 选 项 卡 ， 找 到 click 事 件 并 双击 
右 侧 的 条 目 。Visual Studio 将 自动 构建 如 下 形式 的 事件 处 理 程序 : 


NameOfControl NameOfEvent 
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由 于 没有 修改 按钮 的 名 称 ，Properties 窗 口中 显示 生成 的 事件 处 理 程序 的 名 称 为 Button_Click_1 
(如 图 27-20 所 示 )。 


村 PROPERTIES 1 
| 加 Name <No Name> 


Type Button 

Chck Button Click 1 
| ContextMenuClosing 
ContextMenuOpening 
DataContextChanged 
DragEnter 
DragLeave 
DragOver 
Drop 
FocusableChanged 
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Gotfocus 


图 27-20 ”使 用 Properties 窗 口 处 理事 件 


同样 ，Visual Studio 还 在 窗口 代码 文件 中 生成 了 相应 的 C# 事 件 处 理 程序 。 你 可 以 在 其 中 添加 任何 
在 点 击 按钮 时 执行 的 代码 。 比 如 ， 输 入 下 面 的 代码 语句 : 


public partial class MainWindow : Window 





public MainWindow() 


InitializeComponent(); 


private void Button Click 1(object sender, RoutedEventArgs e) 
MessageBox.Show("You clicked the button!"); 
} 


27.9.5 ”在 XAML 编 辑 器 中 处 理事 件 


你 还 可 以 在 XAML 编 辑 器 中 直接 处 理事 件 。 例 如 ， 将 光标 放 到 <Window> 元 素 内 ， 输 入 MouseMove 事 
件 ， 然 后 输入 等 号 ， 此 时 Visual Studio 将 显示 所 有 代码 文件 中 兼容 的 处 理 程序 ( 如 果 代 码 文 件 存 在 的 
话 )， 以 及 <New Event Handler> 选 项 ( 如 图 27-21 所 示 )。 
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图 27-21 ”使 用 XAML 编 辑 器 处 理事 件 


双击 <New Event Handler>，IDE 将 在 C# 代 码 文 件 中 生成 适当 的 处 理 程序 。 在 MouseMove 事 件 处 理 程 
序 中 输入 下 面 的 代码 ， 然 后 运行 程序 查看 最 终结 果 : 


private void Window MouseMove (object sender, MouseEventArgs e) 


this.Title = e.GetPosition(this).ToString(); 


27.9.6 ”Document Outline 窗 口 


在 创建 基于 XAML 的 项 目 ( WPF 、Silverlight、Windows Phone 7 或 Windows 8 应 用 程序 ) 时 ， 我 们 
自然 会 用 大 量 标记 来 表示 UI。 在 处 理 更 加 复杂 的 XAML 时 ， 如 果 能 够 使 标记 可 视 ， 能 快速 选择 Visual 
Studio 设 计 器 中 的 项 进行 编辑 ， 将 是 非常 有 用 的 。 

我 们 目前 的 标记 都 十 分 简单 ， 只 是 在 初始 的 <Grid> 中 定义 了 少许 控件 。 不 管 这 些 ， 找 到 IDE 的 
Documents Outline 窗 口 ， 它 默认 位 于 IDE 的 左下 角 ( 如 果 找 不 到 ， 可 以 通过 View 一 other Windows 菜 音 
选项 激活 该 窗口 )。 现 在 ， 确 保 你 的 XAML 编 辑 器 是 IDE 中 当前 的 激活 窗口 (不 是 C# 代 码 文 件 )， 我 们 
可 以 看 到 Document Outline 展 示 了 内 骨 的 元 素 ( 如 图 27-22 所 示 )。 
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图 27-22 ”通过 Document Outline 窗 口 使 XAML 可视化 
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这 个 工具 还 能 临时 在 设计 器 上 隐藏 给 定 项 ,或 锁定 项 以 防止 编辑 ,在 下 一 章 中 ,你 将 看 到 Document 
Outline 和 窗口 还 提供 了 很 多 其 他 特性 ， 如 将 选中 项 分 组 到 新 的 布局 管理 器 。 


27.9.7 查看 自动 生成 的 代码 文件 


在 构建 本 章 最 后 一 个 示例 之 前 ， 打 开 Solution Explorer 窗 口 ， 单 击 Show All Files 按 钮 ( 如 图 27-23 
所 示 )。 注 意 目前 显示 的 是 BAML 和 *#.g.cs 文 件 (位 于 obj\Debug 文 件 夹 下 )。 虽 然 不 推荐 在 自动 生成 的 
文件 中 手动 添加 代码 ， 但 本 章 前 面 的 示例 可 以 帮助 我 们 理解 如 何 处 理 XAML 。 
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图 27-23 ”使 用 Solution Explorer 查 看 WPF 项 目的 输出 文件 


27.10 使 用 Visual Studio 构建 自 定义 XAML 编辑 器 


我 们 已 经 看 到 了 如 何在 Visual Studio 中 使 用 基本 工具 设计 WPF 窗 体 ， 本 章 的 最 后 一 个 示例 将 构建 
一 个 可 以 在 运行 时 操作 XAML 的 应 用 程序 。 关 闭 当 前 项 目 , 创建 一 个 全 新 的 WPF Application， 取 名 为 
MyXamlPad。 该 项 目 ( 在 完成 时 ) 的 功能 将 和 Kaxaml 类 似 ， 只 是 没 那么 炫 。 具 体 来 说 ,该 应 用 程序 可 
以 输入 任何 格式 良好 的 标记 ， 并 且 点 击 按钮 即 可 将 XAML 动态 呈现 到 新 的 Mindow 对 象 中 。 
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27.10.1 设计 窗口 的 GUI 


WPF API 支 持 以 编程 方式 加 载 、 解 析 和 保存 XAML 描 述 。 对 于 很 多 情况 ， 这 么 做 是 很 有 用 的 。 例 
如 , 假设 我 们 有 5 个 不 同 的 XAML 文 件 , 用 于 描述 一 个 Window 类 型 的 外 观 。 只 要 每 个 文件 中 所 有 控件 ( 和 
必要 的 事件 处 理 程序 ) 名 字 都 一 样 ， 我 们 就 可 以 为 窗口 动态 应 用 “皮肤 ”( 可 能 根据 传人 应 用 程序 的 
起 始 参 数 )。 

运行 时 和 XAML 交 互 需要 使 用 XamlReader 和 XamlWriter 类 型 ， 它 们 都 定义 在 System. 
Windows .Markup 命 名 空间 中 。 为 了 演示 如 何以 编程 方式 从 外 部 *.xaml 文 件 生成 Window 对 象 , 我 们 会 创建 
一 个 WPF 应 用 程序 项 目 来 模仿 Kaxaml 的 基本 功能 。 


说 明 XamlReader 和 XamlWriter 类 提供 了 在 运行 时 操纵 XAML 的 基本 功能 。 如 果 想 完全 控制 XAML 对 
象 模型 ， 可 以 研究 一 下 System.Xaml.dll 程 序 集 。 


虽然 我 们 的 应 用 程序 肯定 不 会 和 Kaxaml 一 样 功 能 完善 , 但 是 它 提供 了 输入 有 效 XAML 标 记 、 查 看 
结果 并 且 保 存 XAML 到 外 部 文件 的 能 力 。 首 先 更 新 Window> 中 初始 的 XAML 定 义 ， 如 下 (建议 此 时 手 
工 输入 这 些 XAML ， 而 像 前 面 那 样 用 IDE 生 成 事件 处 理 程序 ): 


<Window x:Class="MyXamlPad.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="My Custom XAML Editor" 
Height="338" Width="1041" 
Loaded="Window Loaded" Closed="Window Closed" 
WindowStartupLocation="CenterScreen"> 


《<1-- 你 将 会 使 用 DockPanel， 而 不 是 Grid --> 
<DockPanel LastChildFill="True"” > 


《1-- 这 个 按钮 会 启动 具有 已 定义 的 XAMILL 的 窗口 --> 
<Button DockPanel.Dock="Top" Name =“btnViewXam1l”Width="100”Height="40” 
Content ="View Xaml" Click="btnViewXaml Click" /> 


《1-- 它 是 用 于 输入 的 区 域 --> 
<TextBox AcceptsReturn ="True" Name ="txtXamlData" 
FontSize ="14" Background="Black" Foreground="Yellow" 
BorderBrush ="Blue" VerticalScrollBarVisibility="Auto" 
AcceptsTab="True"/> 
</DockPanel> 
</Window> 


说 明 ”下 一 章 会 深入 使 用 控件 和 面板 的 细节 ， 因 此 不 要 对 控件 的 声明 感到 烦躁 。 
首先 ， 注 意 我 们 把 初始 的 <Grid> 替 换 为 <Dockpanel> 布 局 管理 器 了 ， 它 包含 一 个 Button (叫做 


btnViewXaml ) 和 一 个 TextBox ( 叫做 txtXamlData )，Button 类 型 的 Click 事 件 也 被 处 理 了 。 
还 注意 Mindow 自 身 的 Loaded 和 Closed 事 件 在 <Nindow> 开 始 元 素 中 被 处 理 了 ( .同样 , 应 该 像 本 章 前 几 
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节 那 样 使 用 IDE 来 生成 事件 处 理 程 序 )。 如 果 你 使 用 设计 器 来 处 理事 件 的 话 ， 就 会 发 现在 MainWin- 
dow.xaml.cs 文件 中 具有 如 下 的 代码 : 


public partial class MainWindow : Window 
public MainWindow() 


InitializeComponent(); 


private void btnViewXaml Click(object sender, RoutedEventArgs e) 


人 


private void Window Closed(object sender, EventArgs e) 


} 


private void Window Loaded(object sender, RoutedEventArgs e) 


} 
} 


在 继续 之 前 ， 请 一 定 要 为 MainWindow.xaml.cs 文 件 导 人 如 下 的 命名 空间 : 


using System.I0; 
using System.Windows.Markup; 


27.10.2 ”实现 Loaded 事 件 


主 窗 口 的 Loaded 事 件 负责 检测 在 包含 应 用 程序 的 文件 夹 中 是 否 有 一 个 名 为 YourXaml.xaml 的 文件 。 
如 果 文 件 存在 的 话 ， 就 会 读 取 其 中 的 数据 并 放 在 主 窗口 的 TextBox 中 。 如 果 没 有 的 话 ， 就 会 使 用 空 窗口 
默认 的 XAML 描述 来 填充 TextBox ( 这 个 描述 和 初始 的 窗口 定义 一 样 ， 只 是 使 用 <stackPanel> 而 不 是 
<Grid> 来 隐 式 设置 Window 的 Content 属 性 )。 


说 明 ”我 们 构建 的 表示 在 编辑 器 中 显示 的 初始 标记 的 字符 串 很 难 输入 ， 因 为 需要 为 引用 内 容 做 转 义 ， 
请 小 心 输入 。 


private void Window Loaded(object sender, RoutedEventArgs e) 


// 应 用 程序 主 窗口 加 载 的 时 候 ， 
// 把 一 些 基 本 的 XAMIL 文 本 放 到 文本 框 内 
if (File.Exists("YourXaml .xaml")) 


txtXamlData. Text = File.ReadAllText("YourXaml .xaml"); 


else 
txtXamlData. Text = 
"<Window xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n" 
+"xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n" 
+"Height =\"400\" Width =\"500\" WindowStartupLocation=\"CenterScreen\">\n" 
+"<StackPanel>\n" 
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+"</StackPanel>\n" 
+"</Window>"; 
} 
j 


使 用 这 个 方式 ， 应 用 程序 就 可 以 加 载 前 面 会 话 中 输入 的 XAML,， 或 必要 的 时 候 提 供 默 认 的 标记 片 
段 。 至 此 ， 你 应 该 可 以 运行 程序 并 且 在 TextBox 类 型 中 找到 如 图 27-24 所 示 的 显示 。 


「 [=1s 
| My Custom XAML Editor 4 加 


| 











| 
| 





<Window xmins="http://schemas.microsoft com/winfx/2006/xami/presentation" 
xmins:x="http://fschemas.microsoft.com/winfx/2006/xamil” 

Height ="400" Width ="500" WindowStartuplLocation="CenterScreen” > 
<StackPanel> 

</StackPanel> 

</Window> 








图 27-24 MyXamlPad.exe 首 次 运行 


27.10.3 ”实现 按钮 的 Click 事 件 


如 果 你 单 击 Button 类 型 ， 就 会 先 把 TextBox 中 当前 的 数据 保存 到 YourXaml.xaml 文 件 中 。 至 此 ， 你 
就 可 以 通过 File.0pen() 读 取 持 久 化 的 数据 来 获取 Filestream。 这 是 必需 的 ， 因 为 XamlReader.Load() 方 
法 需要 一 个 Stream 派 生 类 型 〈 而 不 是 简单 的 System.String ) 来 表示 要 解析 的 XAML。 

在 加 载 了 你 希望 构建 的 Mindow> 的 XAML 摘 述 之 后 ， 根 据 内 存 中 的 XAML 创建 system.Nindows . 
Window 的 实例 ， 并 且 以 模式 对 话 框 显示 Window， 如 下 所 示 : 

private void btnViewXam] Click(object sender, RoutedEventArgs e) 


// 把 文本 框 中 的 数据 写 入 本 地 的 *.xaml 文 件 中 
File.WriteAllText("YourXaml .xaml", txtXamlData.Text); 


// 这 个 Window XAML 会 被 动态 解析 
Window myWindow = null; 

// 打开 本 地 *.xaml 文 件 

try 


using (Stream sr = File.Open("YourXaml.xaml", FileMode.Open)) 


// 把 XAML 连 接 到 Mindow 对 象 
myWindow = (Window)XamlReader.Load(sr); 


// 将 窗口 显示 为 对 话 框 并 清除 掉 
myWindow. ShowDialog(); 
myWindow.Close(); 

myWindow = null; 
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} 
catch (Exception ex) 
MessageBox.Show(ex.Message); 
} 
注意 ， 我 们 使 用 try/catch 块 来 包装 我 们 很 多 的 逻辑 。 这 样 ， 如 果 YourXaml.xaml 包 含 了 非法 格式 
的 标记 , 就 可 以 在 结果 对 话 框 中 看 到 错误 。 例如 , 运行 程序 , 故意 拼 错 <StackPanel>, 如 多 写 了 一 个 P。 
单 击 按钮 ， 将 看 到 类 似 图 27-25 所 示 的 错误 。 


My Custom XAML Editor 








View Xaml 





<Window xmins="http://schemas.microsoftL com/winfxf2006/xamil/presentation”™ 

xmins:x="http://schermas.microsoft.com/winfx/2006/xami" 

Height ="400" Width ="*S00" WindowStartuplocation="CenterScreen" > 

<StackpPanel> 

</StackPanel> 

</Window> 
The 'Stackppanel start tag on line 4 position 2 does not match the end tag of 
‘StackPanel', Line 5, position 3. 





图 27-25 ”捕获 标记 错误 


27.10.4 实现 Closed 事件 
最 后 ，Window 类 型 的 closed 事 件 会 确保 TextBox 中 最 新 的 数据 持久 化 到 YourXaml.xaml 文 件 中 : 


private void Window Closed(object sender, EventArgs e) 


// 把 文本 框 中 的 数据 写 到 本 地 *.xaml 文 件 中 
File.WriteAllText("YourXaml .xaml", txtXamlData.Text); 
Application.Current.Shutdown(); 


27.10.5 测试 应 用 程序 


现在 启动 程序 并 且 在 文本 区 域 中 输入 一 些 XAML。 要 知道 ( 和 Kaxaml 一 样 )， 这 个 程序 不 允许 我 
们 指定 任何 代码 生成 相关 的 XAML 特 性 ( 如 class 或 事件 处 理 程序 )。 作 为 第 一 个 测试 , 在 <StackPanel> 
区 域内 输入 下 面 的 XAML : 


<Button Height = "100" Width = "100" Content = "Click Me!"> 
<Button.Background> 
<LinearGradientBrush StartPoint = "0,0" EndPoint = "1,1"> 
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"Blue" Offset = "0" /> 
"Yellow" Offset = "0.25" /> 
"Green" Offset = "0.75" /> 
"pink" Offset = "0.50" /> 


<GradientStop Color 
<GradientStop Color 
<GradientStop Color 
<GradientStop Color 
</LinearGradientBrush> 
</Button.Background> 
</Button> 


在 单 击 了 按钮 之 后 ， 我 们 就 会 看 到 一 个 窗口 呈现 了 我 们 的 XAML 定 义 。( 也 许 会 看 到 一 个 消息 框 
有 个 错误 解析 ， 它 在 检查 输入 ! ) 图 27-26 显 示 了 可 能 的 输出 。 


II IE AN 





- _ a _ 
| 7 My Custom XAML Editor 呈 加 3 





号 








XxmMIns:x= Up/schemas.mcrosottcom/ Wn ZO0Ub/Xamtr 
| | Height ="400™ Width ="500" WindowStartupLocation="CenterScreen” > 
<StackPanel> 
<Button Height = "100" Width = "100" Content = "Click Me!”"> 
<Button.Background> 
<LinearGradientBrush StartPoint = "0,0" EndPoint = "1,1"> 
<GradientStop Color = "Blue" Offset = "0" /> 
<GradientStop Color = "Yellow" Offset = "0.25" /> 
<GradientStop Color = "Green” Offset = "0.75" /> 
<GradientStop Color = “Pink” Offset = "0.50" /> 
</LinearGradientBrush> 
<fButton.Background> 
</Button> 











图 27-26 ”MyXamlPad.exe 实 战 


现在 ,在 <Button> 定 义 后 面 直接 输入 下 面 的 XAML 标 记 : 


<Label Content = "Interesting..."> 
<Label .Triggers> 
<EventTrigger RoutedEvent = "Label.Loaded"> 
<EventTrigger.Actions> 
<BeginStoryboard> 
<Storyboard TargetProperty = "FontSize"> 
<DoubleAnimation From = "12" To = "100" Duration = "0:0:4" 
RepeatBehavior = "Forever"/> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger.Actions> 
</EventTrigger> 
</Label .Triggers> 
</Label> 


这 一 标记 很 好 地 阐明 了 XAML 的 真正 强大 之 处 。 测 试 该 标记 ， 你 会 发 现 创建 了 一 个 简单 的 动画 序 
列 。 动画 服务 ( 和 图 像 呈 现 ) 将 在 后 续 章 节 详 细 介 绍 。 不 过 你 可 以 调整 这 里 的 XAML 来 查看 最 终结 果 。 


27.10.6 ”探索 WPF 文档 


在 本 章 最 后 , 我 想 指 出 的 是 , .NET 4.5 Framework SDK 文 档 有 一 个 完整 的 章节 专门 介绍 WPF 主 题 。 
在 学 习 这 个 API 和 阅读 本 书 其 他 WPF 相 关 章 节 的 时 候 ， 如 果 及 时 并 经 常 参考 帮助 系统 的 话 ， 对 你 来 说 
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将 是 莫大 的 帮助 。 你 在 那里 可 以 看 到 大 量 XAML 示 例 、 详 细 的 教程 ( 主题 广泛 ， 从 3D 图 像 编程 到 复杂 


的 数据 绑 定 操作 )。 
WPF 文 档 位 于 .NET Framework 4.5 一 .NET Framework Development Guide 一 Developing Client 


Applications 下 ( 如 图 27-27 所 示 )。 


:3 CONTENTS SO en 的 计 光 用 
Filter Contents 万 


4 .NET Framework Development Guide 
NET Framework Application Essentials 
> Dataand Modeling 
4 Developing Client Applications | 
| 
; Getting Started (WPF) | 
Application Development 三 
> XAML in WPF | 到 
>» Layout 
Controls | 
5 Data Binding (WPF) 信 
; Properties 
》 Events (WP 
Input 
Graphics and Multimedia 
Securty (WP 月 
Advanced 
Class Library (WP 
b WPF Tools 


4 ee ne ; 


CONTENTS INDEX FAVORITES SEARCH 
图 27-27 NET 4.5 Framework SDK 文 档 提 供 了 多 方位 的 WPF 帮 助 


在 查看 帮助 系统 时 ， 你 会 发 现 大 量 的 XAML 示 例 ， 可 以 直接 复制 到 剪贴 板 并 粘贴 到 自 定义 的 
XAML 编辑 器 中 。 但 是 , 在 测试 前 要 确保 根 元 素 从 <pPage> 改 成 <Window> (我们 的 应 用 程序 不 是 显示 Page 
对 象 , 而 是 Window 对 象 )。 在 开始 下 一 章 之 前 , 你 可 以 花 些 时 间 深 入 感 兴趣 的 话题 ， 并 在 自 定义 的 工具 
里 测试 其 他 标记 。 





源 代 码 MyXamlPad 项 目的 源 代码 位 于 Chapter 27 子 目录 下 。 


27.11 ”小结 


WPF 是 .NET 3.0 发 布 后 引入 的 用 户 界 面 工具 包 。WPF 的 主要 目的 是 将 许多 之 前 无 关 的 桌面 技术 
(2D 图 形 、3D 图 形 、 窗 口 和 控件 开发 等 ) 整合 到 一 个 统一 的 编程 模型 中 。 此 外 ，WPF 程 序 一 般 使 用 
XAML， 它 可 以 通过 标记 来 声明 WPF 元 素 的 外 观 。 
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在 本 章 中 我 们 已 经 看 到 了 , XAML 可 以 使 用 声明 语法 描述 .NET 对 象 树 。 在 本 章 研 究 XAML 的 过 程 
中 ,我 们 研究 了 包括 属性 元 素 语法 、 附 加 属性 以 及 类 型 转换 器 和 XAML 标 记 扩 展 在 内 的 新 语法 。 

尽管 对 于 任何 产品 级 的 WPF 应 用 程序 来 说 , XAML 都 是 不 可 或 缺 的 一 部 分 , 但 本 章 的 第 一 个 示例 
演示 的 是 如 何 仅 使 用 C# 代 码 来 构建 WPF 程 序 。 然 后 演示 了 如 何 仅 使 用 XAML ( 我们 并 不 推荐 这 么 做 ， 
但 这 是 一 次 有 用 的 学 习 训 练 ) 构建 WPF 程 序 。 最 后 , 我 们 学 习 了 使 用 “代码 文件 ”将 外 观 和 功能 分 离 。 

本 章 构建 的 最 后 一 个 WPF 应 用 程序 使 用 XamlReader 和 XamlWriter 类 ， 以 编程 方式 与 XAML 定 义 进 
行 交互 。 在 介绍 这 些 示例 的 过 程 中 ， 你 也 学 习 了 Visual Studio 的 核心 WPF 设 计 器 。 在 后 面 的 章节 ， 你 
还 将 学 习 更 多 关于 WPF 设 计 器 的 知识 。 


第 28 章 
LE 使 用 WPF 控 件 编程 ， 











27 章 讲解 了 WPF 编 程 模型 的 基础 ， 包 括 Window 和 Application 类 的 介绍 、XAML 的 语法 和 代 
码 文件 的 用 法 。 第 27 章 还 介绍 了 使 用 Visual Studio 设 计 器 构建 WPF 应 用 程序 的 过 程 。 本 章 将 
使 用 一 些 新 的 控件 和 布局 管理 器 ， 并 学 习 Visual Studio 中 WPF 设 计 器 的 其 他 特性 。 
本 章 还 将 介绍 一 些 与 WPF 控 件 相 关 的 重要 话题 ， 如 数据 绑 定 编程 模型 和 控件 命令 的 用 法 。 你 将 学 
习 如 何 使 用 mk 和 Documents API, 来 获取 手写 笔 ( 或 鼠标 ) 输 入 , 并 使 用 XML Paper Specification ( XPS ) 
构建 富 文本 文档 。 


说 明 本 书 上 一 版 使 用 了 微软 的 Expression Blend 产 品 来 简化 使 用 WPF API 构 建 GUI 的 过 程 。 不过， 最 
新 版 的 Visual Studio 提 供 了 足够 的 功能 来 构建 本 书 所 设计 的 WPF UI。 如 果 要 学 习 使 用 
Expression Blend 的 细节 ， 可 以 参阅 笔者 的 另 一 本 书 Pro Expression Blend 4 (2011，Apress )。 


28.1 WPF 核心 控件 概述 


不 管 过 去 使 用 过 哪 种 GUI 工 具 包 ( VB 6.0、MFC Java AWT/Swing 、Windows Forms .Mac OS X[Cocoa] 
和 GTK+/GTK# 等 )， 除 非 你 对 创建 图 形 用 户 界面 非常 陌生 ,否则 主要 WPF 控 件 的 普通 用 途 对 你 来 说 不 
是 什么 问题 。 表 28-1 列 出 的 WPF 核 心 控件 看 起 来 非常 熟悉 。 


表 28-1 WPF 的 核心 控件 
WPF 控 件 类 别 成 员 示 例 说 了 明 
核心 用 户 输入 控件 Button 、RadioButton 、ComboBox 、CheckBox 、 WPF 提 供 了 完整 的 控件 族 ， 用 于 创建 用 
Calender 、DatePicker 、Expander 、DataGrid 、 户 界面 的 核心 
ListBox 、ListView 、ToggleButton 、TreeView、 
ContextMenu 、ScrollBar 、Slider 、TabControl 、 
TextBlock、 TextBox、 RepeatButton、 RichTextBox、 
Label 
窗口 修饰 控件 Menu、ToolBar、StatusBar、ToolTip、ProgressBar ”这 些 UI 元 素 用 于 装饰 Window 对 象 框架 ， 
它们 包含 输入 工具 ( 如 Menu ) 和 用 户 信 
息 元 素 ( StatusBar 、ToolTip 等 ) 


媒体 控件 Image、 MediaElement 、SoundPlayerAction 这 些 控 件 支 持 音频 /视频 的 重 放 和 图 像 
的 显示 
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( 续 ) 
WPF 控 件 类 别 成 员 示例 说 明 
布局 控件 Border 、Canvas 、DockpPanel 、Grid 、GridView 、 为 了 便于 布局 管理 ，WPF 提 供 了 许多 用 


GridSsplitter 、GroupBox 、Panel 、TabControl 、 来 分 类 和 组 织 其 他 控件 的 控件 
StackPanel 、Viewbox、WrapPanel 


28.1.1 WPF Ink 控 件 


除了 表 28-1 中 列 出 的 常用 WPF 控 件 外 ，WPF 还 定义 了 其 他 一 些 使 用 了 数字 Ink API 的 控件 。 这 对 平 
板 PC 的 开发 是 十 分 有 用 的 ， 因 为 它 可 以 捕获 手写 笔 输 入 。 但 这 并 不 是 说 标准 的 桌面 应 用 不 能 使 用 Ink 
API， 因 为 同样 的 控件 也 可 以 使 用 鼠标 捕获 输入 。 

PresentationCore.dll 中 的 System.Windows.Ink 命 名 空间 包含 多 个 Ink API 支 持 的 类 型 ( 如 Stroke 和 
strokecollection )。 但 是 ， 大 部 分 Ink API 控件 ( 如 InkCanvas 和 Inkpresenter ) 及 常用 的 WPF 控 件 都 被 打 
包 在 PresentationFramework.dll 程 序 集 的 System.Windows .Controls 命 名 空间 下 。 本 章 稍 后 将 介绍 Ink API。 


28.1.2 WPF Document 控 件 


WPF 还 为 高 级 文档 处 理 提供 了 控件 ,使 我 们 构建 的 应 用 程序 拥有 Adobe PDF 风 格 。 使 用 
System.Widows .Documents 命 名 空间 ( 同样 位 于 PresentationFramework.dll 程 序 集 ) 中 的 类 型 ， 可 以 创建 
用 来 打印 的 文档 ， 它 们 支持 缩放 、 搜 索 、 用 户 批 注 (便签 ) 和 其 他 富 文本 服务 。 

然而 在 后 台 , 文档 控件 并 没有 使 用 Adobe PDF API， 而 是 用 XPS API。 对 于 最 终 用 户 来 说 ,显示 起 
来 没有 任何 区 别 ， 因 为 PDF 文 档 和 XPS 文 档 有 着 几乎 完全 相同 的 外 观 。 事 实 上 ， 很 多 免费 工具 都 可 以 
在 运行 时 对 这 两 种 文件 进行 相互 转换 。 在 接 下 来 的 示例 中 ， 我 们 会 使 用 该 文档 控件 的 一 部 分 功能 。 


28.1.3 ”WPF 公共 对 话 框 


WPF 还 提供 了 一 些 公共 对 话 框 ， 如 0penFileDialog 和 SaveFileDiaiog， 这 些 对 话 框 都 定义 在 
PresentationFramework.dll 程 序 集 的 Microsoft.Win32 命 名 空间 下 。 使 用 它们 都 要 创建 一 个 对 象 ， 然 后 
调用 ShowDialog() 方 法 ， 如 下 所 示 : 


using Microsoft.Win32; 
namespace WpfControls 
public partial class MainWindow : Window 
public MainWindow() 


InitializeComponent(); 


private void btnShowDlg Click(object sender, RoutedEventArgs e) 


// 显示 文件 保存 对 话 框 
SaveFileDialog saveDlg = new SaveFileDialog(); 
saveDlg. ShowDialog(); 


28.1 ”WPF 核心 控件 概述 943 


} 
} 
} 


如 你 所 料 ， 这 些 类 的 成 员 用 来 建立 文件 过 滤器 和 目录 路 径 , 并 访问 用 户 选择 的 文件 。 后面 的 示例 
将 使 用 这 些 文件 对 话 框 ， 你 还 将 学 习 如 何 构建 自 定义 对 话 框 以 收集 用 户 输入 。 


28.1.4 ”文档 中 的 细节 


不 管 你 怎么 想 ， 本 章 的 目的 并 不 是 要 介绍 每 个 WPF 控 件 中 的 每 个 成 员 ， 而 是 要 概述 核心 控件 ， 并 
强调 基本 的 编程 模型 ( 依赖 属性 、 路 由 事件 等 命令 等 ) 和 大 部 分 WPF 控 件 都 有 的 核心 服务 。 

为 了 加 深 对 给 定 控件 的 功能 的 理解 ， 请 查阅 .NET Framework 4.5 SDK 文 档 ， 特 别 是 帮助 系统 的 控 
件 库 一 节 ， 它 位 于 Windows Presentation Foundation 一 Controls ( 如 图 28-1 所 示 )。 


Filter Contents 


4 Windows Presentation Foundation 
> Getting Started (WPF) 
b Application Development 
>” WPF Fundamentals 
4 Controls | 
b Walkthroughs: Create a Custom Animated Butt | 
Border | 
BulletDecorator , 
> Button 
Calendar 
b Canvas 
CheckBox 
ComboBox 
> ContetMenu 
by DataGrid 
DatePicker 
b DockPanel 
DocurmentViewer 





b Expander 


FlowDocumentPageViewer 


HowDocumentReader 
a eT ee FETT | 





4 
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图 28-1 每 个 WPF 控 件 完整 的 介绍 可 以 通过 按 F1 键 取得 


在 这 里 ， 可 以 查找 到 每 个 控件 的 完整 介绍 、 各 种 代码 示例 (XAML 和 C# )、 关 于 控件 继承 链 的 信 
息 、 实 现 的 接口 和 应 用 的 特性 。 一 定 要 花 点 时 间 浏 览 本 章 所 介绍 的 这 些 控件 的 完整 细节 。 
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28.2 Visual Studio WPF 设计 器 


这 些 标准 的 WPF 控 件 大 多 位 于 PresentationFramework.dll 程 序 集 的 System.Windows .Controls 命 名 空 
间 下 。 使 用 Visual Studio 构 建 WPF 应 用 程序 时 ， 如 果 激 活 一 个 WPF 设 计 器 ， 就 可 以 在 Toolbox 中 看 到 其 


中 大 多 数 常 见 控件 ( 如 图 28-2 所 示 )。 


法 TOOLBOX 汉 


Search Tooibox 


4 AllWPF Controls 


从 
过 
留 
司 
万 
回 
(ey 
© 
© 
个 
La 
下 





Pointer 

Border 

Button 
Calendar 
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图 28-2 ”Visual Studio Toolbox 中 包含 内 置 的 WPF 控 件 


和 用 Visual Studio 创 建 的 其 他 UI 框架 类 似 ， 你 可 以 将 这 些 控 件 拖 忠 到 WPF 窗 口 设计 器 上 ， 并 使 用 
Properties 窗 口 进 行 配 置 (第 27 章 已 经 介绍 过 )。 尽 管 Visual Studio 可 以 为 我 们 生成 大 量 XAML ， 但 手工 
编辑 标记 也 是 很 常见 的 。 让 我 们 先 来 回顾 一 下 基础 知识 。 


28.2.1 


在 Visual Studio 中 使 用 WPF 控 件 


第 27 章 介绍 过 , 当 在 Visual Studio 的 设计 器 中 放置 WPF 控 件 时 , 可 以 通过 Properties 窗 口 设置 x:Name 
属性 ， 因 为 这 样 就 可 以 在 C# 代 码 文件 中 访问 该 对 象 。 你 可 能 还 记得 我 们 可 以 使 用 Properties 窗 口中 的 
Events 选 项 卡 ， 为 选中 的 控件 生成 事件 处 理 程序 。 因 此 ， 你 可 以 使 用 Visual Studio 为 一 个 简单 的 Button 


控件 生成 如 下 标记 : 
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<Button x:Xame="btnMyButton" Content="Click Me!l" Height="23" Width="140" 
Click="btnMyButton_Click"” /> 


你 可 以 将 Button 的 Content 属 性 设置 为 简单 的 字符 串 “Click Me!”。 但 有 了 WPF 控 件 内 容 模型 ， 
你 还 可 以 让 Button 包 含 如 下 复杂 的 内 容 : 


<Button x:Name="btnMyButton" Height="121" Width="156" Click="btnMyButton Click"> 
<Button.Content> 
<StackPanel Height="95" Width="128" Orientation="Vertical"> 
<Ellipse Fill="Red" Width="52" Height="45" Margin="5"/> 
<Label Width="59" FontSize="20" Content="Click!" Height="36" /> 
</StackPanel> 
</Button.Content> 
</Button> 


你 也 许 还 记得 ，ContentControl 派 生 类 的 第 一 个 子 元 素 即 为 隐 含 的 内 容 。 因 此 ， 在 指定 复杂 内 容 
时 ， 没有 必要 显 式 定 义 <Button.Content> 作 用 域 。 你 可 以 简单 地 编写 如 下 标记 : 


<Button x:Name="btnMyButton" Height="121" Width="156" Click="btnMyButton Click"> 
<StackPanel Height="95" Width="128" Orientation="Vertical"> 
<Ellipse Fill="Red" Width="52" Height="45" Margin="5"/> 
<Label Width="59" FontSize="20" Content="Click!" Height="36" /> 
</StackPanel> 
</Button> 


在 这 两 种 方法 中 , 我 们 都 将 按钮 的 Content 属 性 设置 为 相关 项 的 <StackPanel>。 你 还 可 以 使 用 Visual 
Studio 的 设计 器 来 指定 这 种 复杂 内 容 。 在 为 内 容 控件 定义 好 布局 管理 器 后 ， 在 设计 器 中 选中 它 ， 就 可 
以 将 其 作为 内 部 控件 的 拖 忠 目标 。 然 后 ， 就 可 以 在 Properties 窗 口中 编辑 它们 了 。 如 果 使 用 Properties 
窗口 来 处 理 Button 控 件 的 Click 事 件 ( 如 前 面 的 XAML 声 明 所 示 ), IDE 将 生成 空 的 事件 处 理 程序 , 你 可 
以 添加 自 定义 代码 。 例 如 : 


private void btnMyButton Click(object sender, RoutedEventArgs e) 


MessageBox.Show("You clicked the button!"); 


28.2.2 ”使 用 Document Outline 编 辑 器 


你 还 应 该 注意 Visual Studio 的 Document Outline 窗 口 (可 以 通过 View 一 Other Windows 菜 单打 开 )， 
Eee ni tn ete 用 的 。 注 意图 28-3 中 显示 了 正在 构建 的 Window 的 XAML 
逻辑 树 。 单 击 某 个 节点 ,将 在 设计 器 中 自动 选中 ， 并 可 以 编辑 。 

当前 版 本 Visual hi 的 Document Outline 编 辑 器 包含 了 其 他 一 些 非常 有 用 的 特性 。 注 意 在 节点 
右边 有 一 个 看 上 去 像 眼 球 的 图 标 。 点 击 该 按钮 ， 可 以 在 设计 器 中 显示 或 隐藏 某 一 项 ， 这 在 你 想 集中 注 
意 力 编辑 特定 的 片段 时 是 非常 有 用 的 〈 注 意 , 这 只 是 在 设计 器 表明 隐藏 指定 的 项 ， 不 会 在 运行 时 隐藏 
该 项 )。 

“眼球 图 标 ” 右 边 的 按钮 可 以 在 设计 器 中 “锁定 ” 某 一 项 。 你 应 该 能 猿 到 它 的 功能 : 人 
地 防止 你 (或 你 的 同事 ) er 实际 上 ， 锁定 项 意味 着 在 设计 时 将 其 置 
读 (在 运行 时 仍然 可 以 改变 其 状态 
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图 28-3 ”Visual Studio 中 的 Document Outline 窗 口 可 以 帮助 你 在 复杂 的 内 容 中 进行 导航 


28.3 ”使 用 面板 控制 内 容 布局 


WPF 应 用 程序 总 是 包含 很 多 UI 元 素 ( 如 用 户 输入 控件 、 图 形 内 容 、 菜 单 系统 和 状态 栏 )， 它 们 需 
要 在 不 同 的 窗口 内 进行 良好 的 组 织 。 在 放置 了 UI 元 素 之 后 ,你 需要 确保 它们 在 用 户 调整 窗口 或 窗口 的 
一 部 分 ( 如 拆 分 窗口 ) 大 小 的 时 候 ， 其 表现 形式 也 能 如 你 所 期 。 为 了 让 WPF 控 件 能 够 保持 在 宿主 窗口 
中 的 位 置 ， 你 可 以 使 用 面板 类 型 ( 作为 布局 管理 器 )。 

默认 情况 下 ， 使 用 Visual Studio 创 建 的 WPF 窗 体 使 用 <Grid> 类 型 的 布局 管理 器 ( 详情 稍 后 介绍 )。 
不 过 我 们 现在 假设 窗 体 没有 声明 布局 管理 器 。 如 下 所 示 : 


<Window x:Class="MyWPFApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 


Title="Fun with Panels!" Height="285" Width="325"> 


</Window> 


如 果 在 不 使 用 面板 的 窗口 中 直接 声明 控件 ,那么 控件 将 被 放置 在 容器 的 正中 央 。 考 虑 下 面 这 个 简 
单 的 窗口 声明 , 它 包含 一 个 Button 控 件 。 不 管 如 何 调整 窗口 大 小 , UI 控件 始终 位 于 客户 端 区 域 的 中 央 。 
Button 的 大 小 取决 于 设置 的 Height 和 Width 属 性 : 


《1-- 该 按钮 始终 位 于 窗口 中 央 --> 

<Window x:Class="MyWPFApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
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Title="Fun with Panels!" Height="285" Width="325"> 


<Button x:Name="btnOK” Height = "100" 
Width="80" Content="OK"/> 
</Window> 


你 也 许 还 记得 ， 如 果 试 图 直接 在 <Window> 作 用 域内 放置 多 个 元 素 ， 将 得 到 标记 和 编译 时 错误 。 原 
因 是 窗口 (或 任何 ContentControl 的 子 类 ) 的 Content 属 性 只 能 设置 一 个 对 象 。 因 此 ， 下 面 的 XAML 会 
产生 标记 和 运行 时 错误 : 


《<1-- 错误 | Content 属 性 被 显 式 设置 了 多 次 --> 

<Window x:Class="MyWPFApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Panels!" Height="285" Width="325"> 


《<1-- 错误 | <Window> 有 两 个 直接 子 元 素 --> 
<Label x:Name="lblInstructions" Width="328" Height="27" 
FontSize="15" Content="Enter Information"/> 
<Button x:Name="btnOK" Height = "100" Width="80" Content="O0K"/> 
</Window> 


只 能 容纳 一 个 控件 的 窗口 显然 没有 任何 用 途 。 如 果 窗 口 需要 包含 多 个 元 素 ， 那么 这 些 元 素 必须 被 
安排 在 多 个 面板 中 。 面 板 可 以 容纳 所 有 表示 窗口 的 UI 元 素 ， 而 面板 本 身 将 作为 唯一 的 对 象 ， 赋 给 窗口 
的 Content 属 性 。 

System.Mindows .Controls 命 名 空间 提供 了 很 多 面板 ， 它 们 控制 着 如 何 维护 子 元 素 。 如 果 最 终 用 户 
调整 窗口 大 小 ， 或 控件 要 保留 在 设计 时 的 位 置 ， 或 控件 从 左 到 右 水 平 回流 或 从 上 到 下 垂直 回流 等 ， 你 
都 可 以 使 用 面板 建立 控件 的 行为 。 

为 了 提供 更 加 灵活 的 控制 ， 你 还 可 以 在 面板 中 使 用 其 他 面板 ( 如 DockPanel 中 包含 stackPanel )。 
表 28-2 列 出 了 一 些 常 用 WPF 面 板 控 件 的 作用 。 

表 28-2 ”核心 WPF 面 板 控 件 


面板 控件 作 用 

Canvas 提供 了 一 个 典型 的 内 容 布 置 模 式 。 其 中 的 项 将 保留 在 设计 时 所 放置 的 确切 位 置 
DockPanel 将 内 容 锁 定 在 面板 的 某 一 侧 ( Top、Bottom、Left、Right ) 

Grid 将 内 容 安 排 在 一 系列 单元 格 中 ， 像 表格 一 样 进行 维护 


StackPanel 将 内 容 按 水 平 或 垂直 方式 进行 堆放 ， 具 体 方式 由 0rientation 属 性 表示 


WrapPanel 从 左 向 右 按 顺 序 放置 内 容 , 在 框 的 边缘 处 将 内 容 断 开 至 下 一 行 。 后 续 排 序 按照 从 上 到 下 或 从 右 到 
左 的 顺序 进行 ， 具 体 取决 于 Orientation 属 性 的 值 


在 下 面 的 几 节 中 ， 我 们 会 将 一 些 预定 义 的 XAML 数 据 复 制 到 第 27 章 创建 的 MyXamlPad.exe 应 用 程 
序 中 ( 如果 愿意 , 你 也 可 以 在 kaxaml.exe 中 加 载 这 些 数据 ), 以 此 来 学 习 如 何 使 用 这 些 常 用 的 面板 类 型 。 
你 可 以 在 代码 下 载 资源 的 Chapter 28 目 录 下 的 PanelMarkup 子 目录 下 找到 这 些 XAML 文 件 ( 如 图 28-4 
所 示 )。 


948 第 28 章 使 用 WPF 控件 编程 





Organtze v include in library v Share with v Burn New folder 















Ham Date rcifiad Type Size 
让 favorite dame te redifieg ype | 
一 ;Desktop GridWithSpliter.xamt Windows Maskup 1 KB 


| 
| 器 Downiczds 区 4 
二 Recent Places 


ScroifViewerxarrd 本 他 1 KB 


Maskup 


人 


SimpleCanvasxaml 


SimpleDockPanel.xaml 


Il « 

| .有 Libraries w SnpleGrid.xaml 2 Kk 

| = Documerts “SmpjleStackPaneixarml 1 KB 
S Music » SimpleWrapPanel.xaml 3 
Ws: Pictures * WindowFrame.xaml KB 
这 Videos 








| 8 tems 


ee ee 


图 28-4 ”为 了 测试 不 同 的 布局 ， 我 们 将 在 MyXamlPad.exe 应 用 程序 中 加 载 提供 的 
XAML 数 据 


28.3.1 在 Canvas 面 板 中 放置 内 容 


在 使 用 Canvas 面 板 时 你 可 能 会 觉得 很 方便 ， 因 为 它 允 许 UI 内 容 使 用 绝对 位 置 。 如 果 用 户 调整 窗口 
的 尺寸 ， 使 其 小 于 Canvas 面 板 所 需 的 布局 ， 那 么 一 部 分 内 容 将 不 可 见 ， 除 非 容 器 的 尺寸 等 于 或 大 于 
Canvas 的 区 域 。 

要 在 Canvas 中 添加 内 容 ， 先 要 在 <Canvas> 和 </Canvas> 标 记 作用 域内 定义 所 需 的 控件 。 然 后 ， 指 定 
每 个 控件 的 左上 角 ， 这 时 要 使 用 Canvas .Top 和 Canvas.Left 属 性 。 控 件 的 右 下 角 可 以 通过 设置 其 Height 
和 Width 属 性 来 间接 指定 ， 或 直接 使 用 canvas .Right 和 Canvas .Bottom 属 性 指定 。 

我 们 在 文本 编辑 器 中 打开 提供 的 SimpleCanvas.xaml 文 件 ， 将 其 内 容 复 制 到 MyXamlPad.exe (或 
kaxaml.exe ) 中 。 你 可 以 看 到 如 下 的 Canvas 定 义 : 


<Window 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 


Title="Fun with Panels!" Height="285" Width="325"> 
<Canvas Background="LightSteelBlue"> 
<Button x:Name="btnOK" Canvas.Left="212" Canvas.Top="203" 
Width="80" Content="OK"/> 
<Label x:Name="lblInstructions" Canvas.Left="17" Canvas.Top="14" 
Width="328" Height="27" FontSize="15" 
Content="Enter Car Information"/> 
<Label x:Name="lblMake" Canvas.Left="17" Canvas.Top="60" 
Content="Make"/> 
<TextBox x:Name="txtMake" Canvas.Left="94" Canvas.Top="60" 
Width="193" Height="25"/> 
《Label x:Name="lblColor" Canvas.Left="17" Canvas.Top="109" 
Content="Color"/> 
<TextBox x:Name="txtColor" Canvas.Left="94" Canvas.Top="107" 
Width="193" Height="25"/> 
<Label x:Name="lblPetName" Canvas.Left="17" Canvas.Top="155" 
Content="Pet Name"/> 
<TextBox x:Name="txtPetName" Canvas.Left="94" Canvas.Top="153" 
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Width="193" Height="25"/> 
</Canvas> 
</Window> 


单 击 View Xaml 按 钮 ， 可 以 在 屏幕 上 看 到 如 下 所 示 的 窗口 ( 如 图 28-5 所 示 )。 














图 28-5 在 Canvas 布 局 管理 器 中 可 以 使 用 内 容 的 绝对 位 置 


注意 , 用 来 计算 内 容 位 置 的 , 不 是 在 Canvas 中 声明 内 容 的 顺序 ， 而 是 控件 的 大 小 以 及 Canvas.Top、 
Canvas.Bottom、Canvas.Left 和 Canvas.Right 属 性 。 


说 明 ”如 果 Canvas 中 的 子 元 素 没有 使 用 附加 属性 语法 ( 如 Canvas.Left 和 Canvas.Top ) 定 义 具 体 的 位 置 ， 
那么 它们 将 自动 附加 到 Canvas 的 左上 角 。 


Canvas 类 型 看 上 去 应 该 为 布置 内 容 的 首选 方式 ( 因为 它 很 简单 ), 但 这 种 方法 却 受 到 一 些 限 制 。 首 
先 , 在 使 用 样式 或 模板 时 ，Canvas 中 的 项 不 能 自动 调整 大 小 (如 字体 大 小 不 会 受到 影响 )。 其 次 ， 当 用 
户 将 窗口 缩小 时 ，Canvas 可 能 无 法 显示 某 些 元 素 。 

最 适合 在 Canvas 中 放置 的 大 概 是 图 形 内 容 。 例 如 ， 如 果 使 用 XAML 构建 自 定 义 图 像 ， 你 当然 希望 
线条 、 形 状 和 文本 都 保留 在 固定 的 位 置 ， 而 不 希望 在 用 户 改 变 窗 口 大 小 时 看 到 它们 动态 地 改变 位 置 。 
在 第 29 章 介绍 WPF 图 形 呈 现 服务 时 ， 我 们 将 再 次 接触 Canvas。 


28.3.2 ”在 WrapPanel 面 板 中 放置 内 容 


WrapPanel 中 的 内 容 将 随 窗 口 大 小 的 变化 而 变化 。 在 WrapPanel 中 放置 元 素 时 ,不 用 像 Canvas 那 样 指定 
上 、 下 、 左 , 右 的 距离 。 但 你 仍然 可 以 为 每 个 子 元 素 定 义 Height 和 Width 值 来 控制 其 在 容器 中 的 整个 尺寸 。 

由 于 WrapPanel 中 的 内 容 没 有 指定 到 面板 某 一 侧 的 距离 , 所 以 声明 元 素 的 顺序 就 显得 十 分 重要 (内 
容 将 按 顺 序 逐 个 呈现 )。 加 载 SimpleWrapPanel.xaml 文 件 中 的 XAML 数 据 ， 可 以 看 到 如 下 标记 (定义 在 
<Window> 之 中 ): 
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<WrapPanel Background="LightSteelBlue"> 
<Label x:Name="lblInstruction" Width="328" 
Height="27" FontSize="15" Content="Enter Car Information"/> 
<Label x:Name="lblMake" Content="Make"/> 
<TextBox x:Name="txtMake" Width="193" Height="25"/> 
<Label x:Name="lblColor" Content="Color"/> 
<TextBox x:Name="txtColor" Width="193" Height="25"/> 
<Label x:Name="lblPetName" Content="Pet Name"/> 
<TextBox x:Name="txtPetName" Width="193" Height="25"/> 
<Button x:Name="btnOK" Width="80" Content="OK"/> 
</WrapPanel> 


加 载 这 些 标记 ， 在 调整 窗口 宽度 时 ， 内 容 将 会 被 打 乱 ， 因 为 它们 在 窗口 中 是 从 左 至 右 依次 排列 的 
( 如 图 28-6 所 示 )。 








i Fun with Panels! 
‘| Enter Car Information ， 








图 28-6 ”WrapPanel 中 内 容 的 行为 更 像 是 传统 的 HTML 页 面 


默认 情况 下 , WrapPanel 中 的 内 容 从 左 向 右 排列 。 但 如 果 将 0rientation 属 性 的 值 改 为 Vertical， 内 
容 则 会 从 上 到 下 排列 : 
<WrapPanel Background="LightSteelBlue" Orientation ="Vertical"> 


在 声明 WrapPanel 时 ( 对 于 其 他 面板 类 型 也 是 一 样 )， 可 以 指定 ItemWidth 和 ItemHeight 值 ， 来 控制 
每 个 子 项 的 默认 尺寸 。 如果 某 个 子 元 素 没有 提供 自己 的 Height 或 width 值 , 将 按 面板 中 指定 的 尺寸 来 放 
置 。 考 虑 如 下 的 标记 : 


<WrapPanel Background="LightSteelBlue" ItemWidth ="200" ItemHeight ="30"> 
<Label x:Name="lblInstruction" 
FontSize="15" Content="Enter Car Information"/> 
<Label x:Name="lblMake" Content="Make"/> 
<TextBox x:Name="txtMake"/> 
<Label x:Name="lblColor" Content="Color"/> 
<TextBox x:Name="txtColor"/> 
<Label x:Name="lblPetName" Content="Pet Name"/> 
<TextBox x:Name="txtPetName"/> 
<Button x:Name="btnOK" Width ="80" Content="0OK"/> 
</WrapPanel> 


这 些 代码 呈现 时 的 输出 结果 如 图 28-7 所 示 ( 注意 Button 控 件 的 尺寸 和 位 置 ， 它 指定 了 一 个 单独 的 
Width 值 )。 
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图 28-7 ”WrapPanel 可 为 给 定 项 建立 宽度 和 高 度 


看 完 图 28-7 后 ,你 可 能 会 发 现 ，WrapPanel 并 不 是 在 窗口 中 直接 放置 内 容 的 最 佳 选择 ， 因 为 在 用 户 
调整 窗口 大 小 时 , 其 内 部 元 素 将 变 得 混乱 不 堪 。 在 大 多 数 情 况 下 ,WrapPanel 都 将 作为 另 一 个 面板 类 型 
的 子 元 素 ， 在 调整 窗口 大 小 时 ，WrapPanel 中 的 内 容 将 会 折 行 显示 ( 如 Toolbar 控 件 )。 


28.3.3 ”在 StackPanel 面 板 中 放置 内 容 


与 WrapPanel 类 似 ，StackPanel 控 件 也 会 根据 0rientation 属 性 的 值 , 将 内 容 水 平 或 垂直 (默认 ) 地 
放置 在 一 行 中 。 但 不 同 的 是 ， 在 用 户 调整 窗口 时 ，StackPanel 不 会 将 内 容 折 行 ， 其 中 的 项 会 根据 面板 
设置 的 方向 简单 地 拉 伸 , 以 适应 StackPanel 的 大 小 ,例如 , SimpleStackPanel.xaml 文 件 包含 的 标记 如 下 ， 
其 输出 结果 如 图 28-8 所 示 。 


“StackpPanel Background="LightSteelBlue"> 
<Label x:Name="lblInstruction" 
FontSize="15" Content="Enter Car Information"/> 
<Label x:Name="lblMake" Content="Make"/> 
<TextBox Name="txtMake"/> 
<Label x:Name="lblColor" Content="Color"/> 
<TextBox x:Name="txtColor"/> 
<Label x:Name="lblPetName" Content="Pet Name"/> 
<TextBox x:Name="txtPetName"/> 
<Button x:Name="btnOK" Width ="80" Content="0K"/> 
</StackPanel> 





图 28-8 垂直 堆放 的 内 容 
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如 果 将 0rientation 属 性 设置 为 Horizontal， 呈 现 的 输出 结果 将 如 图 28-9 所 示 。 


<StackPanel Background="LightSteelBlue" Orientation ="Horizontal"> 




















图 28-9 水 平 堆放 的 内 容 


与 WrapPanel 一 样 ， 你 很 少 会 使 用 stackPanel 直 接 在 窗口 中 放置 内 容 。StackPanel 总 是 作为 主 面板 
的 一 个 子 面 板 出 现 。 


28.3.4 在 Grid 面板 中 放置 内 容 


在 WPF API 提 供 的 所 有 面板 中 ，Grid 是 最 灵活 的 一 个 。 和 HTML 表 格 类 似 ，Grid 可 以 被 划分 为 一 
组 单元 格 ， 每 个 单元 格 中 都 可 以 放置 内 容 。 在 定义 Grid 时 ， 要 执行 以 下 3 个 步骤 。 

(1) 定义 并 配置 列 。 

(2) 定义 并 配置 行 。 

(3) 使 用 附加 属性 语法 设置 每 个 单元 格 中 的 内 容 。 


说 明 如 果 不 定义 任何 行 或 列 ， 《Grid> 默 认为 一 个 单元 格 ， 包 含 窗 口 的 整个 界面 。 此 外 ， 如 果 不 为 
<Grid> 中 的 某 个 子 元 素 设 置 单 元 格 值 ， 将 自动 附加 为 第 0 列 第 0 行 。 





实现 前 两 个 步骤 ( 定义 列 和 行 ) 时 , 可 以 使 用 <Grid.ColumnDefinitions> 和 <Grid.RowDefinitions> 
元 素 ， 它 们 分 别 包 含 <ColumnDefinition> 和 <RowDefinition> 元 素 的 集合 。 网 格 中 的 每 个 单元 格 都 是 一 
个 真正 的 .NET 对 象 ， 因 此 你 可 以 根据 喜好 配置 每 个 单元 格 的 外 观 和 行为 。 

下 面 是 一 个 Grid> 定 义 〈 位 于 SimpleGrid.xaml 文 件 中 )， 它 放置 了 如 图 28-10 所 示 的 UI 内 容 。 


<Grid ShowGridLines ="True" Background ="LightSteelBlue"> 
<1-- 定义 行 和 列 --> 
<Grid.ColumnDefinitions> 
<ColumnDefinition/> 
<ColumnDefinition/> 
</Grid.ColumnDefinitions> 
<Grid.RowDefinitions> 
<RowDefinition/> 
<RowDefinition/> 
</Grid.RowDefinitions> 


《1-- 现在 向 网 格 中 的 单元 格 中 添加 元 素 --> 

<Label x:Name="lblInstruction" Grid.Column ="0" Grid.Row ="0" 
FontSize="15" Content="Enter Car Information"/> 

<Button x:Name="btnOK" Height ="30" Grid.Column ="0" 
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Grid.Row ="0”Content="0K"/> 
<Label x:Name="lblMake”" Grid.Column ="1" 
Grid.Row ="0" Content="Make"/> 
<TextBox x:Name="txtMake" Grid.Column ="1" 
Grid.Row ="0" Width="193" Height="25"/> 
<Label x:Name="lblColor”" Grid.Column ="0" 
Grid.Row ="1" Content="Color"/> 
<TextBox x:Name="txtColor" Width="193" Height="25" 
Grid.Column ="0" Grid.Row ="1" /> 


《1-- 为 了 让 整个 示例 更 有 趣 点 儿 ， 在 Pet Name 单 元 格 中 添加 一 些 颜 色 --> 
<Rectangle Fill ="LightGreen”Grid.Column ="1" Grid.Row ="1" /> 
<Label x:Name="lblPetName" Grid.Column ="1" Grid.Row ="1" Content="Pet Name"/> 
<TextBox x:Name="txtPetName" Grid.Column ="1" Grid.Row ="1" 
Width="193" Height="25"/> 
</Grid> 


注意 , 每 个 元 素 ( 包括 浅 绿色 的 Rectangle 元 素 ) 都 使 用 Grid.Row 和 Grid.Column 附 加 属性 将 它们 本 
身 连 接 到 网 格 中 的 某 个 单元 格 。 默 认 情 况 下 ， 单 元 格 的 顺序 是 从 左上 角 开 始 的 ,左上 角 使 用 
Grid.Column="0" rid.Row="0" 指 定 。 由 于 我 们 的 网 格 定 义 了 4 个 单元 格 , 那么 右 下 角 的 单元 格 就 可 以 用 
Grid.Column="1" Grid.Row="1" 来 识别 。 








图 28-10 Grid 面板 


使 用 GridSplitter 类 型 

Grid 对 象 还 支持 拆 分 器 (splitter )， 人 允许 用 户 调整 网 格 类 型 中 行 或 列 的 大 小 。 每 个 可 调整 大 小 的 单 
元 格 都 会 根据 所 包含 的 项 进行 重 塑 。 向 Grid 中 添加 拆 分 器 是 很 简单 的 ， 只 需要 定义 <Gridsplitter> 控 
件 ， 并 使 用 附加 属性 语法 指定 要 拆 分 的 行 或 列 。 

注意 ， 你 必须 指定 拆 分 器 的 Width 或 Height 值 (根据 水 平 拆 分 或 垂直 拆 分 )， 才 能 将 其 显示 在 屏幕 
上 。 考 虑 下 面 这 个 简单 的 Grid 类 型 ， 它 的 拆 分 器 在 第 一 列 ( Grid.Column="0" )。GridWithSplitter.xaml 
文件 中 的 内 容 如 下 所 示 : 
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<Grid Background ="LightSteelBlue"> 
<!-- 定义 列 --> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width ="Auto"/> 
<ColumnDefinition/> 
</Grid.ColumnDefinitions> 


《<1-- 在 第 一 个 单元 格 中 添加 这 个 标签 --> 
<Label x:Name="lblLeft" Background ="GreenYellow" 
Grid.Column="0" Content ="Left!"/> 


《1-- 定义 拆 分 器 --> 
<GridSplitter Grid.Column ="0" Width ="5"/> 


《1-- 在 第 二 个 单元 格 中 添加 下 面 的 标签 --> 
<Label x:Name="lblRight" Grid.Column ="1" Content ="Right!"/> 
</Grid> 


首先 ， 注 意 支持 拆 分 器 的 列 的 Witdh 属 性 值 为 Auto。 其 次 ,注意 <Gridsplitter> 使 用 了 附加 属性 语 
法 来 定义 要 应 用 到 哪 一 列 。 查 看 输出 结果 ， 可 以 看 到 一 个 5 像素 的 拆 分 器 ， 它 允许 你 调整 每 个 标签 的 
大 小 。 注意 , 由 于 没有 指定 Label 的 Height 或 Width 属 性 , 因此 它们 将 充满 整个 单元 格 ( 如 图 28-11 所 示 )。 


ssp 









图 28-11 包含 拆 分 器 的 网 格 类 型 


28.3.5 “在 Dockpanel 面 板 中 放置 内 容 


DockPanel 通 常 作为 持 有 多 个 面板 的 容器 ， 来 对 相关 内 容 进 行 分 组 。DockPanel 使 用 附加 属性 语法 
(与 Canvas 和 Grid 类 型 类 似 ) 来 控制 DockPanel 中 的 每 一 项 如 何 停 靠 。 
SimpleDockPanel.xaml 文 件 定 义 了 一 个 简单 的 DockPanel， 它 将 产生 如 图 28-12 所 示 的 输出 结果 : 


<DockPanel LastChildFill ="True"> 
<1-- 将 各 项 停靠 在 面板 上 --> 
<Label x:Name="lblInstruction" DockPanel.Dock ="Top" 
FontSize="15" Content="Enter Car Information"/> 
<Label x:Name="lblMake" DockPanel.Dock ="Left" Content="Make"/> 
<Label x:Name="lblColor" DockPanel.Dock ="Right" Content="Color"/> 
<Label x:Name="lblPetName" DockPanel.Dock ="Bottom" Content="Pet Name"/> 
<Button x:Name="btnOK" Content="OK"/> 
</DockPanel> 





说 明 如 果 在 DockPanel 的 同一 侧 添加 了 多 个 元 素 ， 它 们 将 在 指定 的 边缘 按 声明 顺序 堆放 。 
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图 28-12 ”简单 的 DockPanel 


使 用 DockPanel 类 型 的 好 处 是 ,在 用 户 调整 窗口 大 小 时 ,每 个 元 素 仍然 能 连接 到 指定 的 面板 边缘 ( 通 
过 DockPanel.Dock )。 还 要 注意 <DockPanel> 开 始 标 签 中 将 LastChildFill 特 性 设置 为 trrue。 由 于 Button 
控件 是 容器 中 最 后 一 个 子 元 素 ， 因 此 它 将 在 剩余 的 空间 内 进行 拉 伸 。 


28.3.6 ”启用 Panel 类 型 的 滚动 功能 


值得 指出 的 是 ，WPF 包 含 ScrollVviewer 类 ， 为 面板 对 象 中 的 数据 提供 了 自动 滚动 行为 。 
ScrollViewer.xaml 文 件 的 定义 如 下 : 


<ScrollViewer> 
<StackPanel> 
<Button Content ="First" Background = "Green" Height ="40"/> 
<Button Content ="Second" Background = "Red" Height ="40"/> 
<Button Content ="Third" Background = "Pink" Height ="40"/> 
<Button Content ="Fourth" Background = "Yellow" Height ="40"/> 
<Button Content ="Fifth" Background = "Blue" Height ="40"/> 
</StackPanel> 
</ScrollViewer> 


上 面 的 XAML 定 义 的 结果 如 图 28-13 所 示 。 











r - 
Fun with Panels! 








图 28-13 ”使 用 ScrollViewer 类 型 


正如 你 期 望 的 ,每 个 面板 都 提供 了 多 个 成 员 ， 用 于 微调 内 容 的 位 置 。 很 多 WPF 控 件 都 支持 两 个 属 
性 ( Padding 和 Margin )， 面 板 可 以 根据 这 两 个 属性 来 放置 控件 。 具 体 来 说 ，Padding 属 性 控制 控件 边界 
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与 控件 内 容 之 间 的 空间 ，Margin 控 制 控件 边界 与 外 部 容器 边界 的 空间 。 
我 们 已 经 学 习 了 WPF 中 主要 的 面板 类 型 ， 以 及 它们 放置 内 容 的 不 同方 式 。 接 下 来 ,我 们 将 学 习 如 
何 使 用 Visual Studio 设 计 器 来 创建 布局 。 


28.3.7 ”使 用 Visual Studio 设 计 器 配置 Panel 


现在 我 们 已 经 学 习 了 如 何 用 XAML 定 义 常 见 的 布局 管理 器 ,你 将 很 高 兴 看 到 Visual Studio 为 构建 布 
局 提供 了 非常 好 的 设计 时 支持 。 其 关键 是 本 章 前 面 描述 的 Document Outline 窗 口 。 为 了 演示 一 些 基 本 
概念 ， 创 建 一 个 WPF Application 项 目 VisualLayoutTesterApp ( 该 示例 仅 用 来 演示 布局 编辑 器 ， 所 以 我 
没有 放 到 所 提供 的 源 代码 中 )。 

注意 ， 在 默认 情况 下 初始 的 Window 使 用 Grid 布局 ， 如 下 所 示 : 


<Window x:Class="VisualLayoutTesterApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="MainWindow" Height="350" Width="525"> 
<Grid> 


</Grid> 
</Window> 


如 图 28-14 所 示 ， 如 果 喜 欢 使 用 Grid 布局 系统 ， 可 以 用 可 视 布 局 简单 地 切割 和 调整 单元 格 的 大 小 。 
首先 在 Document Outline 窗 口中 选择 Grid 组 件 ， 然 后 点 击 网 格 边框 来 创建 新 行 或 新 列 。 





MainWindowxaml” 二 xX MainWindowxaml.cs % 4 : :i - 





下 





100% ~ 言 产 NE .ep ， 
图 28-14 ”使 用 IDE 的 设计 器 可 以 可 视 地 将 Grid 控件 切割 成 多 个 单元 格 
现在 假设 我 们 定义 了 一 个 包含 多 个 单元 格 的 网 格 。 我 们 可 以 将 控件 拖 放 到 布局 系统 的 某 个 单元 格 
中 ，IDE 会 自动 设置 控件 的 Grid.Row 和 Grid.Column 属 性 。 以 下 是 将 一 个 Button 拖 放 到 某 预定 义 的 单元 
格 后 IDE 自 动 生成 的 可 能 的 标记 : 





28.3 使 用 面板 控制 内 容 布 局 957 


<Button Content="Button" HorizontalAlignment="Left" Margin="10,10,0,0" 
Grid.Row="1" VerticalAlignment="Top" Width="75" 
Grid.Column="1"/> 


如 果 不 想 使 用 Grid, 可 以 在 Document Outline 窗 口中 右键 单 击 布局 节点 , 可 以 找到 允许 改变 当前 容 
器 的 菜单 选项 ( 如 图 28-15 所 示 )。 要 清楚 的 是 ， 你 将 (很 可 能 ) 从 根本 上 改变 控件 的 位 置 ， 因 为 控件 
要 符合 新 的 面板 类 型 的 规则 。 
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TOOLBOX SERVEREXPLORER DOCUMENT OUTUNE DATASOURCES 
图 28-15 ”Document Outline 窗 口 可 以 改变 面板 类 型 


另 一 个 好 用 的 功能 是 在 可 视 设 计 器 上 选择 一 组 控件 ， 并 将 它们 分 组 到 新 的 内 艇 的 布局 管理 器 中 。 
假设 我 们 有 一 个 定义 类 的 一 些 随 机 对 象 的 Canvas ( 如 果 你 想 尝试 , 可 以 用 图 28-15 所 示 的 技术 将 初始 的 
Grid 转换 为 Canvas )。 现 在 , 在 设计 器 中 选择 多 个 项 ( 按 住 CTRL 键 并 用 鼠标 左 键 单 击 各 个 项 )， 这 时 右 
键 单 击 选 中 的 项 ， 就 可 以 将 它们 分 组 到 新 的 子 面板 中 ( 如 图 28-16 所 示 )。 

然后 ， 再 次 观察 Document Outline 和 窗口 来 验证 符 套 的 布局 系统 。 在 构建 全 功能 的 WPF 窗 体 时 ， 你 
很 可 能 总 是 需要 使 用 拒 套 的 布局 系统 ， 而 不 是 简单 地 选择 为 所 有 UI 显 示 使 用 单个 面板 (事实 上 本 书 其 
他 WPF 示 例 都 是 如 此 )。 最 后 ， 要 知道 Document Outline 窗 口上 的 所 有 节点 都 是 可 拖 放 的 。 例 如 ， 如 果 
要 将 当前 Canvas 中 的 某 个 控件 移动 到 父 面 板 中 ， 就 可 以 像 如 图 28-17 所 示 这 么 做 。 

在 学 习 其 余 WPF 章 节 时 ,我 将 在 必要 的 时 候 指 出 其 他 的 布局 捷径 。 但 要 知道 的 是 ， 花 时 间 实 验 和 
测试 不 同 的 特性 是 绝对 值得 的 。 为 了 让 我 们 在 正确 的 方向 上 前 行 ， 本章 下 一 个 示例 将 演示 如 何 为 一 个 
自 定义 的 文本 处 理应 用 程序 ( 带 拼写 检查 ) 构建 通 套 的 布局 管理 器 。 
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MainWindowxaml” 过 X 




















Ikcanvas> 
<Button Content="Button” HorizontalAlignvent="Left” Vertica 
| <Calendar Canvas.Left="165" Canvas. Top="73"/> 
<Button Content="Button” Canvas.teft="66" Can 












Move to [Canvas} 
Buttor [Button]j "Button" 








-DOCUMENT OUTUNE DATASOURCES 
图 28- 17 通过 Document Outline 窗 口 重新 放置 项 
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28.4 ”使 用 骨 套 面板 构建 窗口 框架 


如 前 所 述 ， 典 型 的 WPF 窗 口 不 会 只 使 用 一 个 面板 控件 ， 它 们 会 将 面板 嵌 套 使 用 来 得 到 所 需 的 布局 
系统 。 接 下 来 ， 新 建 一 个 WPF Application ， 取 名 为 MyWordPad。 

我 们 的 目标 是 建立 一 个 布局 ， 使 主 窗 口 包含 一 个 顶级 菜单 系统 ,菜单 系统 下 面 是 工具 条 ， 窗 口 下 
方 为 状态 条 。 状 态 条 将 包含 一 个 面板 ， 当 用 户 选 择 菜 单项 (或 工具 条 按钮 ) 时 ， 该 面板 将 显示 文字 提 
示 。 菜 单 系统 和 工具 条 将 提供 UI 触 发 器 来 关闭 应 用 程序 并 在 Expander 部 件 中 显示 拼写 建议 。 图 28-18 
显示 了 初始 的 布局 ， 和 对 XAML 的 拼写 建议 。 









XAML is a very useful way to define 
the look and feel of a WPE app. 
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图 28-18 ”使 用 肉 套 面板 建立 窗口 界面 


注意 ， 两 个 工具 条 按钮 不 支持 图 片 ， 而 是 使 用 简单 的 文本 值 。 这 对 一 个 产品 级 别 的 应 用 程序 来 说 
是 不 够 的 ， 但 是 为 工具 条 按钮 指定 图 像 ， 通 常 需要 使 用 嵌 套 资源 ， 这 将 在 第 30 章 中 进行 介绍 ( 因此 ， 
这 里 我 们 使 用 文本 )。 同 时 还 要 注意 ， 当 鼠标 放 到 Check 按 钮 上 时 ， 和 鼠标 光标 将 发 生 改变 ， 状 态 条 的 面 
板 上 将 显示 有 用 的 UI 消息 。 

要 构建 这 样 的 UI， 先 更 新 初始 的 Window 类 型 的 XAML 定 义 , 使 其 使 用 cDockPanel> 子 元 素 ， 而 不 是 
默认 的 <Grid>， 如 下 所 示 : 


<Window x:Class="MyWordPad.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xam]l" 
Title="MySpellChecker" Height="331" Width="508" 
WindowStartupLocation ="CenterScreen"> 


《1-- 在 该 面板 中 建立 窗口 的 内 容 --> 
<DockPanel> 
</DockPanel> 


</Window> 
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28.4.1 构建 菜单 系统 


WPF 中 的 菜单 系统 由 包含 MenuItem 对 象 集合 的 Menu 类 表示 。 在 XAML 中 构建 菜单 系统 时 ， 可 以 让 
每 个 MenuItem 处 理 不 同 的 事件 。 最 值得 注意 的 事件 是 Click， 它 在 用 户 选择 子 项 时 发 生 。 在 本 例 中 , 我 
们 先 构建 两 个 顶级 菜单 项 ( File 和 Tools, 稍 后 再 构建 Edit 菜 单 ), 它们 分 别 包 含 Exit 和 Spelling Hints 两 个 
子 项 。 

除了 为 这 两 个 子 项 处 理 Click 事 件 ， 你 还 需要 处 理 MouseEnter 和 MouseExit 事 件 ， 用 来 在 下 一 步 中 
设置 状态 条 文本 。 在 <DockPanel> 作 用 域 中 添加 如 下 标记 ( 可 以 使 用 Visual Studio 中 的 Properties 窗 口 来 
处 理 各 个 事件 ， 参 见 第 27 章 ): 


<!-- 让 菜单 系统 停靠 在 上 方 --> 
<Menu DockPanel.Dock ="Top" 
HorizontalAlignment="Left" Background="White" BorderBrush ="Black"> 
<MenuItem Header=" File"> 
<Separator/> 
<MenuItem Header ="_ Exit" MouseEnter ="MouseEnterExitArea" 
MouseLeave ="MouseLeaveArea" Click ="FileExit Click"/> 
</MenuItem> 
<MenuItem Header=" Tools"> 
<MenuItem Header =" Spelling Hints" 
MouseEnter ="MouseEnterToolsHintsArea" 
MouseLeave ="MouseLeaveArea" Click ="ToolsSpellingHints Click"/> 
</MenuItem> 
</Menu> 


注意 ， 我 们 将 菜单 系统 停靠 在 DockPanel 的 上 方 ， 还 使 用 了 <Separator> 元 素 在 菜单 系统 中 的 Exit 
选项 前 面 插入 一 条 水 平 的 细 线 。 同 时 还 要 注意 ， 每 个 MenuItem 的 Header 值 都 戏 人 了 一 个 下 划 线 标记 
( 如 _Exit )。 当 用 户 按 下 Alt 键 〈 快 捷 键 ) 时 ， 该 标记 后 面 的 字母 将 带 有 下 划 线 。 

现在 我 们 已 经 实现 了 完整 的 菜单 系统 定义 ， 接 下 来 需要 实现 不 同 的 事件 处 理 程序 。 首 先 实 现 
了 File 一 Exit 处 理 程序 FileExit_Click()， 它 将 关闭 窗口 ， 由 于 该 窗口 为 顶级 窗口 ， 因 此 也 将 终止 应 用 
程序 。 每 个 子 项 的 MouseEnter 和 MouseExit 事 件 处 理 程序 最 终 都 将 更 新 状态 条 , 但 此 时 我 们 都 先 只 提供 
方法 外 过 。 最 后 是 Tools 一 Spelling Hints 菜 单项 的 ToolsSpellingHints_Click() 处 理 程序 , 我 们 也 先 保留 
外 壳 。 到 目前 为 止 ， 代 码 隐藏 文件 中 的 代码 如 下 : 

public partial class MainWindow : System.Windows .Window 


public MainWindow() 


InitializeComponent(); 

protected void FileExit Click(object sender, RoutedEventArgs args) 
// 关闭 该 窗口 
this.Close(); 


protected void ToolsSpellingHints Click(object sender, RoutedEventArgs args) 
{ 


protected void MouseEnterExitArea(object sender, RoutedEventArgs args) 
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protected void MouseEnterToolsHintsArea(object sender，RoutedEventArgs args) 


i void MouseLeaveArea(object sender, RoutedEventArgs args) 
} 
} 
可 视 地 构建 菜单 
尽管 了 解 如 何在 XAML 中 手动 定义 项 总 是 十 分 有 用 的 , 但 这 毕竟 有 些 繁琐 。Visual Studio 为 菜单 系 
统 、 工 具 条 、 状 态 条 和 很 多 其 他 UI 控件 提供 了 可 视 设 计 支 持 。 举 个 例子 ,假设 在 一 个 新 Window 上 有 一 
个 Menu 控 件 (通过 Project 一 Add Window 菜 单项 插入 一 个 测试 窗 体 )。 现 在 ， 右 键 单 击 Menu 控 件 ， 会 发 
现 一 个 Add Menultem 选 项 ( 如 图 28-19 所 示 )。 





TestWindowxaml” + X Main 
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上 S | 三 | 
| Reset Layout | | 
{| Group into 多 | 司 
| Ungroup | 
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Edit Template 0 
i00% ~ [到 | 里 昭 [ 太 |] 中 ， nd 








xmlns="http://schemas.microsoft.com/winfx/26806/xaml/presentation” . 
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图 28-19 ”为 Menu 对 象 可 视 地 添加 项 
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添加 完 顶 级 元 素 之 后 ， 可 以 再 添加 子 菜单 项 、 分 割 右 、 展 开 或 折 芋 菜单 ， 或 再 次 右键 单 击 执行 
他 与 菜单 有 关 的 操作 。 图 28-20 展 示 了 一 个 简单 菜单 系统 的 可 视 化 设计 〈 请 查看 生成 的 XAML )。 


TestWindowxam  X MainWindowxaml 0 
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</Menultem> Edit Additional Templates 
| </Menultem> 
- </Menu> * 
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图 28-20 ”为 MenuItem 对 象 可 视 地 添加 项 


在 介绍 完 当 前 MyWordPad 示 例 的 其 余部 分 时 ,我 将 展示 最 终生 成 的 XAML。 在 此 之 前 ， 花 点 时 间 
体验 一 下 用 可 视 设 计 器 来 简化 任务 的 过 程 吧 。 


28.4.2 ”构建 工具 条 


工具 条 ( 由 WPF 中 的 ToolBar 类 表示 ) 通常 提供 了 另 一 种 激活 菜单 项 的 方式 。 在 定义 完 cMenu> 后 ， 
直接 添加 如 下 的 标记 : 


<!-- 在 菜单 下 面 放置 工具 条 --> 
<ToolBar DockPanel.Dock ="Top” > 
<Button Content ="Exit" MouseEnter ="MouseEnterExitArea" 
MouseLeave ="MouseLeaveArea" Click ="FileExit Click"/> 
<Separator/> 
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<Button Content ="Check" MouseEnter ="MouseEnterToolsHintsArea" 
MouseLeave ="MouseLeaveArea" Click ="ToolsSpellingHints Click" 
Cursor="Help" /> 
</ToolBar> 


我 们 的 ToolBar 控 件 包 含 两 个 Button 控 件 , 它们 与 前 面 的 菜单 处 理 相 同 的 事件 , 并 且 由 代码 文件 中 
相同 的 方法 进行 处 理 。 这 样 处 理 程序 就 可 以 同时 为 菜单 项 和 工具 条 按钮 服务 。 尽 管 这 个 工具 条 只 使 用 
了 上 典型 的 控制 按钮 ， 但 你 应 该 明白 ToolBar 类 型 “是 一 个 ”ContentControl， 因 此 可 以 在 其 表面 上 散人 入 
任何 类 型 ( 如 下 拉 框 、 图 像 和 图 形 )。 除 此 之 外 ， 唯 一 有 趣 的 地 方 是 Check 按 钮 通过 Cursor 属 性 自 定义 
了 鼠标 光标 。 


说 明 ”你 可 以 将 ToolBar 元 素 包 里 到 <ToolBarTray2 元 素 内 ,<ToolBarTray> 元 素 控制 一 组 To01Bar 对 象 的 
布局 、 停 靠 和 抑 奥 操作 。 详 细 信 息 请 参考 .NET Framework 4.5 SDK 文 档 。 


28.4.3 ”构建 状态 条 


<DockPanel> 下 方 将 放置 一 个 statusBar 控 件 , 它 包含 一 个 本 章 前 面 没 有 介绍 过 的 cTextBlock> 控 件 。 
TextBlock 可 用 来 保存 支持 各 种 文字 批注 的 文本 ， 如 加 粗 文本 、 下 划 线 文本 、 换 行 符 等 。 直 接 在 前 面 
ToolBar 定 义 的 后 面 添 加 如 下 标记 : 


<1-- 在 底部 放置 一 个 状态 条 --> 
<StatusBar DockPanel.Dock ="Bottom" Background="Beige"” > 
<StatusBarItem> 
<TextBlock Name="statBarText" Text="Ready"/> 
</StatusBarItem> 
</StatusBar> 


28.4.4 ”完成 UI 设计 


UI 设计 的 最 后 一 步 是 定义 一 个 可 拆 分 为 两 列 的 Grid。 在 其 左 半边 放置 一 个 cstackPanel>， 它 包含 
一 个 Expander 控 件 ， 显 示 拼 写 提示 列表 。 在 其 右 半 边 放 置 一 个 TextBox 控 件 ， 支 持 多 行 和 滚动 条 ， 并且 
启用 拼写 检查 。 我 们 将 整个 <Grid> 停 靠 在 父 元 素 <DockPanel> 的 左边 。 在 描述 StatusBar 的 标记 后 面 直接 
添加 如 下 的 XAML 标 记 ， 并 完成 整个 窗口 UI 的 设计 : 


<Grid DockPanel.Dock ="Left" Background ="AliceBlue"> 
<1-- 定义 行 和 列 --> 
<Grid.ColumnDefinitions> 
<ColumnDefinition /> 
<ColumnDefinition /> 
</Grid.ColumnDefinitions> 


<GridSplitter Grid.Column ="0" Width ="5" Background ="Gray" /> 
<StackPanel Grid.Column="0" VerticalAlignment ="Stretch" > 
<Label Name="lblSpellingInstructions" FontSize="14" Margin="10,10,0,0"> 
Spelling Hints 
</Label> 


<Expander Name="expanderSpelling" Header ="Try these!" 
Margin="10,10,10,10"> 
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《1-- 将 以 编程 方式 填充 --> 
<Label Name ="lblSpellingHints" FontSize ="12"/> 
</Expander> 
</StackPanel> 


《1-- 输入 文字 的 区 域 --> 

<TextBox Grid.Column ="1" 
SpellCheck.IsEnabled ="True" 
AcceptsReturn ="True" 
Name ="txtData" FontSize ="14 
BorderBrush ="Blue" 
VerticalScrollBarVisibility="Auto" 
HorizontalScrollBarVisibility="Auto"> 

</TextBox> 

</Grid> 


28.4.5 ”实现 MouseEnter/MouseLeave 事 件 处 理 程序 


此 时 我 们 完成 了 窗口 的 UI， 剩 下 的 任务 就 是 实现 遗留 的 事件 处 理 程 序 。 我 们 先 更 新 C# 代 码 文件 ， 
使 所 有 MouseEnter 和 MouseLeave 处 理 程 序 都 在 状态 条 的 文本 窗 格 中 显示 恰当 的 消息 来 帮助 用 户 ， 如 下 
所 示 : 


public partial class MainWindow : System.Windows .Window 


”protected void MouseEnterExitArea(object sender, RoutedEventArgs args) 
statBarText.Text = "Exit the Application"; 
protected void MouseEnterToolsHintsArea(object sender, RoutedEventArgs args) 
statBarText.Text = "Show Spelling Suggestions"; 
protected void MouseLeaveArea(object sender, RoutedEventArgs args) 


statBarText.Text = "Ready"; 


} 
此 时 运行 应 用 程序 ， 可 以 看 到 状态 条 的 文本 会 根据 鼠标 悬 停 的 菜单 项 /工具 条 按钮 而 改变 。 


28.4.6 ”实现 拼写 检查 逻辑 


WPF API 发 布 时 内 置 了 对 于 拼写 检查 的 支持 ， 它 独立 于 微软 Office 产 品 。 这 意味 着 你 不 需要 通过 
COM 互 操作 层 来 使 用 Word 中 的 拼写 检查 器 ,而 只 要 简单 地 添加 几 行 代码 就 可 以 得 到 同样 类 型 的 支持 。 

你 也 许 还 记得 我 们 在 定义 <TextBox> 控 件 时 ， 将 SpellCheck.IsEnabled 属 性 设置 为 true。 这 样 ， 拼 
错 的 单词 将 用 红色 波浪 线 标注 ， 就 像 在 Office 里 那样 。 更 妙 的 是 ， 编 程 模 型 还 可 以 访问 拼写 检查 器 引 
擎 ， 为 拼 错 的 单词 提供 更 改建 议 。 将 下 面 的 代码 添加 到 ToolsSpellingHints_Click() 方 法 中 : 


protected void ToolsSpellingHints Click(object sender, RoutedEventArgs args) 
string spellingHints = string.Empty; 


// 获取 当前 位 置 的 拼写 错误 
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SpellingError error = txtData.GetSpellingError(txtData.CaretIndex); 
if (error != null) 


// 构建 更 改建 议 的 字符 事 


foreach (string s in error.Suggestions) 


spellingHints += string.Format("{0}\n", s); 


// 显示 建议 和 扩展 Expander 
lblSpellingHints.Content = spellingHints; 
expanderSpelling.IsExpanded = true; 
} 
} 


上 面 的 代码 非常 简单 。 我 们 使 用 caretIndex 属 性 得 到 文本 框 中 当前 光标 所 在 的 位 置 ， 提 取 
SpellingError 对 象 。 如 果 这 个 位 置 存在 错误 ( 即 值 不 为 nul1 )， 则 循环 suggestions 属 性 中 的 建议 列表 。 
得 到 错误 单词 的 所 有 更 改建 议 后 ， 将 其 连接 到 Expander 中 的 Label。 

这 样 就 可 以 了 。 只 需要 几 行 程序 代码 ( 和 少量 XAML )， 就 完成 了 文字 处 理 器 的 开端 。 如 果 理 解 
了 控件 命令 ， 就 可 以 再 添加 一 些 时 墅 的 特色 。 


28.5 ”WPF 命令 


WPF 通 过 命令 架构 提供 了 一 种 控件 无 关 的 事件 。 常见 的 .NET 事 件 定义 在 指定 的 基 类 中 , 并 且 只 能 
由 该 类 或 该 类 的 派生 类 使 用 。 因 此 ， 普 通 的 .NET 事 件 与 其 所 在 的 类 是 紧 紧 耦合 在 一 起 的 。 

相反 ，WPF 命 令 是 与 事件 类 似 的 实体 ,但 它们 与 具体 的 控件 无 关 ， 并 且 在 大 多 数 情况 下 可 应 用 于 
多 种 ( 并 且 看 上 去 没有 关联 的 ) 控件 类 型 。 例 如 ，WPF 支 持 Copy、Paste 和 Cnut 命 令 ， 可 应 用 于 各 种 各 
样 的 UI 元 素 ( 如 菜单 项 、 工 具 条 按钮 和 自 定义 按钮 ) 和 快捷 键 ( 如 Ctrl+C 组 合 键 和 Ctrl+V 组 合 键 )。 

尽管 其 他 UI 工具 ( 如 Windows Forms ) 也 为 上 述 功 能 提供 了 标准 事件 ， 但 却 常常 会 带 来 元 余 的 、 
难以 维护 的 代码 。 在 WPF 模 型 下 ， 我 们 可 以 使 用 命令 ， 通 常 最 终 将 得 到 简洁 灵活 的 代码 库 。 


28.5.1 内 置 的 命令 对 象 

WPF 发 布 了 一 些 内 置 的 控件 命令 ， 它 们 都 可 以 配置 相关 的 快捷 键 (或 其 他 输入 方式 )。 从 编程 角 
度 来 说 ，WPF 命 令 是 任意 支持 属性 (通常 以 Command 为 后 缀 ) 的 对 象 ， 能 够 返回 实现 了 ICommand 接 口 的 
对 象 ， 如 下 所 示 : 

public interface ICommand 


{ 
// 当 影 响 命令 能 否 执 行 的 变化 发 生 时 ， 触 发 该 事件 


event EventHandler CanExecuteChanged; 


// 返回 判断 当前 状态 下 命令 能 否 执 行 的 方法 
bool CanExecute(object parameter); 


// 定义 命令 触发 时 将 调用 的 方法 


void Execute(object parameter); 


WPF 提 供 了 各 种 命令 类 ( 大 约 100 个 可 用 的 命令 对 象 ), 这 些 类 定义 了 大 量 公开 特定 命令 对 象 的 属 
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性 ， 而 每 一 个 对 象 都 实现 了 ICommand。 表 28-3 列 出 了 一 些 可 用 的 标准 命令 对 象 〈 详细 内 容 可 参考 .NET 
Framework 4.5 SDK 文 档 )。 
表 28-3 ”内 置 的 WPF 控 件 命令 对 象 
WPF 类 命令 对 象 作 用 


ApplicationCommands Close、Copy、Cut、Delete、Find、0Open、Paste、Save、 ”应 用 程序 级 别 的 各 种 命令 
SaveAs、Redo、Undo 9 





ComponentCommands MoveDown 、 MoveFocusBack 、 MoveLeft 、 MoveRight 、 UI 组 件 常 用 的 各 种 命令 
ScrollToEnd、ScrollToHome 


MediaCommands BoostBase 、ChannelUp 、ChannelDown 、FastForward 、 ”多 媒体 相关 的 各 种 命令 
NextTrack 、Play、Rewind、Select、Stop 


NavigationCommands BrowseBack 、BrowseForward 、Favorites 、LastPage 、 WPF 导 航模 型 相关 的 各 种 命令 
NextPage 、Zoom 


EditingCommands AlighCenter, CorrectSpellingError、 DecreaseFontSize 、 WPF Documents API 相 关 的 各 种 
EnterLineBreak、EnterpParagraphBreak、MoveDownByLine、 命令 
MoveRightByWord 


28.5.2 ”将 命令 连接 到 Command 属 性 


将 WPF 命 令 属 性 连接 到 支持 Command 属 性 的 UI 元 素 ( 如 Button 或 MenuItem ) 是 非常 简单 的 。 更 新 当 
前 的 菜单 系统 ,使 其 支持 一 个 新 的 顶级 菜单 Edit 和 3 个 分 别 表示 复制 、 粘 贴 和 剪 切 文 本 数据 的 子 项 ， 如 
下 所 示 


<Menu DockPanel.Dock = "Top” 
HorizontalAlignment="Left" 
Background="White" BorderBrush ="Black"> 
<MenuItem Header=" File" Click ="FileExit Click" > 
<MenuItem Header =" Exit" MouseEnter ="MouseEnterExitArea" 
MouseLeave ="MouseLeaveArea" Click ="FileExit Click"/> 
</MenuItem> 


<1-- 使 用 命令 的 新 菜单 项 --> 

<MenuItem Header=" Edit"> 
<MenuItem Command ="ApplicationCommands.Copy"/> 
<MenuItem Command ="App1licationCommands .Cut"/> 
《MenuItem Command ="ApplicationCommands.Paste"/> 

</MenuItem> 


<MenuItem Header=" Tools"> 
<MenuItem Header =" Spelling Hints" 
MouseEnter ="MouseEnterToolsHintsArea" 
MouseLeave ="MouseLeaveArea" 
Click ="ToolsSpellingHints Click"/> 
</MenuItem> 
</Menu> 


注意 ，Edit 菜 单 的 每 个 子 项 都 为 Command 属 性 设置 了 值 。 这 意味 着 菜单 项 将 自动 接收 正确 的 名 称 和 快 
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捷 键 (如 Ctrl+X 为 剪 切 操作 )， 即 现在 应 用 程序 可 以 不 添加 任何 程序 代码 就 支持 复制 、 剪 切 和 粘贴 操作 。 
运行 应 用 程序 并 选择 一 段 文 本 ， 即 可 使 用 新 的 菜单 项 了 。 此 外 ,应 用 程序 还 可 以 响应 标准 的 右键 
操作 ， 为 用 户 呈 现 同样 的 选项 ( 如 图 28-21 所 示 )。 








"Exit Check 





. Nice! Basic clipboard support 
Spelling Hints out of the bow! 
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图 28-21 ”命令 对 象 内 能 了 大 量 的 功能 


28.5.3 将 命令 连接 到 任意 行为 


如 果 和 希望 将 命令 对 象 连接 到 任意 ( 应 用 程序 特定 的 ) 事件 ， 就 需要 编写 一 些 程序 代码 了 。 这 并 不 
复杂 ， 但 确实 包含 了 比 XAML 更 多 的 逻辑 。 例 如 ， 假 设 希望 整个 窗口 能 够 响应 F1 键 ， 当 用 户 按 下 F1 键 
时 ， 将 激活 相关 的 帮助 系统 。 同 样 ， 假 设 主 窗口 的 代码 文件 定义 了 新 的 方法 SetF1CommandBinding()， 
在 构造 函数 调用 完 InitializeComponent() 方 法 之 后 ， 会 调用 这 个 方法 : 


public MainWindow() 


InitializeComponent(); 
SetFiCommandBinding(); 
} 


这 个 新 方法 将 以 编程 方式 新 建 CommandBinding 对 象 ， 无 论 何 时 你 都 可 以 使 用 该 对 象 将 命令 对 象 绑 
定 到 应 用 程序 中 给 定 的 事件 处 理 程序 。 这 里 ， 我 们 配置 CommandBinding 对 象 ， 使 其 操作 Appli- 
cationCommands .Help 命 令 ， 该 命令 自动 响应 F1 键 : 
private void SetFiCommandBinding() 
CommandBinding helpBinding = new CommandBinding(ApplicationCommands.Help); 
helpBinding.CanExecute += CanHelpExecute; 


helpBinding.Executed += HelpExecuted; 
CommandBindings.Add(helpBinding); 


大 多 数 CommandBinding 对 象 都 需要 处 理 CanExecute 事 件 (指定 命令 是 否 会 响应 程序 操作 ) 和 
Executed 事 件 ( 编写 命令 响应 之 后 会 发 生 的 内 容 )。 在 Window 派 生 类 型 中 添加 如 下 的 事件 处 理 程序 ( 注 
意 每 个 方法 的 格式 与 相关 的 委托 所 要 求 的 格式 相同 ): 
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private void CanHelpExecute(object sender, CanExecuteRoutedEventArgs e) 


// 如 果 要 阻止 命令 执行 ， 可 以 将 CanExecute 设 置 为 false 
e.CanExecute = true; 


private void HelpExecuted(object sender, ExecutedRoutedEventArgs e) 


MessageBox.Show("Look, it is not that difficult. Just type something!", 
"Help!"); 
} 


在 上 面 的 代码 片段 中 ， 我 们 实现 了 CanHelpExecute()， 简 单 地 返回 true， 始 终 人 允许 启动 Fl 帮助 。 
但 如 果 某 些 情况 下 不 希望 显示 帮助 系统 ， 可 以 返回 false。HelpExecuted() 中 所 显示 的 “帮助 系统 ” 仅 
仅 是 一 个 消息 框 。 这 时 运行 应 用 程序 ， 当 按 下 键盘 上 的 F1 键 时 ， 可 以 看 到 ( 说 名 不 好 听 的 ， 是 什么 忙 
也 帮 不 上 的 ) 用 户 帮 助 系统 ( 如 图 28-22 所 示 )。 
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图 28-22” 自 定义 的 帮助 系统 ( 可 能 没什么 帮助 ) 


28.5.4 ”使 用 0pen 和 Save 命 令 


在 当前 示例 的 最 后 ,我们 将 添加 将 文本 数据 保存 为 外 部 文件 以 及 打开 *.txt 文 件 进行 编辑 的 功能 。 
如 果 想 绕 远 路 , 你 可 以 手工 添加 编程 逻辑 来 根据 TextBox 中 是 否 包含 数据 来 启用 或 禁用 新 菜单 项 。 但 实 
际 上 ， 我 们 还 是 可 以 使 用 命令 来 减轻 负担 。 

更 新 表示 顶级 File 菜 单 的 <MenuItem> 元 素 , 添加 两 个 新 的 使 用 Save 和 0pen ApplicationCommands 对 象 
的 子 菜单 : 


<MenuItem Header=" File"> 
<MenuItem Command ="ApplicationCommands.Open"/> 
<MenuItem Command ="ApplicationCommands.Save"/> 
<Separator/> 
<MenuItem Header =" Exit" 
MouseEnter ="MouseEnterExitArea" 
MouseLeave ="MouseLeaveArea" Click ="FileExit Click"/> 


</MenuItem> 
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回忆 一 下 ， 所 有 实现 ICommand 接 口 的 对 象 都 定义 了 两 个 事件 ( CanExecute 和 Executed )。 现 在 我 们 
需要 启用 整个 窗口 ， 来 验证 当前 是 否 能 够 触发 这 些 命令 。 如 果 能 ,就 可 以 定义 事件 处 理 程序 来 执行 自 
定义 代码 。 

要 实现 上 述 操作 ， 需 要 填充 窗口 中 维护 的 CommandBindings 集 合 。 在 XAML 中 ， 可 以 使 用 属性 元 
素 语法 来 定义 <Window.CommandBindings> 作 用 域 ， 并 在 其 中 放置 <CommandBinding> 定 义 。 将 <Window> 更 
新 如 下 : 


<Window x:Class="MyWordPad.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="MySpellChecker" Height="331" Width="508" 
WindowStartupLocation ="CenterScreen" > 


《1-- 在 测试 Open 和 Save 命 令 时 ， 通 知 Window 调 用 哪个 处 理 程序 --> 
<Window.CommandBindings> 
<CommandBinding Command="ApplicationCommands .Open" 
Executed="OpenCmdExecuted" 
CanExecute="OpenCmdCanExecute"/> 
<CommandBinding Command="ApplicationCommands .Save" 
Executed="SaveCmdExecuted" 
CanExecute="SaveCmdCanExecute"/> 
</Window.CommandBindings> 


《1-- 该 面板 建立 窗口 的 内 容 --> 
<DockPanel> 


</DockPanel> 
</Window> 


现在 , 在 XAML 编 辑 器 中 右 击 Executed 和 CanExecute 特 性 , 选择 Navigate to Event Handler 菜 单 选项 。 
我 们 在 第 27 章 中 介绍 过 , 这 样 可 以 为 事件 自动 生成 代码 存根 。 现在, 在 当前 窗口 的 C# 代 码 文件 中 包含 
4 个 空 的 处 理 程序 。 

CanExecute 事 件 处 理 程序 设置 了 传人 的 CanExecuteRoutedEventArgs 对 象 的 CanExecute 属 性 , 通知 窗 
口 可 以 随时 触发 相应 的 Executed 事 件 : 


private void OpenCmdCanExecute(object sender, CanExecuteRoutedEventArgs e) 


e.CanExecute = true; 


} 


private void SaveCmdCanExecute(object sender, CanExecuteRoutedEventArgs e) 


) e.CanExecute = true; 
相应 的 Executed 处 理 程序 执行 显 式 打开 和 保存 对 话 框 的 实际 工作 ,以 及 将 TextBox 中 的 数据 发 送 到 文 
件 中 。 要 确保 在 代码 文件 中 引入 了 System.IO 和 Microsoft.Win32 命 名 空间 。 完 整 的 代码 是 十 分 简单 的 : 


private void OpenCmdExecuted(object sender, ExecutedRoutedEventArgs e) 


{ 
// 创建 打开 文件 的 对 话 框 ， 并 且 只 显示 XAML 文 件 
OpenFileDialog openDlg = new OpenFileDialog(); 
openDlg.Filter = "Text Files |*.txt"; 


// 是 否 单 击 了 OK 按钮 
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if (true == openDlg.ShowDialog()) 


{ 
// 加 载 所 选 文件 的 所 有 文本 
string dataFromFile = File.ReadAllText(openDlg.FileName); 


// 在 TextBox 中 显示 字符 串 
txtData.Text = dataFromFile; 


} 
} 


private void SaveCmdExecuted(object sender, ExecutedRoutedEventArgs e) 


SaveFileDialog saveDlg = new SaveFileDialog(); 
saveDlg.Filter = "Text Files |*.txt"; 


// 是 否 单 击 了 OK 按 知 
if (true == saveDlg.ShowDialog()) 


// 将 TextBox 中 的 数据 保存 到 命名 的 文件 中 
File.WriteAllText(saveDlg.FileName, txtData.Text); 
} 
至 此 , 本 示例 以 及 对 于 WPF 控 件 的 初步 学 习 就 结束 了 。 我 们 学 习 了 如 何 使 用 基础 命令 、 菜 单 系统 、 
状态 条 、 工 具 条 、 艇 套 面 板 和 一 些 基础 的 UI 控 件 ， 如 TextBox 和 Expander。 在 接 下 来 的 示例 中 , 我们 将 
使 用 一 些 更 加 特殊 的 控件 ， 同 时 研究 几 个 重要 的 WPF 服 务 。 


源 代码 MyWordPad 项 目的 源 代码 位 于 Chapter 28 子 目录 下 。 








28.6 深入 了 解 WPF API 和 控件 


本 章 剩 余部 分 讲解 如 何 使 用 Visual Studio 创 建 盘 新 的 WPF。 我 们 的 目的 是 创建 由 包含 一 组 选项 卡 
的 TabControl 微 件 组 成 的 用 户 界面 。 每 一 个 标签 都 会 阐明 几 个 新 WPF 控 件 和 你 可 能 想 在 自己 的 软件 项 
目 中 使 用 的 API。 在 这 个 过 程 中 ， 你 还 能 学 到 Visual Studio WPF 设 计 器 的 其 他 功能 。 


使 用 TabControl 


首先 , 创建 一 个 新 的 WPF 应 用 程序 WpfControlsAndAPI。 如 前 所 示 ，, 初始 窗口 将 包含 一 个 含有 4 个 
不 同 选项 卡 的 TabControl， 每 个 选项 卡 都 包含 一 些 相关 的 控件 和 WPF API。 在 Visual Studio Toolbox 中 
找到 TabControl 控 件 。 拖 放 一 个 控件 到 设计 器 上 ， 使 其 占据 界面 的 大 部 分 区 域 。 将 这 个 UI 元 素 重 命名 
为 myTabSystem。 

这 时 你 应 该 注意 到 系统 自动 给 出 了 两 个 选项 卡 项 。 要 添加 其 他 选项 卡 ， 只 需要 右键 单 击 Document 
Outline 窗 口中 的 TabControl 节 点 ,选择 Add TabItem 菜 单 选项 ( 也 可 以 右键 单 击 设计 器 上 的 TabControl 激 
活该 菜单 选项 ) 。 两 种 方法 均 可 添加 更 多 选项 卡 (图 28-23 显 示 了 Document Outline 方 法 ) 。 

然后 ， 选 中 所 有 TabItem 控 件 ( 在 设计 器 上 或 者 通过 Document Outline 窗 口 ) ， 更 改 每 个 选项 卡 的 
Header 属 性 , 分 别 输入 为 Ink API、Documents、Data Binding 和 DataGrid。 此 时 , 窗口 设计 器 应 该 如 图 28-24 
所 示 。 
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现在 ,再 次 单 击 各 个 选项 卡 ， 使 用 Properties 窗 口 为 它们 取 一 个 唯一 的 、 恰 当 的 名 称 。 注 意 ， 不管 
使 用 哪 种 方法 选取 , 都 将 激活 该 选项 卡 , 并 且 可 以 通过 拖 忠 Toolbox 窗 口中 的 控件 来 设计 该 选项 卡 。 在 
设计 之 前 ， 先 单 击 XAML 按 钮 查看 IDE 生 成 的 XAML， 标记 将 与 下 面 的 类 似 (标记 将 根据 设置 的 属性 
的 不 同 而 有 所 区 别 ): 
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<TabControl x:Name="myTabSystem" HorizontalAlignment="Left" Height="280" 
Margin="10,10,0,0" VerticalAlignment="Top" Width="489"> 
<TabItem Header="Ink API"> 
<Grid Background="#FFESESES"/> 
</TabItem> 
<TabItem Header="Documents"> 
<Grid Background="#FFESESES5"/> 
</TabItem> 
<TabItem Header="Data Binding" HorizontalAlignment="Left" Height="20" 
VerticalAlignment="Top" Width="95" Margin="-2,-2,-36,0"> 
<Grid Background="#FFESESES"/> 
</TabItem> 
<TabItem Header="DataGrid" HorizontalAlignment="Left" Height="20" 
VerticalAlignment="Top" Width="74" Margin="-2,-2,-15,0"> 
<Grid Background="#FFE5E5E5"/> 
</TabItem> 
</TabControl> 


现在 我 们 有 了 核心 TabControl, 我 们 可 以 逐个 选项 卡 来 解决 细节 问题 , 同时 学 习 WPF API 的 更 多 特性 。 


28.7 ”构建 Ink API 选项 卡 


第 一 个 选项 卡 显示 WPF 的 数字 墨水 API， 它 可 以 轻松 地 在 程序 中 加 入 绘图 功能 。 当 然 ， 应 用 程序 
没有 必要 一 定 是 绘图 程序 ， 该 API 可 用 于 各 种 各 样 的 需求 ， 如 捕获 平板 电脑 手写 笔 的 输入 。 

首先 在 Document Outline 区 域 中 找到 代表 Ink API 选 项 卡 的 节点 并 展开 它 。 可 以 看 到 该 TabItem 默 认 
的 布局 管理 器 为 <Grid>。 右 击 该 布局 管理 器 ， 将 其 改 为 StackPanel ( 如 图 28-25 所 示 )。 
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图 28-25 ”更 改 第 一 卡 选项 卡 项 的 布局 管理 器 
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28.7.1 设计 工具 条 


在 Document Outline 编 辑 器 中 选中 StackPanel 节 点 ,并 插入 一 个 新 的 Too1Bar 控 件 inkToolbar。 然后 
选中 inkToolbar 节 点 , 将 Toolbar 控 件 的 Height 设 置 为 60 ( 使 用 默认 Width 值 即 可 )。 找到 Properties 窗 口 的 
Common 部 分 ， 单 击 Items (Collection) 属 性 的 椭圆 形 按 钮 ( 如 图 28-26 所 示 )。 
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图 28-26 ”使 用 items 编 辑 器 填充 ToolBar 


单 击 该 按钮 后 , 弹出 一 个 对 话 框 ,允许 我 们 选择 希望 添加 到 ToolBar 中 的 控件 。 单 击 对话 框 底部 中 
央 的 下 拉 列 表 框 ,添加 3 个 RadioButton 控 件 。 可 以 使 用 该 对 话 框 内 咀 的 Properties 编 辑 器 ， 将 每 个 
RadioButton 的 Height 设 置 为 50，Width 设 置 为 100 ( 这 些 属 性 同样 位 于 Layout 区 域 )。 同 样 ， 将 每 个 
RadioButton 的 Content 属 性 ( 位 于 Common 区 域 ) 设置 为 Ink Mode! 、Erase Mode! 和 Select Mode! (如 
图 28-27 所 示 )。 

添加 完 3 个 RadioButton 控 件 后 ,再 使 用 Items 编 辑 器 下 拉 列 表 添 加 一 个 Separator 控 件 。 最 后 , 需要 
添加 一 个 ComboBox ( 不 是 ComboBoxItem ) 控件 。 在 使 用 Items 对 话 框 插入 非 标准 控件 时 ， 从 下 拉 列 表 中 
选择 <Other Type...> 选 项 。 这 将 打开 Select Object 编 辑 器 ， 可 以 输入 所 需 控 件 的 名 称 。 确 保 勾 选 了 所 有 
程序 集 选 项 ， 然 后 就 可 以 搜索 你 感 兴趣 的 控件 了 如 图 28-28 所 示 )。 

将 ComboBox 的 Width 属 性 设置 为 100, 并 在 属性 编辑 器 的 Common 部 分 ( 再 次 ) 使 用 Items (Collection) 
属性 向 comboBox 控 件 中 添加 3 个 ComboBoxItem 对 象 。 将 各 个 ComboBoxItem 的 Content 属 性 分 别 设置 为 Red、 
Green 和 Blue。 
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图 28-27 设置 各 个 RadioButton 


完成 之 后 ， 关 闭 编辑 器 ， 回 到 窗口 设计 器 。 本 节 的 最 后 一 个 任务 是 使 用 Name 属 性 为 各 个 项 指定 变 
量 名 。 将 3 个 RadioButton 控 件 分 别 命名 为 inkRadio 、selectRadio 和 eraseRadio。 同 样 ， 将 ComboBox 控 件 
命名 为 comboColors。 第 一 个 控件 TabItem 的 XAML 看 起 来 如 下 所 示 : 


<TabItem Header="Ink API"> 
<StackPanel Background="#FFESESES"> 
<ToolBar x:Name="inkToolbar" HorizontalAlignment="Left" Width="479" Height="60"> 
<RadioButton x:Name="inkRadio" Content="Ink Mode!" Height="50" Width="100"/> 
<RadioButton x:Name="selectRadio" Content="Erase Mode!" Height="50" Width="100"/> 
<RadioButton x:Name="eraseRadio" Content="Select Mode!" Height="50" Width="100"/> 
<Separator/> 
<ComboBox x:Name="comboColors" Width="100"> 
<ComboBoxItem Content="Red"/> 
<ComboBoxItem Content="Green"/> 
<ComboBoxItem Content="Blue"/> 
</ComboBox> 
</ToolBar> 
</StackPanel> 
</TabItem> 


说 明 ”由 于 我 们 是 使 用 [DE 构建 工具 条 的 ， 你 可 能 会 认为 如 果 简 单 地 手工 编辑 XAML， 将 会 更 快 地 完 
成 任务 。 如 果 你 对 直接 输入 标记 非常 熟练 ， 你 当然 可 以 直接 输入 。 不 过 强烈 建议 你 花 点 儿 时 间 
多 多 练习 Visual Studio WPF Properties 编 辑 器 。 用 久 了 你 会 发 现 , 这 个 编辑 器 中 有 大 量 高 级 特性 。 
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图 28-28 使 用 Select Object 编辑 器 


28.7.2 ”RadioButton 控 件 


本 例 中 的 3 个 RadioButton 是 互 斥 的 。 在 其 他 GUI 框架 中 ， 要 想 让 一 组 相关 控件 (如 单 选 按钮 ) 互 
斥 ， 需 要 将 它们 放 在 同一 个 组 合 框 中 。 在 WPF 中 不 必 这 么 做 。 你 可 以 简单 地 将 它们 设置 为 同样 的 分 组 
名 称 。 这 样 相 关 的 项 就 没有 必要 放置 在 相同 的 物理 区 域 ， 而 是 可 以 放 在 窗口 的 任何 位 置 。 

在 设计 器 中 选中 各 个 RadioButton ( 按 住 Shift 键 单 击 )， 将 GroupName 属 性 ( 位 于 Properties 窗 口 的 
Common Properties 区 域 ) 设置 为 InkMode。 

如 果 RadioButton 控 件 没有 放置 在 父 面板 控件 中 ， 将 和 Button 控 件 呈 现 为 相同 的 UI。 但 与 Button 不 
同 的 是 ，RadioButton 类 包含 TsChecked 属 性 ， 用 户 单 击 这 个 UI 元 素 时 ， 该 属性 将 在 true 和 false 之 间 切 
换 。 此 外 ，RadioButton 还 提供 了 两 个 事件 ( Checked 和 Unchecked )， 可 以 拦截 这 种 状态 变化 。 

如 果 想 使 RadioButton 控 件 的 外 观 与 常见 的 单 选 按钮 有 所 不 同 , 可 以 按 住 Shif 键 单 击 各 个 控件 ， 然 
后 用 右键 单 击 ， 选 择 Group Into 一 Border 菜 单 选项 ( 如 图 28-29 所 示 )。 
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图 28-29 ”在 Border 控 件 中 进行 分 组 
这 时 , 按 下 F5 键 测试 程序 。 你 将 看 到 3 个 互 斥 的 单 选 按钮 和 包含 3 个 选项 的 组 合 框 ( 如 图 28-30 所 示 )。 
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图 28-30 ”完整 的 工具 条 系统 
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28.7.3 ”处 理 Ink API 选 项 卡 的 事件 


Ink API 选 项 卡 的 下 一 步 是 为 每 个 RadioButton 控 件 处 理 Click 事 件 。 与 本 书 中 的 其 他 WPF 项 目 类 似 ， 
选中 Visual Studio Properties 编 辑 器 中 包含 一 个 闪电 图 标的 按钮 即 可 输入 事件 处 理 程序 的 名 称 。 用 该 方 
法 将 所 有 单 选 按钮 的 Click 事 件 都 指向 同一 个 处 理 程序 RadioButtonClicked。 处 理 完 3 个 Click 事 件 ， 接 下 
来 处 理 ComboBox 的 SelectionChanged 事 件 ,将 处 理 程序 的 名 称 命 名 为 ColorChanged。 完 成 之 后 的 C# 代 码 
如 下 : 


public partial class MainWindow : Window 
public MainWindow() 
this.InitializeComponent(); 
// 在 此 插入 创建 对 象 所 需 的 代码 
private void RadioButtonClicked(object sender, System.Windows.RoutedEventArgs e) 


// T0D0: 在 此 添加 事件 处 理 程序 的 实现 


private void ColorChanged(object sender, 
System.Windows.Controls.SelectionChangedEventArgs e) 


; // T0D0: 在 此 添加 事件 处 理 程序 的 实现 
} 
稍 后 我 们 将 实现 这 些 处 理 程序 ， 现 在 先 保留 为 空 实现 。 
28.7.4 InkCanvas 控 件 


为 了 完成 该 选项 卡 的 UI， 我 们 需要 在 StackPanel 中 放置 一 个 InkCanvas ， 使 其 显示 在 刚刚 创建 的 
Toolbar 下 面 。 默 认 情况 下 ，Visual Studio Toolbox 不 会 显示 所 有 可 能 的 WPF 组 件 。 不 过 你 可 以 简单 地 输 
入 必要 的 XAML， 需 要 知道 的 是 ， 你 自己 可 以 更 新 显示 在 Toolbox 中 的 项 。 

我 们 来 看 一 下 如 何 操作 。 右 键 单 击 Toolbox 区 域 的 任意 位 置 ， 选 择 Choose Items... 菜 单 选项 。 稍 等 
片刻 ， 你 就 能 看 到 竺 添加 到 Toolbox 的 所 有 组 件 。 从 使 用 情况 看 ， 我 们 感 兴趣 的 是 添加 InkCanvas 控 件 
( 如 图 28-31 所 示 )。 

在 Document Onutline 编 辑 器 中 选中 tabInk 对 象 的 Stackpanel ， 添 加 一 个 InkCanvas ， 取 名 为 
myInkCanvas。 调 整 新 控件 大 小 ， 使 其 占据 选项 卡 的 大 部 分 区 域 。 你 还 可 以 使 用 Brushes 编 辑 器 为 
InkCanvas 设 置 背景 色 〈 下 一 章 将 详细 介绍 画 刷 编 辑 器 )。 然 后 按 F5 键 。 你 将 看 到 在 单 击 并 拖 电 鼠标 左 
键 的 时 候 ， 已 经 可 以 在 画布 上 绘制 数据 了 (如 图 28-32 所 示 )。 

InkCanvas 不 仅 能 绘制 鼠标 (或 手写 笔 ) 笔画 ， 还 支持 大 量 由 EditingMode 属 性 控制 的 编辑 模式 。 
该 属性 可 以 设置 为 InkCanvasEditingMode 枚 举 的 任何 值 。 本 例 使 用 Ink 模 式 ， 这 也 是 默认 的 选项 。 
Select 模 式 允 许 用 户 用 鼠标 选择 一 个 区 域 进 行 移动 或 调整 大 小 。 而 EraseByStroke 将 删除 之 前 的 鼠标 
笔画 。 
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图 28-32 ”InkCanvas 实 战 演练 








说 明 笔画 是 一 次 和 鼠标 按 下 / 抬 起 操作 时 呈现 的 内 容 。InkCanvas 将 所 有 笔画 存储 在 一 个 Stroke- 
Collection 对 象 中 ， 该 对 象 可 使 用 Strokes 属 性 访问 。 





用 下 面 的 逻辑 更 新 RadioButtonClicked() 处 理 程序 ， 该 程序 将 根据 所 选 的 RadioButton 为 InkCanvas 
设置 正确 的 模式 : 


private void RadioButtonClicked(object sender, 
System.Windows .RoutedEventArgs e) 


// 根据 传 入 的 按钮 ， 设 置 InkCanvas 的 操作 模式 
switch((sender as RadioButton).Content.ToString()) 
{ 
// 这 些 字 符 串 必须 与 各 个 RadioButton 的 Content 值 相同 
case "Ink Mode!": 


28.7 


this.myInkCanvas.EditingMode = InkCanvasEditingMode.Ink; 


break; 


case "Erase Model ": 


构建 Ink API 选项 卡 


this.myInkCanvas.EditingMode = InkCanvasEditingMode.EraseByStroke; 


break; 


case "Select Mode!": 


this.myInkCanvas.EditingMode = InkCanvasEditingMode.Select; 


break; 


l 
} 


此 外 , 在 窗口 的 构造 函数 中 设置 默认 模式 为 Ink， 并 且 设 置 ComboBox 的 默认 选项 (下 一 节 将 详细 介 


绍 该 控件 ): 


public MainWindow() 
{ 


this.InitializeComponent(); 


// 默认 模式 为 Ink 


this.myInkCanvas.EditingMode = InkCanvasEditingMode.Ink; 


this.inkRadio.IsChecked = true; 
this .comboColors.SelectedIndex=0; 


} 


再 次 按 下 F5 键 运行 程序 。 使 用 Ink 模 式 绘 制 一 些 数据 ,然后 使 用 Erase 模 式 移 除 前 面 输入 的 鼠标 笔 
画 ( 鼠标 图 标 自 动 变 为 橡皮 ),。 最 后 , 使 用 Select 模 式 , 将 鼠标 以 套 索 的 方式 选中 一 些 笔画 。 圈 中 某 项 
图 28-33 显 示 了 正在 起 作用 的 编辑 模式 。 


后 ， 可 以 在 画布 中 移动 或 调整 其 大 小 。 
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图 28-33 ”InkCanvas 编 辑 模式 实战 演练 
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28.7.5 ”ComboBox 控 件 


有 3 种 方法 确定 ComboBox 控 件 ( 或 ListBox 控 件 ) 所 选中 的 项 。SelectedIndex 属 性 可 以 得 到 被 选项 
的 数字 索引 ( 从 0 开始，-1 表 示 没 有 选中 项 )。SelectedItem 属 性 可 以 得 到 选中 列表 中 的 对 和 象 。 
SelectedValue 可 以 得 到 被 选 对 象 的 值 ( 通常 要 调用 ToString() 方 法 )。 

该 选项 卡 还 需要 添加 最 后 一 些 代码 来 改变 在 InkCanvas 中 输入 的 笔画 颜色 。InkCanvas 的 
DefaultDrawingAttributes 属 性 返回 DrawingAttributes 对 象 ， 可 以 用 来 配置 各 种 笔尖 ， 如 大 小 、 颜 色 
(以 及 其 他 设置 )。 用 下 面 的 实现 更 新 ColorChanged() 方 法 : 


private void ColorChanged(object sender, 
System.Windows.Controls.SelectionChangedEventArgs e) 


// 获取 组 合 框 中 选中 的 值 
string colorToUse = 
(this.comboColors.SelectedItem as ComboBoxItem).Content.ToString(); 


// 更 改 笔 画 呈 现 的 颜色 
this.myInkCanvas.DefaultDrawingAttributes.Color = 
(Color)ColorConverter.ConvertFromString(colorToUse); 
} 


ComboBox 包 含 ComboBoxItems 的 集合 ， 生 成 的 XAML 的 定义 如 下 : 


<ComboBox x:Name="comboColors" Width="100" SelectionChanged="ColorChanged"> 
<ComboBoxItem Content="Red"/> 
<ComboBoxItem Content="Green"/> 
<ComboBoxItem Content="Blue"/> 

</ComboBox> 


在 调用 SelectedItem 获 取 选 中 的 ComboBoxItem 时 ， 得 到 的 是 通用 的 0bject 。 将 0bject 转 换 为 
ComboBoxItem 后 , 才能 得 到 Content 的 值 , 分 别 为 字符 串 Red Green 、Blue。 然后 使 用 方便 的 ColorConverter 
工具 类 将 string 转 换 为 Color 对 象 。 再 次 运行 程序 ， 就 可 以 改变 所 呈现 图 像 的 颜色 了 。 

注意 ，ComboBox 和 ListBox 控 件 都 可 以 包含 复杂 内 容 ， 而 不 仅仅 限于 文本 数据 的 列表 。 要 对 这 一 点 
有 个 感性 认识 ， 可 以 打开 窗口 的 XAML 编辑 器 ， 更 改 ComboBox 的 定义 ， 使 其 包含 一 组 <StackPanel> 元 
素 ， 其 中 每 个 元 素 都 包含 一 个 <Ellipse> 和 一 个 <Label>( 注意 ComboBox 的 Width 为 200 ): 


<ComboBox x:Name="comboColors" Width="200" SelectionChanged="ColorChanged"> 
<StackPanel Orientation ="Horizontal" Tag="Red"> 
<Ellipse Fill ="Red" Height ="50" Width ="50"/> 
<Label FontSize ="20" HorizontalAlignment="Center" 
VerticalAlignment="Center" Content="Red"/> 
</StackPanel> 


<StackPanel Orientation ="Horizontal" Tag="Green"> 
<Ellipse Fill ="Green" Height ="50" Width ="50"/> 
<Label FontSize ="20" HorizontalAlignment="Center" 
VerticalAlignment="Center" Content="Green"/> 
</StackPanel> 


<StackPanel Orientation ="Horizontal”" Tag="Blue"> 
<Ellipse Fill ="Blue" Height ="50" Width ="50"/> 
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<Label FontSize ="20" HorizontalAlignment="Center" 
VerticalAlignment="Center" Content="Blue"/> 
<x/StackPanel> 
</ComboBox> 


注意 ,每 个 StackPanel 都 设置 了 Tag 属 性 的 值 ， 这 是 一 种 获取 用 户 选 中 面板 (还 有 更 好 的 方式 , 但 
现在 这 样 就 足够 了 ) 的 简单 、 快 捷 、 便 利 的 方式 。 这 样 调整 之 后 ， 需 要 更 改 ColorChanged() 方 法 的 实 
现 ， 如 下 : 


private void ColorChanged(object sender, 
System.Windows.Controls.SelectionChangedEventArgs e) 


// 获取 所 选中 的 StackPanel 的 Tag 
string colorToUse = (this.comboColors.SelectedItem 
as StackPanel).Tag.ToString(); 


Sn 
现在 再 次 运行 程序 ， 注 意 独特 的 组 合 框 (如 图 28-34 所 示 )。 
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图 28-34” 自 定义 组 合 框 ， 这 归功 于 WPF 内 容 模型 





28.7.6 保存、 加载 和 清除 InkCanvas 数 据 


这 个 选项 卡 的 最 后 一 部 分 是 对 画布 数据 进行 保存 、 加 载 和 清除 。 此 时 , 你 应 该 对 设计 UI 很 熟悉 了 ， 
因此 我 们 只 进行 简要 地 说 明 。 

在 代码 文件 中 引入 System.I0 和 System.Nindows.Ink 命 名 空间 。 在 ToolBar 中 添加 3 个 Button 控 件 ， 
分 别 命名 为 btnSave 、btnLoad、btnClear。 然后， 处 理 各 个 控件 的 click 事 件 ， 并 实现 处 理 程序 ， 如 下 : 


private void SaveData(object sender, System.Windows.RoutedEventArgs e) 


// 在 本 地 文件 中 保存 InkCanvas 的 所 有 数据 
using (FileStream fs = new FileStream("StrokeData.bin", FileMode.Create)) 


this.myInkCanvas.Strokes.Save(fs); 
fs.Close(); 
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} 


private void LoadData(object sender, System.Windows.RoutedEventArgs e) 


{ 
// 从 文件 中 获取 数据 ， 填 充 StrokeCollection 
using(FileStream fs = new FileStream("StrokeData.bin", 
FileMode .Open, FileAccess.Read)) 


StrokeCollection strokes = new StrokeCollection(fs); 
this.myInkCanvas.Strokes = strokes; 


} 


private void Clear(object sender, System.Windows.RoutedEventArgs e) 


// 清除 所 有 笔画 
this.myInkCanvas.Strokes.Clear(); 


现在 我 们 可 以 将 数据 保存 到 文件 中 ， 从 文件 中 加 载 数据 以 及 清除 InkCanvas 中 的 所 有 数据 。 现 在 我 
们 介绍 完了 TabControl 中 的 第 一 个 选项 卡 ， 并 且 学 习 了 WPF 数 字 墨 水 API。 当 然 ， 对 于 该 技术 ,还 有 内 
容 没 有 涉及 。 但 它 会 给 你 继续 深入 学 习 打 下 良好 的 基础 。 下 面 我 们 将 学 习 如 何 使 用 WPF Documents API。 


28.8 Documents API 


WPF 发 布 了 很 多 可 以 获取 或 显示 简单 文本 数据 的 控件 ， 如 Label 、TextBox 、TextBlock 和 
PasswordBox。 这 些 控 件 十 分 有 用 , 但 是 某 些 WPF 应 用 程序 要 使 用 复杂 的 、 高 度 格式 化 的 文本 数据 ,类 
似 Adobe PDF 文件 中 的 内 容 。WPF 的 Documents API 提 供 了 这 样 的 功能 ,但 它 使 用 的 文件 格式 是 XPS 而 
不 是 PDF。 

利用 Documents API 中 System.Windows.Documents 命 名 空间 下 的 一 些 类 , 可 以 构建 用 来 打印 的 文档 。 
该 命名 空间 包含 大 量 表示 富 XPS 文 档 的 类 型 , 如 List、 Paragraph、 Section、 Table、 LineBreak、Figure、 
Floater 和 Span。 


28.8.1 块 元 素 和 内 联 元 素 


在 形式 上 ， 添 加 到 XPS 文 档 中 的 项 属于 两 大 类 型 : 块 元 素 和 内 联 元 素 。 属 于 块 元 素 的 类 都 扩展 了 
System.Windows.Documents.Block 基 类 ， 例 如 List、pParagraph、BlockUIContainer 、Section 和 Table。 
这 些 类 可 以 将 其 他 内 容 组 合 在 一 起 〈 如 列表 包含 段落 数据 ， 而 段落 包含 不 同文 本 格式 的 子 段落 )。 

属于 内 联 元 素 的 类 都 扩展 了 System.Windows.Documents.Inline 基 类 。 可 以 将 内 联 元 素 机 人 另 一 个 块 
项 目 中 (或 通 入 到 块 元 素 中 的 内 联 元 素 中 )。 常见 的 内 联 元 素 有 Run、Span、LineBreak、Figure 和 Floater。 

使 用 专业 编辑 器 构建 富 文档 时 ， 你 可 能 会 经 常 遇 到 这 些 类 的 名 称 。 与 其 他 WPF 控 件 一 样 ， 你 可 以 
在 XAML 和 代码 中 配置 这 些 类 。 因 此 ， 你 可 以 声明 一 个 空 的 <Paragraph>， 并 在 运行 时 进行 填充 (下 例 
将 演示 如 何 这 么 做 )。 


28.8.2 ”文档 布局 管理 器 
你 可 能 认为 可 以 直接 在 Grid 这 样 的 面板 容器 中 放置 块 元 素 和 内 联 元 素 。 然 而 实际 上 ， 你 需要 将 它 
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们 包 庄 在 <FlowDocument> 元 素 或 <FixedDocument> 元 素 中 。 

如 果 和 希望 用 户 更改 数 据 显示 在 计算 机 屏幕 上 的 方式 ， 将 项 目 放 置 在 FlowDocument 中 是 很 理想 的 。 
这 样 用 户 可 以 缩放 文本 或 更 改 数据 的 显示 方式 ( 如 显示 为 长 页 面 ， 或 分 列 显示 )。 而 对 于 真正 用 于 打 
印 (所 见 即 所 得 ) 的 、 不 能 更 改 的 文档 数据 ， 则 最 好 使 用 FixedDocument。 

在 本 例 中 ， 我 们 只 关注 FlowDocument 容 器 。 向 FlowDocument 中 搬 人 内 联 项 目 或 块 项 目 时 ， 
FlowDocument 对 象 将 放置 于 4 个 XPS 布 局 管理 器 中 的 一 个 ， 如 表 28-4 所 示 。 


表 28-4 ”XPS 控件 布局 管理 器 





面板 控件 作 用 
FlowDocumentReader 显示 FlowDocument 中 的 数据 ， 并 支持 缩放 、 搜 索 和 不 同形 式 的 内 容 布局 
FlowDocumentScrollViewer 显示 FlowDocument 中 的 数据 ， 但 数据 表现 为 带 滚动 条 的 单一 文档 。 该 容器 不 支 

持 缩放 、 搜 索 或 其 他 布局 模式 
RichTextBox 显示 FlowDocument 中 的 数据 ， 并 支持 用 户 编辑 
FlowDocumentPageViewer 逐 页 显示 文档 ， 每 次 显示 一 页 。 数 据 可 以 被 缩放 ， 但 不 能 被 检索 


FlowDocumentReader 管 理 器 能 以 功能 最 丰富 的 方式 显示 FlowDocument。 这 时 ， 用 户 可 以 改变 布局 ， 
在 文档 中 搜索 单词 ， 以 及 对 提供 的 UI 中 的 数据 进行 缩放 。 该 容器 ( 以 及 FlowDocumentScrollViewer 和 
FlowDocumentPageViewer ) 的 一 个 局 限 是 ,所 显示 的 内 容 是 只 读 的 。 如 果 希 望 允 许 用 户 在 FlowDocument 
中 输入 新 的 信息 ， 可 以 将 其 包 庄 在 RichTextBox 控 件 里 。 
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单 击 TabItem 中 的 Documents 选 项 卡 , 使 用 设计 器 打开 该 控件 进行 编辑 。 现 在 TabItem 的 直接 子 元 素 
为 默认 的 <Grid> 控 件 ， 使 用 Document Outline 窗 口 将 其 修改 为 stackPanel。 该 选项 卡 将 显示 人 允许 用 户 对 
选中 文本 进行 突出 显示 的 FlowDocument ， 以 及 使 用 Sticky Notes API 添 加 批注 。 

按 如 下 方式 定义 ToolBar 控 件 ， 其 中 包含 3 个 简单 的 (未 命名 的 ) Button 控 件 。 稍 后 我 们 将 为 这 些 
控件 装备 一 些 新 的 命令 ， 因 此 现在 不 必 在 代码 中 引用 它们 ( 随意 直接 进 和 XAML， 如 果 喜 欢 也 可 以 使 
用 IDE )。 


<TabItem x:Name="tabDocuments" Header="Documents" VerticalAlignment="Bottom" 
Height="20"> 
<StackPanel> 
<ToolBar> 
<Button BorderBrush="Green" Content="Add Sticky Note"/> 
<Button BorderBrush="Green" Content="Delete Sticky Notes"/> 
<Button BorderBrush="Green" Content="Highlight Text"/> 
</ToolBar> 
</StackPanel> 
</TabItem> 


你 也 可 以 更 新 Visual Studio 的 Toolbox 添 加 一 个 FlowDocumentReader 控 件 ( 跟 添加 InkCanvas 使 用 的 
技术 相同 )， 或 使 用 XAML 编 辑 器 手动 更 新 当前 TabItem。 

不 管 使 用 哪 种 方法 ， 将 FlowDocumentReader 控 件 放置 在 StackPanel 中 ， 命 名 为 myDocumentReader， 
并 进行 拉 伸 使 其 占据 StackPanel 的 表面 。 为 这 个 新 组 件 添加 一 个 空 的 <FlowDocument>。 
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<FlowDocumentReader x:Name="myDocumentReader" Height="269.4"> 
<FlowDocument/> 
</FlowDocumentReader> 


此 时 ， 就 可 以 向 <FlowDocument> 元 素 中 添加 文档 类 了 ( 如 List、Paragraph、Section、Table、 
LineBreak 、Figure 、Floater 和 Span )。 下 面 是 设置 <FlowDocument> 的 一 种 方法 。 


<FlowDocumentReader x:Name="myDocumentReader" Height="269.4"> 
<FlowDocument> 
<Section Foreground = "Yellow" Background = "Black"> 
<Paragraph FontSize = "20"> 
Here are some fun facts about the WPF Documents API! 
</Paragraph> 
</Section> 
《List/> 
<Paragraph/> 
</FlowDocument> 
</FlowDocumentReader> 


现在 运行 程序 ( 按 F5 键 )， 你 已 经 可 以 缩放 文档 字体 (使 用 右 下 角 的 滑动 条 )、 搜 索 关键 字 ( 使 用 
左下 角 的 搜索 编辑 器 ) 并 以 三 种 方式 ( 使 用 布局 按钮 ) 显示 数据 。 

继续 学 习 之 前 ， 你 可 能 希望 编辑 XAML 以 使 用 除了 FlowDocumentReader 以 外 的 其 他 FlowDocument 
容器 ， 如 FlowDocumentScrollViewer 或 RichTextBox。 修 改 之 后 ， 再 次 运行 应 用 程序 ， 并 注意 处 理 文档 
数据 的 不 同 之 处 。 但 要 记得 最 后 要 改 回 FlowDocumentReader。 


28.9.1 使 用 代码 填充 FlowDocument 


现在 , 我 们 在 代码 中 构建 List 块 和 Paragraph 块 。 这 是 十 分 重要 的 , 因为 你 也 许 需要 基于 用 户 输入 、 
外 部 文件 、 数 据 库 信息 等 来 填充 FlowDocument。 首 先 用 XAML 编 辑 器 为 List 和 Paragraph 元 素 起 一 个 合 
适 的 名 字 ， 以 便 在 代码 中 进行 访问 : 

<List x:Name="listOfFunFacts"/> 

<Paragraph x:Name="paraBodyText"/> 


在 代码 文件 中 , 定义 一 个 新 的 私有 方法 PopulateDocument() 。 该 方法 先 在 List 中 添加 一 组 ListItem， 
每 个 ListItem 中 都 包含 拥有 单个 Run 的 Paragraph。 同 样 ， 该 辅助 方法 还 使 用 3 个 独立 的 Run 对 象 动态 构 
建 格式 化 的 段落 ， 如 下 所 示 : 


private void PopulateDocument() 
{ 
// 向 List 项 中 添加 一 些 数 据 
this.listOfFunFacts.FontSize = 14; 
this.1listOfFunFacts.MarkerStyle = TextMarkerStyle.Circle; 
this.listOfFunFacts.ListItems.Add(new ListItem( new 
Paragraph(new Run("Fixed documents are for WYSIWYG print ready docs!")))); 
this.1istOfFunFacts.ListItems.Add(new ListItem( 
new Paragraph(new Run("The API supports tables and embedded figures!")))); 
this.1istofFunFacts.ListItems.Add(new ListItem( 
new Paragraph(new Run("Flow documents are read only!")))); 
this.listOfFunFacts.ListItems.Add(new ListItem(new Paragraph(new Run 
("BlockUIContainer allows you to embed WPF controls in the document!") 


了 


// 向 Paragraph 中 添加 一 些 数据 


28.9 构建 Documents 选项 卡 985 


// 身子 的 第 一 部 分 


Run prefix = new Run("This paragraph was generated "); 


// 段落 的 中 间 部 分 

Bold b = new Bold(); 

Run infix = new Run("dynamically"); 
infix.Foreground = Brushes.Red; 
infix.FontSize = 30; 
b.Inlines.Add(infix); 


// 段落 的 最 后 部 分 
Run suffix = new Run(" at runtime!"); 


// 向 内 联 元 素 的 集合 中 添加 段落 的 各 个 部 分 
this.paraBodyText.Inlines.Add(prefix); 
this.paraBodyText.Inlines.Add(infix); 
this.paraBodyText.Inlines.Add(suffix); 


} 
在 窗口 的 构造 函数 中 调用 该 方法 ， 然 后 运行 程序 ， 可 以 看 到 新 的 动态 生成 的 文档 内 容 。 


28.9.2 ”启用 批注 和 便签 


到 目前 为 止 , 一 切 都 很 顺利 。 你 可 以 使 用 XAML 和 C# 代 码 构建 包含 数据 的 文档 。 但 我 们 仍然 需要 
Documents 选 项 卡 工 具 条 中 的 3 个 按钮 。WPF 发 布 了 一 系列 专门 用 于 Documents API 的 命令 ， 可 以 允许 
用 户 选 择 文档 内 容 或 添加 便签 批注 。 最 棒 的 是 ， 添 加 所 有 这 些 功能 只 需要 很 少 的 代码 ( 和 标记 )。 

用 于 Documents API 的 命令 对 象 位 于 PresentationFramework.dll 的 System.Windows .Annotations 命 名 
空间 下 。 因 此 ， 我们 需要 在 <Window> 的 开放 式 元 素 中 定义 自 定义 的 XML 命 名 空间 ， 才 能 在 XAML 中 使 
用 这 些 对 象 ( 前 级 为 a ): 

<Window 

“xmlns:a= 
"clr-namespace:System.Windows.Annotations;assembly=PresentationFramework" 
x:Class="WpfControlsAndAPIs .MainWindow" 
x:Name="Window" 

Title="MainWindow" 


Width="856" Height="383" mc:Ignorable="d" 
WindowStartupLocation="CenterScreen" > 


</Window> 
现在 更 新 3 个 <Button> 的 定义 ， 用 3 个 批注 命令 设置 其 Command 属 性 : 
<ToolBar> 


<Button BorderBrush="Green" Content="Add Sticky Note" 
Command="a:AnnotationService.CreateTextStickyNoteCommand"/> 
<Button BorderBrush="Green" Content="Delete Sticky Notes" 
Command="a:AnnotationService.DeleteStickyNotesCommand"/> 
<Button BorderBrush="Green" Content="Highlight Text" 
Command="a:AnnotationService.CreateHighlightCommand"/> 
</ToolBar> 


最 后 要 做 的 事情 是 启用 FlowDocumentReader 对 象 ( 即 myDocumentReader ) 的 批注 服务 。 在 类 中 添加 
一 个 私有 方法 EnableAnnotations()， 并 在 窗口 的 构造 函数 中 调用 它 。 现 在 引入 如 下 的 命名 空间 : 
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using System.Windows.Annotations; 
using System.Windows.Annotations.Storage; 


然后 实现 以 下 方法 : 
private void EnableAnnotations() 


// 创建 用 于 FlowDocumentReader 的 AnnotationService 对 象 
AnnotationService anoService = new AnnotationService(myDocumentReader); 


// 创建 用 于 存放 批注 的 MemoryStTeam 
MemoryStream anoStream = new MemoryStream(); 


// 根据 MemoryStream 创 建 基于 XML 的 存储 
// 可 以 使 用 这 个 对 象 以 编程 的 方式 添加 、 删 除 或 查找 批注 


AnnotationStore store = new XmlStreamStore(anoStream); 


// 启用 批注 服务 


anoService.Enable(store); 


AnnotationService 类 可 以 使 给 定 的 文档 布局 管理 器 支持 批注 。 在 调用 该 对 象 的 Enable() 方 法 之 前 ， 
需要 为 该 对 象 提供 一 个 保存 批注 数据 的 位 置 ， 本 例 使 用 由 MemoryStream 对 象 表示 的 一 块 内 存 区域 。 注 
意 ， 我 们 使 用 AnnotationSstore 将 AnnotationService 和 Stream 连 接 在 一 起 。 

现在 运行 应 用 程序 。 选 取 一 些 文本 ， 然 后 单 击 Add Sticky Note 按 钮 ， 并 输入 一 些 信 息 。 同 样 选 取 
一 些 文本 ， 还 可 以 突出 显示 数据 ( 颜色 默认 为 黄色 )。 最 后 ， 选 中 便签 ， 单 击 Delete Sticky Note 按 钮 ， 
可 以 进行 删除 ， 如 图 28-35 所 示 。 
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图 28-35 ”便签 


28.9.3 ”保存 和 加 载 流 文档 


在 Documents API 的 最 后 ,我 们 来 看 看 将 文档 保存 到 文件 以 及 从 文件 中 读 取 文档 是 多 么 简单 。 记 住 ， 
只 有 在 RichTextBox 中 显示 FlowDocument 对 象 时 ， 用 户 才能 编辑 文档 。 但 你 完全 可 以 在 运行 时 动态 创建 
部 分 文档 ， 因 此 可 能 希望 将 其 保存 以 便 之 后 使 用 。 加 载 XPS 文 档 的 功能 在 很 多 WPF 应 用 程序 中 都 是 十 
分 有 用 的 ， 因 为 你 可 能 希望 在 运行 时 定义 空 文档 并 加 载 它 。 
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下 面 的 代码 片段 在 Documents 选 项 卡 的 工具 条 中 添加 了 两 个 Button， 如 下 注意， 没有 在 标记 中 
处 理 任何 事件 ): 


<Button x:Name="btnSaveDoc”HorizontalAlignment="Stretch” 
VerticalAlignment="Stretch”Width="75”Content="Save Doc"/> 

<Button x:Name="btnLoadDoc" HorizontalAlignment="Stretch" 
VerticalAlignment="Stretch" Width="75" Content="Load Doc"/> 


在 窗口 的 构造 函数 中 ,编写 如 下 的 Lambda 表 达 式 ， 来 保存 和 加 载 FElowDocument 数 据 ( 需要 引入 
System.Windows .Markup 命 名 空间 来 访问 XamlReader 和 XamlWriter 类 ): 
public MainWindow() 


”7// 为 保存 和 加 载 流 文档 装配 Click 事 件 处 理 程序 
btnSaveDoc.Click += (0o, 5s) => 


using(FileStream fStream = File.0pen( 
"documentData.xaml", FileMode.Create)) 


XamlWriter.Save(this.myDocumentReader.Document, fStream); 
}; 
btnLoadDoc.Click += (0o, s) => 
using(FileStream fStream = File.Open("documentData.xaml", FileMode.Open)) 
try 


FlowDocument doc = XamlReader.Load(fStream) as FlowDocument; 
this.myDocumentReader.Document = doc; 


catch(Exception ex) {MessageBox.Show(ex.Message, "Error Loading Doc!");} 
}; 

} 

这 就 是 保存 文档 时 我 们 要 做 的 全 部 工作 ( 注意 我 们 并 没有 保存 任何 批注 ， 你 可 以 使 用 批注 服务 完 
成 这 项 任务 )。 如 果 单 击 Save 按 钮 ， 将 在 \bin\Debug 文 件 夹 下 看 到 新 的 *.xaml 文 件 。 该 文件 包含 当前 的 
文档 数据 。 

至 此 对 于 WPF Documents API 的 介绍 就 告 一 段落 了 。 当 然 ， 对 此 我 们 还 有 很 多 方面 没有 涉及 ， 但 
你 应 该 已 经 了 解 了 大 量 的 基础 知识 。 在 本 章 最 后 ， 我 们 将 学 习 一 些 关于 数据 绑 定 的 内 容 并 完成 当前 的 
应 用 程序 。 


28.10 WPF 数据 绑 定 模型 


各 种 数据 绑 定 操作 的 目标 通常 是 控件 。 简 单 地 说 ， 数 据 绑 定 是 将 应 用 程序 生命 周期 过 程 中 可 能 会 
改变 的 数据 值 连接 到 控件 属性 的 行为 。 这 样 可 以 在 代码 中 使 用 户 界 面 元 素 显 示 变 量 的 状态 。 例 如 ， 可 
以 使 用 数据 绑 定 完成 以 下 任务 : 

口 根据 给 定 对 象 的 某 个 Boolean 属 性 检查 CheckBox 控 件 ; 

口 在 DataGrid 对 象 中 显示 来 自 关 系数 据 库 表 中 的 数据 ; 
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口 将 Label 连 接 到 表示 文件 夹 中 文件 数量 的 整数 。 

在 使 用 固有 的 WPF 数 据 绑 定 引 擎 时 ， 必 须 注意 绑 定 操 作 中 源 和 目标 的 区 别 。 数 据 绑 定 操作 中 的 源 
是 指数 据 本 身 ( 如 Boolean 属 性 或 相关 的 数据 )， 而 目标 是 指使 用 数据 内 容 的 UI 控件 属性 ( 如 CheckBox 
或 TextBox )。 

实际 上 ，WPF 数 据 绑 定 基础 结构 的 使 用 并 不 是 强制 的 。 但 如 果 要 自己 得 到 数据 绑 定 逻辑 ， 源 和 目 
标 之 间 的 连接 常常 会 需要 处 理 各 种 事件 并 编写 程序 代码 。 例 如 ,如果 窗口 中 含有 一 个 ScrollBar, 需要 
将 其 值 显示 在 一 个 Label 类 型 上 ， 你 就 需要 处 理 ScrollBar 的 ValueChanged 事 件 ， 并 相应 地 更 新 Label 的 
内 容 。 

尽管 如 此 ， 你 可 以 使 用 WPF 数 据 绑 定 直接 在 XAML 中 ( 或 在 代码 文件 中 使 用 C# 代 码 ) 连接 源 和 目 
标 ， 而 不 需要 处 理 各 种 事件 和 硬 编 码 。 同 样 ， 根 据 数据 绑 定 逻 辑 的 设置 ， 可 以 使 源 和 目标 在 任何 一 方 
的 值 有 变化 时 都 能 保持 同步 。 


28.10.1 构建 Data Binding 选 项 卡 


使 用 Document Outline 编 辑 器 ， 将 第 三 个 选项 卡 的 Grid 改 为 stackpanel。 然 后 使 用 Toolbox 和 Visual 
Studio 的 Properties 编 辑 器 构建 如 下 的 初始 布局 : 


<TabItem x:Name="tabDataBinding" Header="Data Binding"> 
<StackpPanel Width="250"> 
<Label Content="Move the scroll bar to see the current value"/> 


《1-- 滚动 条 的 值 是 该 数据 绑 定 的 数据 源 --> 
<ScrollBar x:Name="mySB" Orientation="Horizontal" Height="30" 
Minimum = "1" Maximum = "100" LargeChange="1" SmallChange="1"/> 


<1-- Label 的 内 容 将 绑 定 到 滚动 条 上 --> 
<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" 
BorderThickness="2" Content = "0"/> 
</StackPanel> 
</TabItem> 


注意 ，<ScrollBar> 对 象 ( my5B ) 的 值 在 1 到 100 之 间 。 我 们 的 目的 是 确保 在 移动 滚动 条 ( 或 单 击 左 
右 箭头 ) 时 ，Label 能 自动 更 新 当前 的 值 。 目 前 ，Label 控 件 的 Content 属 性 的 值 设 为 "0" ,我 们 可 以 通过 数 
据 绑 定 操作 改变 这 个 值 。 


28.10.2 ”使 用 Visual Studio 建 立 数据 绑 定 


在 XAML 中 定义 绑 定 的 方法 是 使 用 {Binding} 标 记 扩展 。 如 果 用 Visual Studio 在 控件 之 间 建 立 绑 定 ， 
就 更 为 简单 。 例 如 ， 找 到 Label 对 象 的 content 属 性 ( 位 于 Properties 窗 口 的 Common 区 域 ), 单 击 旁 边 非 
常 小 的 白色 正方 形 ， 打 开 快 捷 菜单 ， 选 择 Data Binding ( 如 图 28-36 所 示 )。 
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图 28-36 ”配置 数据 绑 定 操作 


从 Binding Type 下 拉 列 表 中 选择 ElementName 选 项 ， 这 会 给 出 你 的 XAML 文 件 中 所 有 的 项 目 ， 我 
们 可 以 将 它们 作为 数据 绑 定 操作 的 源 。 在 元 素 名 称 树 控件 中 找到 ScrollBar 对 象 (mySB )。 在 Path 树 中 
找到 Value 属 性 ( 如 图 28-37 所 示 )。 完 成 之 后 单 击 OK 按钮 。 
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图 28-37 选择 源 对 象 及 其 属性 
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再 次 运行 该 程序 ， 可 以 看 到 在 移动 滑 块 时 标签 的 值 也 随 之 更 新 。 现 在 我 们 来 看 看 数据 绑 定 工具 为 
我 们 生成 的 XAML: 


<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" BorderThickness="2" 
Content = "{Binding Value, ElementName=mySB}"/> 


注意 Label 的 Content 属 性 的 值 ,在 这 里 ,ElementName 的 值 表示 数据 绑 定 操作 的 源 ( ScrollBar 对 象 )， 
而 Binding 关 键 字 后 面 的 项 (Value ) 表示 ( 在 本 例 中 ) 要 获取 的 元 素 的 属性 。 

如 果 你 以 前 使 用 过 WPF 数 据 绑 定 ， 可 能 以 为 在 设置 对 象 的 属性 时 必须 使 用 path 标记 。 例 如 ， 下 面 
的 标记 同样 可 以 更 新 Label : 


<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" 
BorderThickness="2" Content = "{Binding Value, ElementName=mySB}"/> 


默认 情况 下 ， 如 果 属 性 不 是 男 一 个 对 象 的 子 属性 ( 如 my0bject.MyProperty.0bject2.Property2 )， 
Visual Studio 将 省 略 数据 绑 定 操作 的 Path= 部 分 。 


28.10.3 DataContext 属 性 


你 还 可 以 使 用 其 他 格式 在 XAML 中 定义 数据 绑 定 操作 。 通 过 显 式 地 将 数据 绑 定 操作 的 源 设置 给 
DataContext， 可 以 将 由 {Binding} 标 记 扩 展 指定 的 值 进 行 分 离 。 例 如 : 


<1-- 用 DataContext 将 对 象 和 值 分 开 --> 

<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" 
BorderThickness="2" 
DataContext = "{Binding ElementName=mySB}" 
Content = "{Binding Path=Value}" /> 


对 于 当前 示例 来 说 ， 如 果 这 样 修改 标记 ， 将 得 到 同样 的 输出 结果 。 那 么 什么 时 候 需要 显 式 设置 
DataContext 属 性 呢 ? 由 于 子 元 素 可 以 继承 源 在 标记 树 中 的 值 ， 因 此 是 十 分 有 帮助 的 。 

使 用 这 种 方法 ， 可 以 简单 地 为 一 组 控件 设置 同样 的 数据 源 ， 而 不 需要 为 多 个 控件 重复 设置 
"{Binding ElementName=X，Path=Y}"。 例 如 ， 假 设 我 们 在 该 选项 卡 中 的 <StackPanel> 中 添加 了 一 个 新 的 
Button( 稍 后 你 就 会 知道 为 什么 将 按钮 设置 得 如 此 之 大 ): 

<Button Content="Click”Height="140"/> 

你 可 以 使 用 Visual Studio 为 多 个 控件 生成 数据 绑 定 ， 也 可 以 使 用 XAML 编辑 器 手工 输入 修改 后 的 
标记 : 

<!-- 注意 StackPanel 设 置 了 DataContext 属 性 --> 


<StackPanel Width="250" DataContext = "{Binding ElementName=mySB}"> 
<Label Content="Move the scroll bar to see the current value"/> 


<ScrollBar Orientation="Horizontal" Height="30" Name="mySB" 
Maximum = "100" LargeChange="1" SmallChange="1"/> 


《<1-- 两 个 UI 元 素 以 独特 的 方式 使 用 滚动 条 的 值 --> 
<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" BorderThickness="2" 
Content = "{Binding Path=Value}"/> 


<Button Content="Click” Height="200" 
FontSize = "{Binding Path=Value}"/> 
</StackPanels 
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我 们 在 这 里 直接 设置 了 <StackPanel> 的 DataContext 属 性 。 因 此 , 在 移动 滑 块 时 , 不 仅 Label 的 值 会 
发 生 改变 ，Button 中 的 字体 也 会 相应 地 放大 或 缩小 ( 图 28-38 显 示 了 可 能 的 输出 结果 )。 








a 
守 MainWindow 








[kan] Doruments | Data Binding [Datacidj _ _ 


Move the scroll bar to see the current value 








| 
| Click | 


Cte racy 


图 28-38 ”将 ScrollBar 的 值 绑 定 到 Label 和 Button 











28.10.4 ”使 用 IValueConverter 进 行 数 据 转 换 


ScrollBar 类 型 使 用 double 而 不 是 整数 来 表示 滑 块 的 值 。 因此 在 拖 动 滑 块 时 , Label 中 将 显示 不 同 的 
浮 点 数 ( 如 61.0576923076923 )。 这 对 于 用 户 来 说 是 非常 不 直观 的 ， 因 为 他 们 更 希望 看 到 整数 ( 如 61、 
62 和 63 )。 

如 果 和 希望 将 数据 绑 定 操作 的 值 转换 为 其 他 格式 ， 可 以 创建 一 个 自 定义 类 ， 实 现 System.Windows . 
Data 命 名 空间 中 的 IValueConverter 接 口 。 该 接口 定义 了 两 个 成 员 ， 可 以 将 值 转换 为 目标 类 型 ， 或 从 目 
标 类 型 转换 为 值 ( 双向 数据 绑 定 )。 然 后 它 可 以 用 来 进一步 限定 数据 绑 定 操作 的 过 程 。 

假设 我 们 要 在 Label 控 件 中 显示 整数 ,可 以 构建 如 下 的 自 定义 转换 类 。 激 活 Project~~Add Class 菜 单 ， 
插入 名 为 MyDoubleConverter 的 类 。 然 后 添加 如 下 代码 : 


class MyDoubleConverter : IValueConverter 


public object Convert(object value, Type targetType, object parameter, 
System.Globalization.CultureInfo culture) 


{ 
// 将 double 转 换 为 int 
double v = (double)value; 
return (int)v; 


public object ConvertBack(object value, Type targetType, object parameter, 
System.Globalization.CultureInfo culture) 


{ 
// 这 里 我 们 不 用 担心 “双向 ” 绑 定 ， 因 此 直接 返回 value 
return value; 
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当 值 从 源 ( ScrollBar ) 转换 为 目标 ( TextBox 的 Text 属 性 ) 时 ,会 调用 Convert() 方 法 。 它 接收 很 
多 参数 ， 但 在 该 示例 中 我 们 只 操作 传人 的 代表 当前 double 值 的 object 参 数 。 我 们 使 用 该 类 型 将 其 转换 
为 整 型 ， 并 返回 。 

当 值 从 目标 传递 回 源 时 (需要 启用 双向 绑 定 模式 )， 将 调用 ConvertBack() 方 法 。 这 里 我 们 直接 返 
回 value。 这 样 如 果 在 TextBox 中 输入 浮 点 值 ( 如 99.9 )， 而 当 用 户 将 焦点 移 开 该 控件 时 ， 将 自动 转换 为 
整数 值 ( 如 99 )。 之 所 以 会 发 生 这 种 “免费 的 ”转换 ， 是 因为 在 调用 了 ConvertBack() 之 后 又 再 次 调用 
了 Convert()。 如 果 在 ConvertBack() 中 简单 地 返回 nul1， 文 本 框 将 仍然 显示 浮 点数 ， 这 样 绑 定 就 不 同 
步 了 = 


28.10.5 ”在 代码 中 建立 数据 绑 定 


有 了 这 个 类 , 就 可 以 向 要 使 用 该 类 的 控件 注册 自 定义 的 转换 器 。 仅 在 XAML 中 就 可 以 完成 该 任务 ， 
但 这 需要 定义 一 些 自 定义 的 对 象 资源 (下 一 章 将 介绍 )。 而 现在 ,我 们 可 以 在 代码 中 注册 数据 转换 类 。 
先 清理 一 下 数据 绑 定 选项 卡 中 <Label> 控 件 的 定义 ， 使 其 不 再 使 用 {Binding} 标 记 扩 展 : 


<Label x:Name="labelSBThumb" Height="30" BorderBrush="Blue" 
BorderThickness="2" Content = "0"/> 


在 窗口 的 构造 函数 中 ,调用 一 个 新 的 私有 辅助 函数 SetBindings()。 在 该 方法 中 添加 如 下 代码 : 
private void SetBindings() 


{ 
// 创建 Binding 对 象 
Binding b = new Binding(); 


// 注册 转换 器 、 源 和 路 径 

b.Converter = new MyDoubleConverter(); 
b.Source = this.mySB; 

b.Path = new PropertyPath("Value"); 


// 调用 Label 的 SetBinding() 方 法 
this.labelSBThumb.SetBinding(Label.ContentProperty, b); 


} 

该 函数 中 唯一 有 点 陌生 的 大 概 就 是 SetBinding() 方 法 。 注意 它 的 第 一 个 参数 调用 了 Label 类 中 的 静 
态 只 读 字段 ContentProperty。 现 在 我 们 所 指定 的 叫做 依赖 属性 ， 这 将 在 第 31 章 中 进行 介绍 。 此 时 ， 只 
需要 知道 在 代码 中 设置 绑 定 时 ， 第 一 个 参数 总 是 需要 指定 进行 绑 定 的 类 的 名 称 ( 本 例 中 为 Label )， 然 
后 再 调用 包含 -Property 后 级 的 实际 属性 ( 同样 将 在 第 31 章 中 介绍 )。 无 论 如 何 ， 运 行程 序 将 看 到 只 打 
印 整数 的 Label。 


28.10.6 ”构建 DataGrid 选 项 卡 


前 面 的 示例 演示 了 如 何 为 一 个 数据 绑 定 操作 配置 两 个 (或 多 个 ) 控件 。 我 们 还 可 能 从 XML 文件 、 
数据 库 数据 和 内 存 对 象 中 绑 定 数据 。 为 了 完成 该 示例 ， 我 们 来 设计 选项 卡 控件 中 的 最 后 一 个 选项 卡 ， 
它 将 显示 从 AutoLot 数 据 库 的 Inventory 表 中 获取 的 数据 。 

与 其 他 选项 卡 一 样 , 我 们 先 将 当前 的 Grid 更 改 为 stackPanel。 我 们 使 用 Visual Studio 直 接 在 XAML 
中 进行 修改 。 然 后 在 新 的 StackPanel 中 定义 一 个 DataGrid 控 件 ， 命 名 为 gridInventory: 
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<TabItem x:Name="tabDataGrid" Header="DataGrid"> 
<StackPanel> 
<DataGrid x:Name="gridInventory" Height="288"/> 
</StackPanel> 
</TabItem> 


接 下 来 ,引用 第 23 章 中 创建 的 AutoLotDAL.dll 程 序 集 ( 使 用 了 Entity Framework )。 此 时 , Visual Studio 
会 自动 引用 System.Data. Entity.dll， 以 及 相关 的 App.config 文 件 ， 该 文件 包含 了 所 需 的 连接 字符 串 数 据 
( 检查 Solution Explorer 确 认 情 况 ， 如 果 没 有 ， 手 动 添加 必需 的 项 目 )。 

打开 窗口 的 代码 文件 ， 添 加 最 后 一 个 辅助 函数 ConfigureGrid() ， 并 在 构造 函数 中 调用 它 。 引 入 
AutoLotDAL 命 名 空间 ， 我 们 所 要 做 的 仅仅 是 添加 这 几 行 代码 : 


private void ConfigureGrid() 


using (AutoLotEntities context = new AutoLotEntities()) 


// 构建 从 Inventory 表 中 获取 数据 的 LINQ 查 询 

var dataToShow = from c in context.Inventories 
select new { c.CarID, c.Make, c.Color, c.PetName }; 

this.gridInventory.ItemsSource = dataToShow; 


} 

注意 ,我们 没有 直接 将 context.Inventories 绑 定 到 网 格 的 ItemSource 集 合 ， 而 是 对 其 构建 了 一 个 
貌似 请 求 同 一 个 数据 的 LINQ 查 询 。 这 么 做 的 原因 是 ，Inventory 对 象 集 还 包含 其 他 未 映射 到 物理 数据 
库 的 EF 属性 ， 如 果 不 这 么 做 ,它们 也 将 显示 在 网 格 中 。 

如 果 这 时 运行 项 目 ， 会 看 到 一 个 极其 普通 的 网 格 。 为 了 避免 视觉 疲劳 ， 我 们 使 用 Visual Studio 的 
Properties 窗 口 编辑 DataGrid 的 Rows 属 性 ， 将 AlternationCount 属 性 的 值 至 少 设置 为 2， 并 使 用 
AlternatingRowBackground 和 RowBackground 属 性 集成 的 编辑 器 选择 一 个 自 定义 画 刷 ， 该 示例 的 最 后 一 
个 选项 卡 如 图 28-39 所 示 。 
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图 28-39 项 目的 最 后 一 个 选项 卡 


该 示例 就 介绍 到 这 了 ,在 接 下 来 的 几 章 中 ,我 们 将 使 用 一 些 其 他 的 控件 ,现在 ,你 应 该 对 使 用 Visual 
Studio 以 及 手工 编写 XAML 和 C# 代 码 来 构建 UI 的 过 程 ， 有 了 一 定 的 认识 。 
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源 代码 WpfControlsAndAPIs 项 目的 源 代 码 位 于 Chapter 28 子 目录 下 。 


28.11 ”小结 


本 章 开 头 概述 了 控件 工具 包 和 布局 管理 器 ( 面板 )， 随 后 介绍 了 一 些 WPF 控 件 。 第 一 个 示例 构建 
了 一 个 简单 的 文字 处 理应 用 程序 ， 演 示 了 WPF 集 成 的 拼写 检查 功能 ， 以 及 如 何 使 用 菜单 系统 、 状 态 条 
和 工具 条 构建 主 窗 口 。 

更 重要 的 是 , 我 们 学 习 了 如 何 使 用 WPF 命 令 。 可 以 将 这 些 控件 无 关 的 事件 附加 到 UI 元 素 或 某 种 输 
入 方式 ,来 自动 集成 方便 的 服务 ( 如 剪贴 板 操作 )。 

我 们 还 学 习 了 通过 集成 的 可 视 设计 器 使 用 Visual Studio 构 建 用 户 界面 ， 特 别 是 使 用 各 种 工具 构建 
复杂 的 用 户 界面 ， 并 同时 介绍 了 WPF Ink 和 Document API。 我 们 还 介绍 了 WPF 数 据 绑 定 操 作 ， 如 如 何 
使 用 WPF DataGrid 类 显示 自 定义 的 AutoLot 数 据 库 中 的 数据 。 






WPF 图 形 呈 现 服务 ， 





开 





章 将 介绍 WPF 的 图 形 呈 现 能 力 。 你 将 看 到 WPF 提 供 了 三 种 不 同 的 方式 来 呈现 图 形 数据 
形状 (shape )、 绘 图 ( drawing ) 及 可 视 化 (visual )。 在 理解 了 每 种 方法 的 利弊 之 后 ， 
我 们 将 开始 学 习 使 用 System.Windows.Shapes 下 的 类 来 与 2D 图 形 世界 进行 交互 。 之 后 ,你 将 看 到 如 何 使 
用 绘图 和 几何 图 形 〈( geometry ) 以 一 种 更 轻 量 级 的 方式 来 呈现 2D 数 据 。 最 后 ， 你 将 学 习 如 何 使 用 可 视 
化 层 提供 最 强大 的 功能 和 最 优 的 性 能 。 

随 着 学 习 的 深入 ， 我 们 还 将 探讨 一 些 相关 的 话题 ， 例 如 创建 自 定 义 画 刷 〈brush ) 和 画笔 ( pen )、 
在 呈现 时 使 用 图 形变 换 ( graphical transformation ) 以 及 执行 命中 测试 (hit-test ) 操作 。 你 还 将 看 到 Visual 
Studio 的 集成 工具 和 新 的 Expression Design 工 具 ， 以 及 它们 是 如 何 简化 图 形 编码 的 。 





说 明 ”图形 ( graphics ) 是 WPF 开 发 的 关键 部 分 。 即 使 我 们 构建 的 不 是 偏重 图 形 的 应 用 程序 ( 如 视频 
游戏 或 多 媒体 应 用 程序 )， 当 你 使 用 控件 模板 、 动 画 和 数据 绑 定 定制 等 服务 的 时 候 ， 也 应 该 了 
解 本 章 讨论 的 话题 。 


29.1 理解 WPF 的 图 形 呈 现 服务 


WPF 使 用 一 种 特殊 的 图 形 呈 现 方式 ， 叫 做 保留 模式 图 形 (retained mode graphics )。 简 言 之 ， 当 我 
们 使 用 XAML 或 程序 代码 来 呈现 图 形 时 ， 将 这 些 可 见 元 素 持久 化 ， 保 证 它们 被 正确 地 重 绘 并 以 最 优 的 
方式 刷新 都 是 WPF 的 职责 。 这 样 当 你 呈现 图 形 数据 时 ， 无论 最 终 用 户 通 过 改变 窗口 大 小 隐藏 图 像 、 最 
小 化 窗口 还 是 用 一 个 窗口 覆盖 另 一 个 ， 它 总 是 存在 的 。 

与 此 大 相 径 庭 的 是 ， 过 去 的 微软 图 形 呈 现 API ( 包括 Windows Form 的 GDI+ ) 都 是 即时 模式 
(immediate-mode ) 图 形 系统 。 在 这 种 模式 中 ， 将 由 程序 员 来 保证 呈现 的 可 视 元 素 被 正确 地 “记忆 ”， 
并 在 应 用 程序 生命 周期 正确 地 更 新 。 举 个 例子 , 在 Windows Form 应 用 程序 中 呈现 一 个 矩形 包括 几 个 部 
分 : 处 理 Paint 事 件 (或 重 写 0nPaint() 虚 方法 )， 获 取 一 个 呈现 矩形 的 Graphics 对 象 ， 最 重要 的 是 ， 增 
加 基础 设施 来 保证 当 用 户 更 改 窗口 大 小 时 能 够 对 图 像 进 行 持久 化 ( 例如, 通过 程序 调用 Invalidate()， 
创建 表示 矩形 位 置 的 成 员 变 量 )。 

这 种 从 即时 模式 到 保留 模式 的 观念 转变 , 减少 了 程序 员 需 要 编写 和 维护 的 乱糟糟 的 图 形 代 码 。 然 
而 , 我 们 并 不 是 说 WPF 图 形 API 与 之 前 的 呈现 工具 包 完 全 不 同 。 举 例 来 说 ，WPF 像 GDI+ 一 样 支持 多 种 
画 刷 和 画笔 类 型 、 命 中 测试 、 剪 裁 区 域 (clipping region )、 图 形变 换 ， 等 等 。 因 此 ， 如 果 你 有 在 GDI+ 
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(或 基于 GDI 的 C/C++ ) 的 编程 经 验 ， 就 应 该 知道 许多 在 WPF 下 进行 基本 呈现 的 知识 。 


WPF 图 形 呈 现 方式 


和 WPF 开 发 的 其 他 方面 一 样 , 除了 采用 XAML 或 C# 程 序 代码 以 外 , 还 可 以 选择 很 多 方式 来 实现 图 
形 呈 现 。 具 体 地 说 ，WPF 提 供 了 3 种 不 同 的 方式 来 呈现 图 形 数据 。 
口 形状 (Shape) : WPF 提 供 了 System.Windows.Shapes 命 名 空间 ， 定 义 了 少量 的 类 来 呈现 2D 几 
何 图 形 对 象 ( 如 矩形、 椭圆 形 、 和 多边 形 等 )。 尽 管 这 些 类 简单 易 用 且 功 能 强大 ， 但 如 果 滥 用 却 
会 导致 大 量 的 内 存 占用 。 

口 绘图 和 几何 图 形 〈Drawing 和 Geometrie) : WPF API 提 供 的 另 一 种 呈现 图 形 数据 的 方法 是 派 
生 System.Windows .Media.Drawing 抽 象 类 。 使 用 GeometryDrawing 或 ImageDrawing 这 样 的 类 ( 和 
若干 几何 对 象 )， 你 可 以 用 一 种 轻 量 级 ( 但 功能 有 限 ) 的 方式 来 呈现 图 形 数 据 。 

口 可 视 化 (Visual) : 在 WPF 中 呈现 图 形 数据 最 快速 、 最 轻 量 级 的 方式 就 是 使 用 可 视 化 层 ， 你 只 

能 通过 C# 代 码 来 访问 该 层 。 使 用 System.Windows.Media.Visual 的 派生 类 可 以 直接 与 WPF 图 形 
子 系统 进行 对 话 。 

为 相同 的 功能 (如 呈现 图 形 数据 ) 提供 不 同 的 实现 方式 ， 其 目的 是 为 了 处 理 内 存 使 用 和 优化 应 用 
程序 性 能 。 由 于 WPF 是 一 个 图 形 密集 型 系统 , 在 一 个 应 用 程序 的 窗 体 表面 呈现 成 百 上 千张 图 片 并 不 是 
没有 可 能 ， 因 此 所 选择 的 实现 方式 (形状 、 绘 图、 可 视 化 ) 将 会 给 程序 带 来 巨大 的 影响 。 

在 构建 WPF 应 用 程序 时 ,不 同 的 情况 要 选用 不 同 的 方式 。 一 般 来 说 ， 如 果 你 需要 一 些 可 以 由 用 户 
操作 (接收 鼠标 输入 、 显 示 工 具 提 示 等 ) 的 交互 图 形 数据 ， 应 该 使 用 System.Windows .Shapes 命 名 空间 
下 的 那些 成 员 。 

相反 ， 当 你 希望 用 XAML 或 C# 展 示 复 杂 的 、 非 交互 的 、 基 于 矢量 的 图 形 数据 时 ， 绘 图 和 几何 图 形 
更 适合 一 些 。 尽 管 它们 也 能 响应 鼠标 事件 、 命 中 测试 和 拖 忠 操作 ， 但 这 需要 编写 更 多 的 代码 。 

最 后 ， 如 果 需 要 快速 地 呈现 大 量 图 形 数 据 , 使 用 可 视 化 层 是 最 好 的 方法 。 假 设 你 正在 使 用 WPF 构 
建 一 个 有 关 科学 的 应 用 程序 , 可 以 描绘 成 千 上 万 的 数据 点 。 使 用 可 视 化 层 能 以 最 佳 的 方式 呈现 这 些 点 。 
你 将 在 本 章 后 面 看 到 ， 可 视 化 层 只 能 用 C# 代 码 访问 ， 而 不 能 使 用 XAML 。 

不 管 使 用 什么 方式 ( 形状、 绘图 和 几何 图 形 、 可 视 化 ), 你 都 会 使 用 通用 的 图 形 基 元 ， 如 画 刷 (用 
来 填充 图 形 内 部 )、 画 笔 ( 用 来 绘制 图 形 边框 ) 以 及 变换 对 象 ( 用 来 变换 数据 )。 我 们 先 从 
System.Windows.Shapes 人 手 ， 来 开启 WPF 图 形 呈 现 之 旅 。 


说 了 明 WPF 还 发 布 了 用 于 呈现 和 操作 3D 图 形 的 API, 不 过 本 书 将 不 对 此 进行 讨论 。 如果 你 希望 在 应 用 
程序 中 使 用 3D 图 形 ， 请 参考 NET Framework 4.5 SDK 文 档 。 


29.2 ”使 用 形状 呈现 图 形 数据 


System.Windows.Shapes 命 名 空间 的 成 员 提 供 了 简单 易 用 、 交 互 性 强 但 同时 也 会 占用 大 量 内 存 的 方 
式 来 呈现 二 维 图 像 。 该 命名 空间 ( 定义 在 PresentationFramework.dll 程 序 集中 ) 非常 小 , 只 包含 6 个 扩展 
了 抽象 类 Shape 的 密封 类 : Ellipse、Rectangle、Line、Polygon、Polyline 和 Path。 
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我 们 新 建 一 个 名 为 RenderingWithShapes 的 WPF 应 用 程序 。 现 在 ， 在 Visual Studio 中 的 对 象 浏 览 器 
里 找到 Shape 类 ( 如 图 29-1 所 示 )， 并 打开 所 有 父 节 点 ， 你 将 看 到 Shape 的 派生 类 从 继承 链 中 继承 了 大 量 
的 功能 。 
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图 29-1 二 类 中 继承 了 大 量 的 功能 


这 些 父 类 也 许 会 帮 你 回忆 起 前 两 章 所 学 的 内 容 。 例 如, UIElement 定 义 了 大 量 的 方法 来 接收 鼠标 输 
入 和 处 理 拖 忠 事件 ，FrameworkElement 定 义 了 一 些 成 员 来 处 理 尺 寸 、 工 具 提 示 、 和 鼠标 光标 ， 等 等 。 在 
这 种 继承 链 下 ， 当 我 们 用 Shape 的 派生 类 来 呈现 图 形 数据 时 ， 这 些 对 象 ( 就 其 交互 性 而 言 ) 仅仅 是 一 
个 WPF 控 件 。 

例如 ,判断 用 户 是 否 单 击 了 所 呈现 的 图 形 ， 其实 就 是 在 处 理 MouseDown 事 件 。 举 例 来 说 ， 如 果 你 为 
一 个 Rectangle 对 象 在 初始 的 Window 中 的 Grid 里 编写 了 如 下 所 示 的 XAML: 


<Rectangle x:Name="myRect” Height="30" Width="30" 
Fill="Green" MouseDown="myRect MouseDown"/> 


那么 你 可 以 在 C# 代 码 中 实现 MouseDown 事 件 处 理 程序 ， 在 单 击 矩形 时 改变 其 背景 颜色 ， 如 下 所 示 : 


private void myRect MouseDown(object sender, MouseButtonEventArgs e) 


// 在 单 击 时 改变 算 形 的 颜色 
myRect.Fill = Brushes.Pink; 


与 其 他 图 形 工具 不 同 ,将 鼠标 坐标 手工 映射 到 几何 图 形 上 、 手 工 计算 命中 测试 、 呈 现 到 离 屏 缓 冲 
区 等 工作 都 不 必 再 编写 大 量 的 基础 代码 。System.Windows.Shapes 中 的 成 员 可 以 简单 地 响应 你 注册 的 事 
件 ， 就 像 处 理 典型 的 WPF 控 件 (如 Button ) 一 样 。 

形状 的 这 些 方 便 的 功能 也 有 一 个 缺点 ， 它 们 会 占用 大 量 的 内 存 。 就 像 之 前 提 到 的 ， 如 果 要 构建 一 

会 在 屏幕 上 绘制 上 千 个 点 的 科学 应 用 程序 ， 使 用 形状 将 是 一 个 错误 的 选择 ( 基本 上 和 呈现 上 千 个 
ie 多 )。 但 是 ， 如 果 你 只 需要 生成 一 个 交互 式 的 2D 矢 量 图 形 ， 形 状 将 是 一 
个 完美 的 选择 。 
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除了 从 父 类 UIElement 和 FrameworkElement 继 承 的 功能 之 外 ，Shape 还 为 每 个 派生 类 定义 了 许多 成 
员 。 表 29-1 列 出 了 一 些 常 用 的 成 员 。 


表 29-1 Shape 基 类 的 主要 属性 


属 性 含义 

DefiningGeometry 返回 一 个 Geometry 对 象 ， 表 示 当 前 形状 的 整体 尺寸 。 该 对 象 仅 包含 用 于 呈现 数 
据 的 坐标 点 ， 并 且 没 有 继承 UIElement 或 FrameworkElement 提 供 的 功能 

Fill 指定 一 个 “ 画 刷 对 象 ”来 呈现 形状 的 内 部 

GeometryTransform 在 形状 呈现 在 屏幕 之 前 , 对 其 进行 变换 。 而 继承 自 UIElement 的 RenderTransform 
属性 在 形状 呈现 在 屏幕 上 之 后 对 其 执行 变换 

Stretch 描述 如 何在 分 配 的 区 域内 填充 形状 , 如 在 一 个 布局 管理 器 中 的 位 置 。 这 是 用 相 
应 的 System.Windows .Media.Stretch 枚 举 来 控制 的 

Stroke 定义 一 个 画 刷 对 象 ， 在 某 些 情况 下 也 可 能 是 画笔 对 象 ( 其 实 是 一 个 变相 的 画 


刷 )， 用 来 绘制 形状 的 轮廓 


StrokeDashArray, StrokeEnd- 这 些 ( 以 及 其 他 ) 与 笔画 (stroke ) 相关 的 属性 用 于 控制 在 呈现 形状 轮廓 时 的 
LineCap，StrokeStartLineCap， ”线条 设置 。 在 大 多 数 情 况 下 ， 这 些 属性 可 以 设 定 用 来 绘制 轮廓 或 线条 的 画 刷 


StrokeThickness 


说 明 如果 你 忘记 了 设置 Fi11 和 Stroke 属 性 ，WPF 将 使 用 “隐藏 的 ” 画 刷 ， 从 而 使 形状 在 屏幕 中 不 
可 见 。 


29.2.1 在 画布 中 添加 和 矩形、 椭圆 形 和 线条 


本 章 后 面 的 小 节 将 会 介绍 使 用 Expression Design 来 生成 图 形 数据 的 XAML 描述 信息 。 而 现在 ， 我 
们 将 使 用 XAML 和 C# 来 构建 一 个 可 以 呈现 形状 的 WPF 应 用 程序 , 并 在 这 个 过 程 中 学 习 一 些 命中 测试 的 
内 容 。 首先, 移 除 当 前 的 Rectangle 描 述 和 C# 事 件 处 理 程序 逻辑 。 然 后 ,更 新 <Window> 中 初始 的 XAML， 
定义 一 个 包含 <ToolBar> 和 <Canvas> 的 <DockPanel>。 注意 我 们 已 经 通过 Name 属 性 为 每 个 项 都 指定 了 恰当 
的 名 称 。 


<DockPanel LastChildFill="True"> 
<ToolBar DockPanel.Dock="Top" Name="mainToolBar" Height="50"> 
</ToolBar> 


<Canvas Background="LightBlue" Name="canvasDrawingArea"/> 
</DockPanel> 


现在 用 一 组 <RadioButton> 对 象 来 填充 <ToolBar>， 每 个 <RadioButton> 的 内 容 都 是 一 个 特定 的 Shape 
派生 类 。 注 意 每 个 <RadioButton> 的 GroupName 都 是 相同 的 〈 用 来 确保 它们 是 互 斥 的 )， 并 且 都 赋予 了 恰 
当 的 名 称 : 
<ToolBar DockPanel.Dock="Top" Name="mainToolBar" Height="50"> 
<RadioButton Name="circleOption" GroupName="shapeSelection"> 


<Ellipse Fill="Green" Height="35" Width="35" /> 
</RadioButton> 


<RadioButton Name="rectOption" GroupName="shapeSelection"> 
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<Rectangle Fill="Red" Height="35" 
Width="35" RadiusY="10" RadiusX="10" /> 


</RadioButton> 
<RadioButton Name="lineOption" GroupName="shapeSelection"> 
<Line Height="35" Width="35" 

StrokeThickness="10" Stroke="Blue" 
X1="10" Y1="10" Y2="25" X2="25" 
StrokeStartLineCap="Triangle" StrokeEndLineCap="Round"” /> 

</RadioButton> 

</ToolBar> 


如 你 所 见 ， 在 XAML 中 定义 Rectangle、Ellipse 和 Line 对 象 十 分 简单 并 且 不 需要 注释 。Fill 属 性 用 来 
指定 绘制 形状 内 部 的 画 刷 。 如 果 需 要 单 色 画 刷 ， 你 只 需要 用 硬 编码 的 字符 串 指定 一 个 颜色 值 ， 隐 式 类 型 
转换 就 会 生成 正确 的 对 象 。 有 趣 的 是 ，Rectangle 类 型 还 定义 了 RadiusX 和 RadiusY 属 性 ， 用 来 呈现 圆 角 。 

Line 使 用 X1 、Xx2 、Y1、Y2 属 性 来 表示 线条 的 起 始 和 结束 点 坐标 (因为 高 度 和 宽度 对 线条 来 说 没 什 
么 意义 )。 在 这 里 ， 我 们 建立 了 一 些 额外 的 属性 来 呈现 Line 的 起 始 和 结束 点 ， 以 及 如 何 设置 笔画 。 图 
29-2 显 示 了 在 Visual Studio WPF 设 计 器 中 所 呈现 的 工具 条 。 
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图 29-2 用 shape 作 为 RadioButton 的 内 容 


现在 ， 使 用 Visual Studio 中 的 Properties 窗 口 ， 处 理 Canvas 的 MouseLeftButtonDown 事 件 和 每 个 
RadioButton 的 Click 事 件 。 在 C# 代 码 中 , 我们 的 目标 是 在 用 户 单 击 Canvas 时 呈现 所 选择 的 形状 ( 圆 形 、 
正方 形 或 线条 )。 首 先 ， 在 Window 派 生 类 中 定义 一 个 内 艇 的 枚 举 ( 以 及 相应 的 成 员 变量 ): 


public partial class MainWindow : Window 


private enum SelectedShape 
{ Circle, Rectangle, Line } 


private SelectedShape currentShape; 
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在 每 个 Click 事 件 处 理 程序 中 , 将 currentshape 成 员 变 量 设 置 为 正确 的 Selectedshape 值 。 例 如 ， 如 
下 所 示 的 circle0ption RadioButton 的 Click 事 件 处 理 程序 的 实现 代码 。 其 他 两 个 Click 处 理 程序 的 代码 
与 之 类 似 : 


private void circle0ption Click(object sender，RoutedEventArgs e) 


currentShape = SelectedShape.Circle; 


在 Canvas 的 MouseLeftButtonDown 事 件 处 理 程序 中 ， 我 们 使 用 预先 定义 的 尺寸 来 呈现 正确 的 形状 ， 
用 鼠标 光标 的 X、Y 位 置 作为 起 始点 。 下 面 是 完整 的 代码 和 分 析 说 明 : 


private void canvasDrawingArea MouselLeftButtonDown(object sender,MouseButtonEventArgs e) 
Shape shapeToRender = null; 


// 设置 要 绘制 的 形状 


switch (currentShape) 


case SelectedShape.Circle: 
shapeToRender = new Ellipse() { Fill = Brushes.Green, Height = 35, Width = 35 }; 
break; 
case SelectedShape.Rectangle: 
shapeToRender = new Rectangle() 
{ Fill = Brushes.Red, Height = 35, Width = 35, RadiusX = 10, RadiusY = 10 }; 
break; 
case SelectedShape.Line: 
shapeToRender = new Line() 


Stroke = Brushes.Blue， 
StrokeThickness = 10， 
X1 = 0, X2 = 50，Y1 = 0, Y2 = 50， 
StrokeStartLineCap= PenLineCap.Triangle， 
StrokeEndLineCap = PenLineCap.Round 

}; 

break; 

default: 
return; 


// 设置 形状 在 画布 中 距离 顶部 和 左 侧 的 相对 位 置 
Canvas.SetLeft(shapeToRender, e.GetPosition(canvasDrawingArea).X); 
Canvas.SetTop(shapeToRender, e.GetPosition(canvasDrawingArea).Y); 
// 绘制 形状 

canvasDrawingArea.Children.Add(shapeToRender); 





说 明 ”你 会 发 现在 该 方法 中 创建 的 Ellipse、Rectangle 和 Line 对 象 与 XAML 中 定义 的 对 象 有 相同 的 属 
性 值 。 你 可 能 希望 精简 代码 ， 但 这 需要 理解 WPF 的 对 象 资源 ， 我 们 将 在 第 30 章 中 介绍 。 


如 你 所 见 ， 我 们 使 用 currentshape 成 员 变 量 来 创建 正确 的 Shape 派 生 类 。 然 后 使 用 传人 的 
MouseButtonEventArgs 分 别 设置 距离 Canvas 边 界 项 部 和 左 侧 的 值 。 最 后 也 是 最 重要 的 ， 我 们 将 Shape 派 
生 类 添加 到 canvas 中 声明 的 UIElement 对 象 集合 中 。 如 果 现 在 运行 程序 ,你 可 以 在 画布 中 的 任何 位 置 进 
行 单 击 ， 同 时 所 选择 的 形状 也 将 呈现 在 鼠标 左 键 单 击 的 位 置 。 
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29.2.2 ”在 画布 中 移 除 矩 形 、 圆 形 和 线条 


在 包含 一 个 对 象 集合 的 Canvas 中 ， 你 可 能 不 知道 如 何 动态 地 移 除 一 个 对 象 ， 你 也 许 会 希望 通过 右 
击 一 个 形状 即 可 。 你 当然 可 以 这 么 做 ， 只 需要 使 用 System.Nindows.Media 命 名 空间 下 的 
VisualTreeHelper 类 就 可 以 实现 这 个 目的 。 在 第 31 章 中 ， 我 们 将 详细 介绍 “视觉 树 ” 和 “逻辑 树 ” 的 
作用 。 在 此 之 前 ， 可 以 像 下 面 的 代码 这 样 实现 Canvas 对 象 的 MouseRightButtonDown 事 件 处 理 程序 : 
private void canvasDrawingArea MouseRightButtonDown(object sender, MouseButtonEventArgs e) 
// 首先 ， 得 到 用 户 单 击 的 X，Y 位 置 
Point pt = e.GetPosition((Canvas)sender); 
// 使 用 VisualTreeHelper 的 HitTest() 方 法 来 检查 用 户 是 否 单 击 了 画布 中 的 菜 个 对 象 
HitTestResult result = VisualTreeHelper.HitTest(canvasDrawingArea, pt); 


// 如 果 Tesult 不 为 nul1， 说 明 饼 标 确实 单 击 了 某 个 形状 
if (result != null) 


1 
// 获取 被 单 击 的 那个 形状 ， 然 后 将 其 从 画布 中 移 除 


canvasDrawingArea.Children.Remove(result.VisualHit as Shape); 


: 


该 方法 首先 获取 了 用 户 单 击 canvas 的 具体 Xx、Y 坐 标 , 然后 通过 VisualTreeHelper.HitTest() 方 法 执 
行 了 一 个 命中 测试 操作 。 如 果 用 户 没 有 单 击 Canvas 中 的 某 个 UIElement, 返回 值 HitTestResult 对 象 将 为 
nul1。 如 果 HitTestResult 不 为 nul1， 我 们 可 以 通过 VisualHit 属 性 获取 被 单 击 的 UIElement ， 然 后 将 其 
转换 为 Shape 派 生 类 ( 记 住 ，Canvas 可 以 包含 任何 UIElement ， 而 不 仅仅 是 形状 ! ) 你 将 在 下 一 章 中 看 到 
有 关 “ 视 党 树 ”的 详细 内 容 。 


说 明 默认 情况 下 , VisualTreeHelper.HitTest() 返 回 的 是 被 单 击 的 最 顶层 UIElement, 而 不 会 提供 它 
下 层 的 对 象 信息 ( 如 果 对 象 按 Z 轴 重 登 )。 


这 样 改动 之 后 , 你 可 以 在 画布 中 通过 单 击 鼠 标 来 添加 一 个 形状 , 通过 右 击 来 删除 一 个 形状 。 图 29-3 
显示 了 这 项 功能 : 
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在 本 节 中 ， 我 们 使 用 XAML 在 RadioButton 中 呈现 了 Shape 派 生 类 对 象 ， 并 用 C# 填 充 了 一 个 
Canvas。 在 学 习 了 画 刷 和 图 形变 换 之 后 ， 我 们 将 给 该 示例 添加 更 多 的 功能 。 为 了 演示 UIElement 对 
象 的 拖 中 技术 , 我 们 还 准备 了 一 个 新 的 示例 。 在 这 之 前 , 我 们 先 来 学 习 一 下 System.Windows.Shapes 
的 其 他 成 员 。 


29.2.3 ”折线 和 多 边 形 


上 面 的 示例 只 用 了 3 个 shape 派 生 类 。 其 他 的 子 类 ( Polyine 、Polygon 和 Path ) 如 果 没 有 工具 ( 如 
Expression Blend 或 Expression Design ) 支持 的 话 ， 要 想 正确 呈现 会 显得 极其 烦琐 。 因 为 要 表示 这 些 形 
状 的 输出 需要 绘制 大 量 的 点 。 我 们 稍 后 将 介绍 Expression Design 的 作用 ， 现 在 先 来 大 致 了 解 一 下 其 他 
的 Shape 类 型 。 
Polyline 类 型 允许 我 们 定义 一 个 (x,y) 坐 标 集 合 (通过 Points 属 性 ), 通过 这 些 坐 标 绘制 一 系列 线段 ， 
但 它们 不 需要 首尾 相 接 。Polygon 类 型 与 之 类 似 , 只 不 过 它 会 将 起 点 和 终点 连接 起 来 并 用 画 刷 进行 填充 。 
假设 在 kaxaml 编 辑 器 (或 在 第 27 章 中 创建 的 自 定 义 XAML 编辑 器 ) 中 存在 如 下 的 <Stackpanel>: 
<1-- Polylines 不 会 自动 闭合 --> 
<Polyline Stroke ="Red" StrokeThickness ="20" StrokelLineJoin ="Round" 
Points ="10,10 40,40 10,90 300,50"/> 

<1-- Polygon 总 是 自动 闭合 --> 

<Polygon Fill ="AliceBlue" StrokeThickness ="5" Stroke ="Green" 
Points ="40,10 70,80 10,50" /> 


图 29-4 显 示 了 输出 结果 。 
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29.2.4 路径 


单独 使 用 Rectangle、Ellipse 、Polygon、Polyline 和 Line 类 型 来 绘制 详细 的 2D 矢 量 图 形 可 能 会 略 
显 复杂 , 因为 这 些 基 元 形状 不 允许 我 们 简单 地 获取 图 形 数 据 , 如 曲线 、 重 和 至 数据 , 等 等 。 最 后 一 个 Shape 
派生 类 Path 通 过 相互 独立 的 几何 图 形 集合 来 表示 复杂 的 二 维 图 形 数据 。 如 果 你 定义 了 这 样 一 个 几何 图 
形 集合 ， 可 以 将 其 赋 给 Path 类 的 Data 属 性 ， 用 来 呈现 复杂 的 二 维 图 像 。 

Data 属 性 的 类 型 为 System.Windows .Media.Geometry 派 生 类 ， 其 主要 成 员 如 表 29-2 所 示 。 
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表 29-2 System.Windows .Media.Geometry 类 型 的 成 员 


成 员 含 义 
Bounds 建立 包含 几何 图 形 的 边界 矩形 
FillContains() 判断 给 定 的 Point ( 或 其 他 Geometry 对 象 ) 是 否 包 含 在 指定 的 Geometry 派 生 类 的 
边界 内 。 这 对 于 命中 测试 计算 来 说 是 十 分 有 用 的 
CetArea() 返回 Geometry 派 生 类 所 占 的 整个 区 域 
GetRenderBounds() 返回 一 个 Rect， 它 所 代表 的 矩形 是 用 来 呈现 Geometry 派 生 类 的 最 小 矩形 
Tranform 设置 一 个 用 来 改变 几何 图 形 呈 现 的 Transform 对 象 


Geometry 的 派生 类 ( 如 表 29-3 所 示 ) 与 shape 的 派生 类 十 分 类 似 。 例 如 ，EllipseGeometry 有 着 和 
Ellipse 相 似 的 成 员 。 它们 最 大 的 区 别 就 是 Geometry 派 生 类 不 知道 如 何 直 接 呈 现 它们 本 身 , 并 且 它 们 不 
是 继承 自 UIElement 的 。 相 反 ，Geometry 派 生 类 所 表示 的 只 不 过 是 点 数据 的 集合 ， 这 实际 上 是 在 说 “如 
果 将 我 赋 给 一 个 Path 对 象 ， 我 就 会 呈现 我 自己 ”。 


说 明 Path 并 不 是 WPF 中 唯一 使 用 几何 图 形 集 合 的 类 。 例 如 ，DoubleAnimationUsingPath 、 
DrawingGroup 、 GeometryDrawing 其 至 UIElement 都 能 分 别 使 用 各 自 的 PathGeometry 、 
ClipGeometry、Geometry 和 Clip 属 性 来 呈现 几何 图 形 。 


表 29-3 ”Geometry 派 生 类 





Geometry 类 含义 
LineGeometry 表示 一 条 直线 
RectangleGeometry 表示 一 个 矩形 
EllipseGeometry 表示 一 个 圆 形 
GeometryGroup 允许 你 将 多 个 Geometry 对 象 组 合 在 一 起 
CombinedGeometry 允许 你 将 两 个 不 同 的 Geometry 对 象 合 并 成 一 个 单独 的 形状 
PathGeometry 表示 由 直线 和 曲线 组 成 的 图 像 


假设 kaxaml 中 有 如 下 所 示 的 Path, 它 使 用 了 一 些 Geometry 派 生 类 , 注意 , 我 们 将 一 个 GeometryGroup 
对 象 赋 给 了 path 的 Data 属 性 ， 这 个 GeometryGroup 还 包含 了 其 他 一 些 Geometry 派 生 对 象 ， 如 
EllipseGeometry、RectangleGeometry 和 LineGeometry。 输 出 结果 如 图 29-5 所 示 。 


《<1-- Path 的 Data 属 性 值 为 一 组 几何 图 形 对 象 --> 
<Path Fill = "Orange" Stroke = "Blue" StrokeThickness = "3"> 
<Path .Data> 
<GeometryGroup> 
<EllipseGeometry Center = "75,70" 
RadiusX = "30" RadiusY = "30" /> 
<RectangleGeometry Rect = "25,55 100 30" /> 
<LineGeometry StartPoint="0,0" EndPoint="70,30" /> 
<LineGeometry StartPoint="70,30" EndPoint="0,30" /> 
</GeometryGroup> 
</Path.Data> 
</Path> 
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$ 寺 efad 攻 .xarm 











图 29-5 包含 不 同 Geometry 对 象 的 Path 


图 29-5 中 的 图 像 完 全 可 以 用 之 前 介绍 的 Line 、Ellipse 和 Rectangle 类 来 呈现 。 但 这 需要 将 各 种 
UIElement 对 象 放 入 内 存 。 而 如 果 使 用 几何 图 形 来 建立 绘制 点 , 然后 将 几何 图 形 的 集合 放 入 可 以 呈现 数 
据 的 容器 中 ( 如 Path )， 则 可 以 降低 内 存 开销 。 

由 于 Path 和 其 他 System.Windows.Shapes 有 同样 的 继承 链 , 可 以 像 其 他 UIElement 对 象 那样 发 送 同 样 
的 事件 通知 。 因 此 如 果 在 Visual Studio 项 目 中 定义 同样 的 <Path> 元 素 , 就 可 以 编写 鼠标 的 事件 处 理 程序 
来 判断 用 户 是 否 单 击 了 线段 的 某 个 区 域 ( 记 住 ，kaxaml 不 允许 在 标记 中 处 理事 件 )。 

路 径 “ 迷 你 语言 建 模 ” 

在 表 29-3 所 列 的 类 中 ,不 论 是 在 XAML 还 是 在 代码 中 ,PathGeometry 都 是 最 难 配 置 的 PathGeometry 
中 的 每 个 段 ( segment ) 都 是 由 包含 其 他 段 和 图 像 的 对 象 组 成 的 ( 如 ArcSegment 、BezierSegment 、 
LineSegment 、PolyBezierSegment 、PolyLineSegment 、PolyQuadraticBezierSegment 等 )。 下 面 的 示例 中 
包含 一 个 Path 对 象 ， 它 的 Data 属 性 设置 为 一 个 由 各 种 图 像 和 有 段 组 成 的 <PathGeometry>。 


<Path Stroke="Black" StrokeThickness="1" > 
<Path.Data> 
<PathGeometry> 
<PathGeometry.Figures> 
<PathFigure StartPoint="10,50"> 
<PathFigure.Segments> 

<BezierSegment 
Point1="100,0" 
Point2="200,200" 
Point3="300,100"/> 

<LineSegment Point="400,100" /> 

<ArcSegment 
Size="50,50" RotationAngle="45" 
IsLargeArc="True" SweepDirection="Clockwise" 
Point="200,100"/> 

</PathFigure.Segments> 
</PathFigure> 
</PathGeometry.Figures> 
</PathGeometry> 
</Path .Data> 
</Path> 


坦白 地 说 , 很 少 有 程序 员 会 通过 直接 描述 Geometry 或 Pathsegment 派 生 类 来 手工 创建 复杂 的 二 维 图 
像 。 实 际 上 ， 组 成 复杂 的 路 径 是 通过 Expression Design 来 完成 的 。 

即使 有 这 些 工具 的 辅助 ， 定 义 一 个 复杂 path 对象 的 XAML 代 码 还 是 十 分 庞大 的 ， 这 是 因为 数据 包 
含 了 各 种 Geometry 或 Pathsegment 派 生 类 的 完整 描述 。 要 创建 更 加 简明 紧凑 的 标记 ， 可 以 选择 为 Path 类 
设计 的 一 种 特定 的 “迷你 语言 ”( mini-language )。 
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例如 ， 我 们 不 必用 Geometry 和 Pathsegment 派 生 类 的 集合 来 设置 Path 的 Data 属 性 ， 而 只 是 使 用 一 个 
字符 串 。 这 个 字符 串 包含 一 些 特定 的 符号 和 各 种 值 ， 可 以 定义 要 呈现 的 形状 。 事 实 上 ， 用 Expression 
工具 创建 Path 对 象 时 ,会 自动 使 用 迷你 语言 。 下 面 是 一 个 简单 的 示例 及 其 输出 结果 ( 如 图 29-6 所 示 )。 

<Path Stroke="Black" StrokeThickness="3" 

Data="M 10,75 C 70,15 250,270 300,175 H 240" /> 


> default.xaml* 





图 29-6 ”路 径 迷 你 语言 可 以 简洁 地 描述 Geometry/PathSegment 对 象 模 型 


M 命 令 ( move 的 简称 ) 包含 一 个 x、Y 坐 标 来 标识 图 形 的 起 始点 。C 命 令 包 含 一 系列 绘制 点 来 呈现 曲 
线 (确切 地 说 是 一 个 三 次 方 贝 赛 尔 曲 线 )， 而 H 绘 制 一 个 水 平 直线 。 
坦白 地 说 ， 现 在 你 手工 创建 或 解析 一 个 包含 路 径 迷 你 语言 指令 的 字符 串 的 几率 几乎 为 0。 不 过 ， 
至 少 你 不 会 在 看 到 由 工具 生成 的 XAML 时 会 大 吃 一 惊 。 如 果 你 对 这 个 特殊 的 语法 感 兴 趣 ， 可 以 查 
看 .NET Framework 4.5 SDK 文 档 中 的 “Path Markup Syntax”。 


29.3 WPF 男 刷 和 画笔 


画 刷 可 以 控制 2D 表 面 的 填充 方式 , 它 在 各 种 WPF 图 形 呈 现 选项 ( 形状 、 绘图 和 几何 图 形 、 可视化) 
中 被 广泛 地 使 用 。WPF 提 供 了 6 种 不 同 的 画 刷 类 型 ， 它 们 都 扩展 自 System.Windows .Media.Brush。 由 于 Brush 是 
抽象 的 ， 填 充 一 个 区 域 主要 使 用 表 29-4 所 示 的 后 代 类 。 


表 29-4 ”WPF 画 刷 派生 类 型 


画 刷 类 型 含 义 
DrawingBrush 使 用 Drawing 派 生 对 象 ( GeometryDrawing 、ImageDrawing 或 VideoDrawing ) 绘制 区 域 
ImageBrush 使 用 图 像 ( ImageSource 对 象 ) 绘制 区 域 
LinearGradientBrush 使 用 线性 渐变 绘制 区 域 
RadialGradientBrush 使 用 径 向 渐变 绘制 区 域 
SolidColorBrush 绘制 纯色 ， 设 置 其 Color 属 性 
VisualBrush 使 用 Visual 派 生 对 象 (DrawingVisual 、Viewport3DVisual 和 ContainerVisual ) 绘制 区 域 


DrawingBrush 和 VisualBrush 类 允许 你 基于 一 个 已 知 的 Drawing 或 Visual 派 生 类 来 构建 画 刷 。 这 些 画 
刷 类 可 以 用 于 其 他 两 个 WPF 图 形 选 项 中 〈 绘图 和 可 视 化 )， 这 将 在 本 章 稍 后 讨论 。 
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顾名思义 ，ImageBrush 人 允许 你 通过 设置 ImageSource 属 性 来 构建 一 个 画 刷 ， 这 个 画 刷 能 够 显示 外 部 
文件 或 内 艇 的 应 用 程序 资源 中 的 图 像 数据 。 其 余 的 画 刷 类 型 ( LinearGradientBrush 和 
RadialGradientBrush ) 尽 管 所 需 的 XAML 代 码 有 点 宛 长 , 但 用 起 来 却 十 分 简单 .幸运 的 是 , Visual Studio 
支持 集成 的 画 刷 编辑 器 ， 大 大 简化 了 生成 程式 化 画 刷 的 过 程 。 


29.3.1 使 用 Visual Studio 配 置 画 刷 


现在 我 们 使 用 一 些 更 有 趣 的 画 刷 来 修改 我 们 的 WPF 绘 图 程序 RenderingWithShapes。 我 们 之 前 绘制 
的 3 个 形状 使 用 了 简单 的 纯色 来 呈现 数据 ， 因 此 可 以 通过 简单 的 字符 串 文本 来 获取 它们 的 值 。 不 过 为 
了 让 事情 更 有 趣 一 些 ， 我 们 将 使 用 集成 的 画 刷 编 辑 器 。 确 保 IDE 中 打开 的 窗 体 为 初始 窗 体 的 XAML 编 
辑 器 ， 然 后 选择 El1l1ipse 元 素 。 现 在 ,在 Properties 窗 体 中 找到 Brush 分 类 ， 点 击 最 上 面 的 Fil1 属 性 ( 如 
图 29-7 所 示 )。 


2 PROPERTIES ett: tes ee 


© Name <No Name> 


Type Ellipse 
Search Properties 
Arrange by: Category " 
Brush 
No brush 


No brush 


图 


Editor D Colorresources 


4 Appeorance 


Opacity 100% 





Visibility Visible 
图 29-7 ”任何 使 用 画 刷 的 属性 都 可 以 通过 集成 的 画 刷 编辑 器 来 进行 配置 


在 画 刷 编辑 器 的 最 上 方 ， 是 被 选项 中 所 有 “ 画 刷 兼容 的 ”属性 ( 如 Fill、Stroke、0pacityMash )。 
下 面 是 一 系列 选项 卡 , 可 以 配置 不 同 的 画 刷 类 型 , 包括 纯色 画 刷 。 你 可 以 使 用 颜色 选择 器 工具 和 ARGB 
(alpha、red、green 和 blue， 其 中 alpha 控 制 透 明度 ) 编辑 器 来 控制 当前 画 刷 的 颜色 。 使 用 这 些 滑 块 和 相 
关 的 颜色 选择 区 域 , 可 以 创建 各 种 各 样 的 纯色 。 我 们 继续 使 用 这 些 工具 来 改变 Ellipse 的 Fill 颜 色 , 并 
查看 XAML 的 输出 结果 。 你 会 发 现 颜 色 的 值 存储 为 十 六 进 制 ， 例 如 : 

<Ellipse Fill="#FF47CE47" Height="35" Width="35" /> 

更 有 趣 的 是 ， 同 样 的 编辑 器 还 允许 你 配置 渐变 色 的 画 刷 ， 可 以 定义 一 系列 颜色 和 变换 点 。 画 刷 编 
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辑 器 包含 一 组 选项 卡 ， 其 中 第 一 个 将 设置 为 空 刷 (nullbrush )， 不 会 呈现 任何 内 容 。 其 余 4 个 可 分 别 用 
来 设置 纯色 画 刷 (我 们 刚刚 讨论 过 )、 渐 变色 画 刷 、 瓦 片 画 刷 和 图 像 画 刷 。 

单 击 渐变 色 画 刷 按钮 , 编辑 器 将 显示 一 些 新 的 选项 ( 如 图 29-8 所 示 )。 左下 方 的 3 个 按钮 可 以 选择 
线性 渐变 、 径 向 渐变 或 反 转 渐变 截止 点 。 最 下 端的 滑 块 显示 各 个 渐变 截止 点 的 颜色 ， 每 个 截止 点 由 滑 
块 上 的 一 个 “箭头 ”标记 。 你 可 以 通过 拖 动 滑 块 上 的 箭头 来 控制 渐变 的 偏 移 量 。 此 外 , 单 击 某 个 箭头 ， 
还 可 以 在 颜色 选择 器 上 来 改变 渐变 截止 点 的 颜色 。 最 后 ， 直接 单 击 渐变 滑 块 ， 可 以 添加 一 个 新 的 渐变 
截止 点 。 


SPRODERTIES £70: tr 


© Name <No Name> 


Type Ellipse 
Search Properties 
Arrange by: Category " 
4 Brush 


Stroke No brush 
OpacityMask No brush 


| 名 | 国 


Editor Coior resources 


4 个 ， 100% 


| Radial gradient ~ 
4 Ap 


Opacity 100% 





图 29-8 使 用 Visual Studio 画 刷 编辑 器 创建 基本 的 渐变 画 刷 


现在 我 们 来 花 点 时 间 在 这 个 编辑 器 上 创建 一 个 径 向 渐变 画 刷 ， 它 包含 三 个 渐变 截止 点 , 分 别 设置 
为 你 所 选择 的 颜色 。 图 29-8 显 示 了 我 刚刚 构建 的 画 刷 ， 使 用 了 三 种 深浅 不 同 的 绿色 。 

完成 之 后 ，IDE 将 更 新 XAML， 生 成 一 个 自 定义 的 画 刷 并 通过 属性 元 素 语法 将 其 赋 给 一 个 与 画 刷 
兼容 的 属性 ( 本 例 中 Ellipse 的 Fil1 属 性 )。 例 如 : 


<Ellipse Height="35" Width="35"> 
<Ellipse.Fill> 
<RadialGradientBrush> 
<GradientStop Color="#FF87E71B" Offset="0.589" /> 
<GradientStop Color="#FF2BA92B" Offset="0.013" /> 
<GradientStop Color="#FF34B71B" Offset="1" /> 
</RadialGradientBrush> 
</Ellipse.Fill> 
</Ellipse> 
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29.3.2 ”在 代码 中 配置 画 刷 


由 于 我 们 为 EL1ipse 的 XAML 构 建 了 一 个 自 定 义 画 刷 ， 相 应 的 C# 代 码 就 过 期 了 ， 因 为 它 所 呈现 的 
仍然 是 纯 绿 色 的 圆圈 。 要 想 在 代码 中 达到 同样 的 效果 ， 需 要 用 刚刚 创建 的 画 刷 来 更 新 代码 。 下 面 的 代 
码 显示 了 必要 的 更 新 ， 它 看 上 去 比 想象 的 要 复杂 一 些 ， 这 是 因为 我 们 使 用 了 System.Windows.Media. 
ColorConverter 类 将 十 六 进 制 的 值 转换 成 了 olor 对象 ( 图 29-9 为 更 改 后 的 输出 结果 ): 


case SelectedShape.Circle: 
shapeToRender = new Ellipse() { Height = 35, Width = 35 }; 


// 在 代码 中 创建 一 个 RadialGradientBrush 

RadialGradientBrush brush = new RadialGradientBrush(); 

brush.GradientStops.Add(new GradientStop( 
(Color)ColorConverter.ConvertFromString("#FF87E71B"), 0.589)); 

brush.GradientStops.Add(new GradientStop( 
(Color)ColorConverter.ConvertFromString("#FF2BA92B"), 0.013)); 

brush.GradientStops.Add(new GradientStop( 
(Color)ColorConverter.ConvertFromString("#FF34B71B"), 1)); 


shapeToRender.Fill = brush; 
break; 














FE 
| a Fun with Shapes! — 











图 29-9 ”用 更 漂亮 的 方式 来 绘制 圆圈 


顺便 说 一 句 ， 如 果 在 创建 Gradientstop 时 希望 使 用 简单 的 颜色 ， 可 以 将 构造 函数 的 第 一 个 参数 设 
置 为 Colors 枚 举 ， 它 能 返回 配置 好 的 Color 对 象 : 

GradientStop g = new GradientStop(Colors.Aquamarine, 1); 

或 者 ， 如 果 你 需要 对 颜色 进行 细微 地 控制 ， 可 以 传人 一 个 特定 的 Color 对 象 。 例 如 : 


Color myColor = new Color() { R = 200, G = 100, B = 20, A = 40 }; 
GradientStop g = new GradientStop(myColor, 34); 


当然 , Colors 枚 举 和 Color 类 并 不 仅 限于 渐变 画 刷 。 在 代码 中 你 可 以 将 其 用 于 任何 需要 表示 一 个 颜 
色 的 地 方 。 
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29.3.3 配置 画笔 


与 画 刷 相 比 ， 画 笔 是 用 来 绘制 几何 图 形 边框 或 线条 图 形 ( 如 Line、PolyLine 类 ) 的 对 象 。Pen 类 人 允 
许 我 们 绘制 指定 粗 度 ， 用 double 值 表示 。 此 外 ，pPen 的 一 些 属性 还 与 Shape 类 的 属性 类 似 ， 如 开始 和 结 
束 的 笔 端 样式 、 虚 线 模式 ， 等 等 。 例 如 : 


<Pen Thickness="10" LineJoin="Round" EndLineCap="Triangle" StartLineCap="Round" /> 


在 大 多 数 情况 下 ， 你 都 不 需要 直接 创建 Pen 对 象 ， 因 为 指定 某 个 属性 的 值 将 会 间接 创建 ， 如 Shape 
派生 类 ( 以 及 其 他 UIElement ) 的 StrokeThickness 属 性 。 尽 管 如 此 ， 在 使 用 Drawing 派 生 类 型 (本章 稍 
后 会 有 介绍 ) 时 ， 创 建 一 个 自 定 义 的 Pen 对 象 还 是 十 分 方便 的 。Visual Studio 没 有 画笔 编辑 器 ， 但 它 允 
许 你 在 Properties 窗 体 中 配置 被 选项 中 所 有 与 笔画 相关 的 属性 。 


29.4 图 形变 换 


让 我 们 通过 变换 这 个 话题 来 对 形状 的 讨论 做 一 个 总 结 。WPF 发 布 了 很 多 扩展 自 System.Windows . 
Media.Transform 抽 象 基 类 的 类 。 表 29-5 列 出 了 很 多 主要 的 Transform 派 生 类 。 


表 29-5 System.Windows.Media.Transform 类 型 的 主要 后 代 





类 型 含义 
MatrixTransform 创建 任意 一 个 矩阵 变换 ， 用 于 操作 2D 平 面 中 的 对 象 或 坐标 系 
RotateTransform 在 2D(xwy) 坐 标 系 内 围绕 一 个 指定 点 ， 按 顺 时 针 方 向 旋转 对 象 
ScaleTransform 在 2D(xy) 坐 标 系 内 缩放 一 个 对 象 
SkewTransform 在 2D(xy) 坐 标 系 内 扭曲 一 个 对 象 
TranslateTransform 在 2D(x,y) 坐 标 系 内 平移 ( 移动 ) 一 个 对 象 
TransformGroup 标识 由 其 他 Transform 对 象 组 合成 的 复合 Transform 


你 可 以 对 任何 UIElement 应 用 变换 ( 如 shape 派 生 类 以 及 Button、TextBox 等 控件 ), 使 用 这 些 变换 类 ， 
你 可 以 用 给 定 的 角度 呈现 图 形 数据 ， 可 以 扭曲 平面 中 的 图 像 ， 还 可 以 扩大 、 缩 小 或 反 转 目标 项 。 


说 明 尽管 变换 对 象 可 以 用 于 各 个 地 方 ， 但 你 会 发 现 最 常用 的 还 是 WPF 动 画 和 自 定义 控件 模板 。 正 
如 你 稍 后 会 看 到 的 那样 ， 可 以 使 用 WPF 动 画 为 自 定 义 控 件 添 加 一 些 视觉 效果 。 


变换 对 象 可 以 赋 给 包含 两 个 共同 属性 的 目标 对 象 ( 如 Button、Path 等 )。LayoutTransform 属 性 用 于 
将 元 素 呈 现 到 布局 管理 器 之 前 发 生变 换 ， 因 此 它 不 会 对 Z 轴 的 操作 产生 影响 ( 也 就 是 说 ， 发 生变 换 的 
图 像 数据 不 会 产生 重生 )。 

RenderTransform 属 性 发 生 于 元 素 呈 现在 容器 中 之 后 ， 因 此 ， 根 据 元 素 在 容器 中 的 位 置 ， 它 们 在 进 
行 变 换 时 很 有 可 能 相互 重 和 至。 
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29.4.1 变换 概览 


稍 后 我 们 将 在 RenderingWithShapes 项 目 中 加 入 一 些 变换 逻辑 。 现 在 ， 我 们 先 来 看 看 实际 的 变换 对 
象 。 打 开 kaxaml (或 自 定义 的 XAML 编 辑 器 )， 在 根 元 素 <Page> 或 <Nindow> 中 定义 一 个 简单 的 
<Stackpanel>， 将 其 orientation 属性 设置 为 Horizontal。 然 后 ， 添 加 下 面 的 <Rectangle>， 它 使 用 
RotateTransform 对 象 旋转 了 45。 。 


《1-- 进行 旋转 变换 的 矩形 --> 
<Rectangle Height ="100" Width ="40" Fill ="Red"> 
<Rectangle.LayoutTransform> 
<RotateTransform Angle ="45"/> 
</Rectangle.LayoutTransform> 
</Rectangle> 


下 面 是 一 个 <Button>， 它 使 用 <SkewTransform> 对 表面 扭曲 了 20%。 


《1-- 进行 捏 曲 变换 的 按钮 --> 
<Button Content ="Click Me!" Width="95" Height="40"> 
<Button.LayoutTransform> 
<SkewTransform AngleX ="20" AngleY ="20"/> 
</Button.LayoutTransform> 
</Button> 


此 外 ， 还 有 一 个 通过 ScaleTransform 放 大 20 倍 的 <Ellipse>( 注意 其 初始 的 Height 和 Width 值 )， 
及 使 用 了 多 个 变换 对 象 的 <TextBox>。 


《1-- 放大 了 20 倍 的 圆 形 --> 
<Ellipse Fil] ="Blue" Width="5" Height="5"> 
<Ellipse.LayoutTransform> 
<ScaleTransform ScaleX ="20" ScaleY ="20"/> 
</Ellipse.LayoutTransform> 
</Ellipse> 


《1-- 旋转 和 扭曲 了 的 文本 框 --> 
<TextBox Text ="Me Too!” Width="50" Height="40"> 
<TextBox.LayoutTransform> 
<TransformGroup> 
<RotateTransform Angle ="45"/> 
<SkewTransform AngleX ="5" AngleY ="20"/> 
</TransformGroup> 
</TextBox.LayoutTransform> 
</TextBox> 


要 注意 的 是 在 应 用 了 某 个 变换 后 ,你 不 需要 执行 任何 手工 的 计算 来 正确 响应 命中 测试 、 输 入 焦点 
等 操作 。 WPF 图 形 引擎 已 经 为 你 处 理 好 了 这 一 切 。 例如 在 图 29-10 中 ， 你 可 以 看 到 TextBox 仍 然 可 以 响 
应 键盘 输入 。 





Ne AN 











图 29-10 图 形变 换 对 象 的 输出 结果 
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29.4.2 ”变换 Canvas 数 据 


现在 我 们 来 看 看 如 何在 RenderingWithShapes 示 例 中 加 入 一 些 变换 逻辑 。 除 了 可 以 对 一 个 单个 项 
(如 Rectangle、TextBox 等 ) 进行 变换 之 外 ， 你 还 可 以 对 一 个 布局 管理 器 使 用 变换 对 象 ， 这 可 以 对 其 内 
部 的 所 有 数据 进行 变换 。 例 如 ， 你 可 以 对 主 窗 体 的 整个 cDockPanel> 旋 转 一 定 的 角度 : 


<DockPanel LastChildFill="True"> 
<DockPanel .LayoutTransform> 

<RotateTransform Angle="45"/> 
</DockPanel .LayoutTransform> 


</DockPanel> 

这 个 例子 有 点 极端 ， 现 在 我 们 来 添加 最 后 一 个 〈 不 那么 极端 的 ) 特性 ， 人 允许 用 户 反 转 整个 Canvas 
及 其 包含 的 图 形 。 我 们 向 <ToolBar> 中 添加 一 个 <ToggleButton>， 如 下 所 示 : 

<ToggleButton Name="flipCanvas" Click="flipCanvas Click" Content="Flip Canvas!"/> 


在 Click 事 件 处 理 程序 中 , 创建 一 个 RotateTransform 对 象 , 在 单 击 这 个 新 的 ToggleButton 时 ， 通 过 
LayoutTransform 属 性 将 其 与 Canvas 对 象 进行 关联 。 要 移 除 变换 可 以 将 该 属性 设置 为 null: 


private void flipCanvas Click(object sender, RoutedEventArgs e) 
{ 

if (flipCanvas.IsChecked == true) 

{ 


RotateTransform rotate = new RotateTransform(-180); 
canvasDrawingArea.LayoutTransform = rotate; 


else 


{ 


canvasDrawingArea.LayoutTransform = null; 


行程 序 , 在 画布 区 域 中 添加 一 些 图 形 。 单 击 新 的 按钮 , 你 会 发 现 这 些 形状 数据 流出 了 画布 边界 ! 
设 姑 鸭 为 叶 和 引物 有 写 女 前 入 区 庆 ( 如 图 29-11 所 示 )。 


E Fun with Shapes! x) 
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图 29-11 啊 ! 数据 在 变换 后 流 到 了 画布 外 面 


2 
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要 修复 这 个 问题 是 很 容易 的 。 你 不 必 手 工 编写 复杂 的 剪裁 逻辑 ， 只 需要 将 <Canvas> 的 ClipTo- 
Bounds 属 性 设置 为 true， 这 会 避免 子 元 素 呈 现 到 父 元 素 边 界 之 外 。 再 次 运行 程序 ， 你 会 发 现 数据 不 会 
再 跑 到 画布 外 面 了 。 


《Canvas ClipToBounds = "True” ... > 
还 有 一 个 小 问题 需要 修改 。 当 你 按 下 切换 按钮 翻转 画布 后 ,再 次 单 击 画 布 绘制 新 的 形状 时 ,你 单 
击 的 点 并 不 是 图 形 数据 实际 绘制 的 点 。 数 据 已 经 呈现 在 鼠标 光标 处 了 。 


要 解决 这 个 问题 , 我 在 代码 中 添加 了 一 个 Boolean 成 员 变 量 ( isFlipped ), 它 将 在 呈现 发 生 之 前 对 
绘制 的 形状 执行 同样 的 变换 ( 通过 RenderTransform )。 代 码 如 下 : 


private void canvasDrawingArea MouseLeftButtonDown(object sender, MouseButtonEventArgs e) 


Shape shapeToRender = null; 


// isFlipped 为 私有 的 布尔 字段 ， 单 击 切换 按钮 将 改变 它 的 状态 
if (isFlipped) 


RotateTransform rotate = new RotateTransform(-180); 
shapeToRender.RenderTransform = rotate; 


// 设置 画布 的 top/left 

Canvas.SetLeft(shapeToRender, e.GetPosition(canvasDrawingArea).X); 
Canvas.SetTop(shapeToRender, e.GetPosition(canvasDrawingArea).Y); 
// 绘制 形状 

canvasDrawingArea.Children.Add(shapeToRender); 


} 
这 个 示例 包含 了 System.Windows.Shapes、 画 刷 和 变换 。 在 学 习 使 用 绘图 和 几何 图 形 呈 现 数据 之 前 ， 
我 们 先 来 看 看 如 何 使 用 Expression Blend 来 简化 基 元 图 形 的 使 用 。 





源 代 码 ”RenderingWithShapes 项 目的 源 代 码 位 于 Chapter 29 子 目录 下 。 








29.5 使 用 Visual Studio 变换 编辑 器 


在 前 面 的 示例 中 , 我 们 通过 手动 输入 标记 并 编写 C# 代 码 实 现 了 多 种 变换 。 尽 管 这 很 有 用 , 但 你 一 
定 会 非常 高 兴 地 看 到 最 新 版 的 Visual Studio 中 包含 集成 的 变换 编辑 器 ， 它 使 用 集成 的 工具 非常 轻松 地 
生成 必要 的 转换 标记 。 记 住 ， 任 何 UI 元 素 都 可 以 作为 变换 服务 的 接收 者 ， 包 括 包含 不 同 UI 元 素 的 布局 
系统 。 为 了 演示 如 何 使 用 Visual Studio 变 换 编 辑 器 , 创建 一 个 新 的 WPF Application 项 目 FunWithTrasforms。 


29.5.1 构建 初始 布局 


首先 ， 使 用 集成 的 网 格 编辑 器 将 初始 的 Grid 切 分 为 两 列 ( 具体 尺寸 无 关 紧 要 )。 现 在 ， 在 Toolbox 
中 找到 StackPanel 控 件 并 添加 到 Grid 的 第 一 列 中 ， 使 其 占 满 该 列 。 例 如 ; 
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<Grid> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="221*"/> 
<ColumnDefinition Width="288*"/> 
</Grid.ColumnDefinitions> 
<StackPanel HorizontalAlignment="Left”Height="292”Margin="10,10,0,0” 
VerticalAlignment="Top”WMWidth="201" /> 
</Grid> 


下 面 ， 在 Document Outline 面 板 中 选择 StackPanel， 向 StackPanel 容 器 中 添加 3 个 Button 控 件 (如 
图 29-12 所 示 )。 





MainWindowxaml” 站 X MainWindowxamlcs | 
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图 29-12 包含 Button 控 件 的 StackPanel 


分 别 选中 3 个 Button , 将 其 Content 属 性 ( 位 于 Properties 窗 口 的 Common 部 分 ) 分 别 改 为 Skew、Rotate 
和 Flip。 同 样 使 用 Properties 面 板 中 的 Name 域 为 每 个 按钮 起 一 个 合适 的 名 字 ， 如 btnSkew 、btnRotate 和 
btnFile。 使 用 Properties 面 板 中 的 Events 选 项 卡 ， 处 理 每 个 Button 的 Click 事 件 。 我 们 稍 后 来 实现 这 些 处 
理 程 序 。 
最 后 ， 在 Grid 第 二 列 中 创建 一 个 你 选择 的 图 像 ( 可 以 使 用 本 章 介 绍 的 任何 技术 )。 图 29-13 显 示 了 
终 的 布局 。 我 在 这 里 创建 了 两 个 Ellipse 控 件 ， 并 将 其 组 合 进 一 个 名 为 myCanvas 的 Canvas 控 件 。 
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MainWindowxaml” 了 X MainWindowxamles" Object Bowser ~ 
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图 29-13 ”变换 示例 的 布局 


29.5.2 在 设计 时 应 用 变换 


如 前 所 述 ，Visual Studio 提 供 了 一 个 集成 的 变换 编辑 器 ， 位 于 Properties 面 板 中 。 找 到 该 区 域 ， 展 
开 Transform 节 可 以 看 到 编辑 器 中 的 RenderTransform 和 LayoutTransform 子 节 ( 如 图 29-14 所 示 )。 
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图 29-14 ”变换 编辑 器 
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和 Brushes 节 类 似 ，Transform 节 提供 了 很 多 选项 卡 ， 可 以 为 当前 选中 项 配置 不 同 的 图 像 变化 类 型 。 
表 29-6 描 述 了 各 个 变换 选项 ， 按 选项 卡 从 左 到 右 的 顺序 列 出 。 


表 29-6 ”变换 选项 


类 型 含义 
Translate ( 平移 ) 通过 设置 X, Y 来 平移 某 项 的 位 置 
Rotate ( 旋转 ) 通过 设置 角度 来 旋转 某 项 
Scale (缩放 ) . 通过 设置 X, Y 来 缩放 某 项 
Skew (扭曲 ) 通过 设置 X, Y 方 向 来 扭曲 选中 项 的 边框 
Center Point ( 中 心 点 ) 当 旋转 或 翻转 对 象 时 ， 对 象 的 移动 是 围绕 一 个 相对 固定 的 点 进行 的 ,叫做 对 象 


的 中 心 点 。 默 认 情 况 下 ,对象 的 中 心 点 位 于 对 象 的 中 心 , 但 这 种 变换 可 以 改变 
对 象 的 中 心 点 ， 使 旋转 或 翻转 时 围绕 的 是 一 个 不 同 的 点 
Flip (〈 翻转 ) 基于 X 或 Y 中 心 点 来 翻转 选中 的 项 


建议 你 用 自 定义 形状 作为 目标 ， 逐 个 测试 这 些 变 化 ( 用 CtrltZ 取 消 之 前 的 操作 )。 和 Transform 
Properties 面 板 的 其 他 部 分 一 样 , 每 个 变换 节点 都 有 不 同 的 配置 选项 , 它们 都 是 非常 容易 理解 的 。 例如 ， 
Skew 变 换 编辑 器 可 以 设置 X 和 Y 扭 曲 值 ，Flip 变 换 编辑 器 可 以 按 X 轴 或 Y 轴 翻转 ， 等 等 。 


29.5.3 ”在 代码 中 变换 画布 


每 个 Click 事 件 处 理 程序 或 多 或 少 都 十 分 类 似 。 我 们 会 配置 一 个 变换 对 象 ， 并 将 其 赋值 给 myCanvas 
对 象 。 因 此 运行 应 用 程序 时 ， 点 击 按钮 就 可 以 看 到 变换 的 结果 。 以 下 是 各 个 事件 处 理 程序 的 完整 代码 
( 注意 我 设置 的 是 LayoutTransform 属 性 ， 因 此 形状 数据 的 位 置 是 相对 于 父 容器 来 说 的 ): 

private void btnFlip Click(object sender, System.Windows.RoutedEventArgs e) 

myCanvas.LayoutTransform = new ScaleTransform(-1, 1); 

private void btnRotate Click(object sender, System.Windows.RoutedEventArgs e) 

myCanvas.LayoutTransform = new RotateTransform(180); 

private void btnSkew Click(object sender, System.Windows.RoutedEventArgs e) 


myCanvas.LayoutTransform = new SkewTransform(40, -20); 


源 代码 FunWithTransformations 项 目的 源 代码 位 于 Chapter29 子 目录 下 。 


29.6 ”使 用 绘图 和 几何 图 形 呈 现 图 形 数据 


尽管 shape 类 型 可 以 用 来 生成 各 种 二 维 平 面 图 形 ， 但 其 丰富 的 继承 链 需 要 消耗 大 量 的 内 存 。 尽 管 
Path 类 可 以 通过 内 含 几何 图 形 的 方式 ( 而 非 大 量 的 其 他 形状 ) 来 减少 一 部 分 内 存 损耗 ， 不 过 WPF 还 是 
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提供 了 一 个 高 雅 的 绘图 和 几何 图 形 编程 接口 ， 可 以 呈现 更 轻 量 级 的 2D 矢 量 图 像 。 

该 API 的 和 人 口 点 是 System.Windows.Media.Drawing 抽 象 类 ( 位 于 PresentationCore.dll 中 )， 它 本 身 也 
是 通过 定义 一 个 矩形 边界 来 呈现 的 。 注 意 在 图 29-15 中 ，Drawing 类 的 继承 链 比 Shape 要 精简 得 多 ， 
UIElement 和 FrameworkElement 都 不 在 其 中 。 
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Browse My Solution "| || 
<Search> ~ 
b ts DoubleCollectionConverter <^ @ Clone0 
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本 Object 
“© lAnmatable Su 
4 DrowingBrush Abstract class that describes a 2-D drawing. This 
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图 29-15 ”Drawing 类 比 Shape 要 精简 得 多 
WPF 提 供 了 很 多 Drawing 的 扩展 类 。 如 表 29-7 所 示 ， 它 们 都 代表 了 一 种 特殊 的 绘制 内 容 的 方式 。 
表 29-7 WPF 中 的 Drawing 派 生 类 型 


类 型 窗 文 
DrawingGroup 将 多 个 独立 的 Drawing 派 生 对 象 合并 成 一 个 单独 的 复合 绘图 进行 呈现 
CeometryDrawing 用 轻 量 级 的 方式 呈现 2D 形 状 
GlyphRunDrawing 用 WPF 图 形 呈 现 服 务 呈 现 文 本 数据 
ImageDrawing 在 矩形 边界 内 呈现 图 像 文 件 或 几何 图 形 集 
VideoDrawing 播放 音频 或 视频 文件 。 该 类 型 只 能 使 用 C# 人 代码 访问 。 如 果 要 在 XAML 中 播放 视频 ， 最 好 
使 用 Mediaplayer 类 型 


由 于 Drawing 是 轻 量 级 的 , 没有 继承 UIElement 或 FrameworkElement， 因 此 其 派生 类 型 不 能 处 理 输入 
事件 (尽管 它们 可 以 以 编程 方式 执行 命中 测试 逻辑 )。 

Drawing 派 生 类 型 与 shape 派 生 类 型 男 一 个 关键 的 不 同 点 是 ， 由 于 Drawing 没 有 继承 UIElement ， 因 
此 不 能 进行 星 现 。 要 想 显示 它们 的 内 容 ， 只 能 将 它们 放置 到 一 个 宿主 对 象 中 ( 如 DrawingImage 、 
DrawingBrush 或 DrawingVisual )。 

我 们 可 以 使 用 DrawingImage 将 绘图 和 几何 图 形 放置 到 WPF 的 Image 控 件 中 , 该 控件 通常 用 来 显示 外 
部 文件 中 的 数据 。DrawingBrush 可 以 用 来 构建 一 个 基于 绘图 和 几何 图 形 的 画 刷 ， 来 设置 需要 画 刷 的 属 
性 。 最 后 ，DrawingVvisual 仅 用 于 图 形 呈 现 的 完全 由 C# 代 码 驱 动 的 “可 视 化 ” 层 。 

尽管 绘图 比 形状 要 稍 显 复杂 ,但 它 将 图 形 的 组 成 和 图 形 的 呈现 解 厢 ， 这 使 得 Drawing 派 生 类 型 在 
保留 关键 服务 的 同时 比 shape 派 生 类 型 要 更 加 轻便 。 
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29.6.1 ”使 用 几何 图 形 构建 DrawingBrush 
在 前 面 的 示例 中 ,我们 用 多 个 几何 图 形 填充 一 个 Path， 例 如 : 


<Path Fill = "Orange" Stroke = "Blue” StrokeThickness = "3"> 
<Path.Data> 
<GeometryGroup> 
<EllipseGeometry Center = "75,70" 

RadiusX = "30" RadiusY = "30" /> 
<RectangleGeometry Rect = "25,55 100 30" /> 
<LineGeometry StartPoint="0,0" EndPoint="70,30" /> 
<LineGeometry StartPoint="70,30" EndPoint="0,30" /> 

</CGeometryGroup> 
</Path.Data> 
</Path> 


这 样 , 我 们 通过 Path 获 得 了 交互 功能 , 并 且 由 于 使 用 了 几何 图 形 ,因此 仍然 是 非常 轻便 的 。 但 是 ， 
如 果 你 希望 呈现 相同 的 内 容 却 不 需要 任何 交互 性 ， 可 以 将 相同 的 <GeometryGroup> 放 置 到 一 个 
DrawingBrush 内 ， 例 如 : 


<DrawingBrush> 
<DrawingBrush.Drawing> 
<GeometryDrawing> 
<GeometryDrawing.Geometry> 
<GeometryGroup> 
<EllipseGeometry Center = "75,70" 

RadiusX = "30" RadiusY = "30" /> 
<RectangleGeometry Rect = "25,55 100 30" /> 
<LineGeometry StartPoint="0,0" EndPoint="70,30" /> 
<LineGeometry StartPoint="70,30" EndPoint="0,30" /> 

/GeometryGroup> 
</GeometryDrawing.CGeometry> 

<1-- 用 来 绘制 边框 的 自 定义 画笔 --> 
<GeometryDrawing.Pen> 

<Pen Brush="Blue" Thickness="3"/> 

</GeometryDrawing.Pen> 

《<1-- 用 来 填充 内 部 的 自 定义 画 刷 --> 
<GeometryDrawing.Brush> 

<SolidColorBrush Color="Orange"/> 
</GeometryDrawing.Brush> 

</GeometryDrawing> 
</DrawingBrush.Drawing> 
</DrawingBrush> 


当 你 将 多 个 几何 图 形 放置 到 DrawingBrush 内 时 ,你 还 需要 建立 一 个 Pen 对 象 来 绘制 边框 ,因为 我 们 
没有 从 Shape 基 类 那里 继承 Stroke 属 性 。 这 里 , 我 创建 了 一 个 <Pen>, 其 设置 与 前 面 Path 示 例 中 的 Stroke 
和 StrokeThickness 的 值 一 样 。 

此 外 , 由 于 没有 从 Shape 继 承 Fill 属 性 , 我 们 还 需要 用 属性 元 素 语 法 来 为 <GeometryDrawing> 定 义 一 
个 画 刷 对 象 。 这 里 的 设置 和 前 面 的 Path 设 置 相同 ,使 用 了 一 个 橙色 的 画 刷 。 


29.6.2 ”用 DrawingBrush 进 行 绘画 


有 了 DrawingBrush， 就 可 以 将 它 赋 值 给 任何 需要 画 刷 对 象 的 属性 了 。 例 如 ， 如 果 在 kaxaml 中 存在 
如 下 的 代码 ， 就 可 以 使 用 属性 元 素 语法 在 page 的 整个 表面 进行 绘图 : 


~ 
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<Page 
ei 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xam]l"> 
<Page.Background> 
《<1-- 和 上 例 一 样 的 DrawingBrush --> 
< DrawingBrush > 


</DrawingBrush > 
</Page.Background> 
</Page> 


或 者 ， 你 也 可 以 将 该 <DrawingBrush> 赋 值 给 画 刷 兼容 的 属性 ， 如 Button 的 Background 属 性 : 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 


<Button Height="100" Width="100"> 
<Button.Background> 
《1-- 和 上 例 一 样 的 DrawingBrush --> 
</ DrawingBrush > 


</ DrawingBrush > 
</Button.Background> 
</Button> 


</Page> 


重要 的 是 ， 无 论 将 该 自 定义 的 cDrawingBrush> 赋 值 给 哪个 画 刷 兼容 的 属性 ， 这 种 呈现 2D 矢 量 图 像 
的 损耗 要 比 使 用 形状 呈现 同样 的 2D 图 像 小 得 多 。 


29.6.3 ”在 DrawingImage 中 使 用 绘图 类 型 
使 用 DrawingImage 类 型 可 以 将 几何 图 形 放 置 于 WPF 的 <Image> 控 件 中 。 例 如 : 


<Page 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 
<Image Height="100" Width="100"> 
<Image.Source> 
<DrawingImage> 
<DrawingImage.Drawing> 
<GeometryDrawing> 
<GeometryDrawing.Geometry> 
<GeometryGroup> 
<EllipseGeometry Center = "75,70" 

RadiusX = "30" RadiusY = "30" /> 
<RectangleGeometry Rect = "25,55 100 30" /> 
<LineGeometry StartPoint="0,0" EndPoint="70,30" /> 
<LineGeometry StartPoint="70,30" EndPoint="0,30" /> 

</GeometryGroup> 
</GeometryDrawing.Geometry> 


《1-- 用 来 绘制 边框 的 自 定义 画笔 --> 
<GeometryDrawing.Pen> 

<Pen Brush="Blue" Thickness="3"/> 
</GeometryDrawing.Pen> 
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<1-- 用 来 填充 内 部 的 自 定义 画 刷 --> 
<GeometryDrawing.Brush> 
<SolidColorBrush Color="0range"/> 
</GeometryDrawing.Brush> 
</GeometryDrawing> 
</DrawingImage.Drawing> 
</DrawingImage> 
</Image.Source> 
</Image> 
</Page> 


在 本 例 中 ， 我 们 的 <GeometryDrawing> 没 有 放置 在 <DrawingBrush> 里 ， 而 是 放置 在 一 个 <Dra- 
wingImage> 中 。 我 们 可 以 使 用 <DrawingImage> 来 设置 Image 控 件 的 Source 属 性 。 


29.7 “Expression Design 的 作用 


毫 无 疑问 ， 一 个 美术 设计 师 用 Visual Studio 提 供 的 工具 和 技术 创建 复杂 的 矢量 图 形 是 非常 具有 挑 
战 性 的 。 幸 运 的 是 ， 我 们 可 以 使 用 微软 Expression Design 创 建 异 常 复杂 的 图 像 数据 ， 并 导出 为 多 种 文 
件 格 式 ， 包 括 XAML。 如 果 数 据 导 出 为 XAML ， 就 可 以 很 容易 地 导出 为 WPF。 这 样 就 可 以 使 用 Visual 
Studio 对 生成 的 对 象 模型 进行 编程 。 


说 明 下 面 的 示例 应 用 程序 将 演示 如 何 将 图 像 数据 导出 为 XAML， 并 将 这 些 标记 寻 入 到 新 的 Visual 
Studio WPF 应 用 程序 中 。 但 如 果 你 没有 Expression Blend 也 不 要 担心 。 在 下 载 的 代码 文件 的 
Chapter29 文 件 夹 下 有 必要 的 bear paper.xaml 文 件 。 


29.7.1 将 示例 设计 文件 导出 为 XAML 


在 向 新 的 WPF 应 用 程序 导入 复杂 图 像 数据 之 前 , 首要 任务 是 生成 所 谓 的 图 像 数 据 。 启动 Expression 
Design。 如 果 你 具备 绘图 技能 ,可 以 为 本 例 绘制 自 定义 图 像 。 但 如 果 你 像 我 一 样 是 个 美术 设计 盲 ， 可 以 
简单 地 激活 Help 一 Samples 菜 单 选项 。 你 将 发 现 许多 不 同 的 可 加 载 的 *.design 文 件 ， 如 bear_paper.design 
( 如 图 29-16 所 示 )。 
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图 29-16 泰 迪 能 示例 图 像 


KB 
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说 明 ”Expression Design 的 介绍 超出 了 本 书 范畴 ( 坦白 地 说 , 也 超出 了 我 目前 的 能 力 )。 如 果 有 兴趣 学 习 
更 多 使 用 Design 创 建 自 定义 图 像 的 知识 ， 可 是 使 用 Help 菜 单 启动 Expression Design User Guide。 











这 时 ， 你 会 看 到 一 张 泰 迪 能 的 图 片 出 现在 Expression Design 的 设计 面板 上 。 按 下 Ctrl+A 组 合 键 选 
中 整个 图 片 ， 改 变 图 片 数 据 的 尺寸 让 其 占 满 整个 视 口 ( viewport )， 如 图 29-17 所 示 。 
f i ne 

















图 29-17 改变 泰 迪 能 图 像 的 尺寸 


在 图 像 数据 最 终 完 成 后 ， 我 们 可 以 使 用 File 一 Export... 菜 单 选项 将 其 导出 全 部 或 者 部 分 数据 。 在 
Format 列 表 框 中 可 以 看 到 很 多 流行 的 文件 格式 ， 但 对 于 本 例 来 说 ， 我 们 选择 XAML Silverlight 4/WPF 
Canvas 选 项 〈 如 图 29-18 所 示 )。 








图 29-18 ”将 泰 迪 能 示例 图 像 导 出 为 XAML 
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选择 了 正确 的 XAML 文 件 格式 之 后 ， 取 消 Always name object 选 项 。 要 记 住 当 元 素 包含 x:Name 特 性 
的 时 候 ， 就 可 以 在 代码 中 与 该 项 交互 。 但 这 个 泰 迪 能 将 使 用 大 量 XAML 元 素来 描述 。 如 果 让 工具 为 每 
个 可 能 的 对 象 命名 ， 就 会 导致 在 C# 代 码 库 中 添加 大 量 的 用 不 到 的 成 员 变量 ,( 这 也 会 增加 最 终 编译 的 
应 用 程序 的 尺寸 )。 

还 要 为 这 个 导出 的 数据 ( bear_paper.xaml ) 选择 一 个 轻易 就 能 找到 的 位 置 ( 如 Windows 桌 面 )。 其 
他 选项 都 保留 默认 值 。 准 备 就 绪 后 ， 点 击 Export All 按 钮 ， 看 ， 泰 迪 熊 图片 数据 已 经 导出 为 XAML 了 。 
这 时 可 以 关闭 Expression Design 了 。 


29.7.2 将 图 像 数 据 导入 WPF 对 象 


这 时 ， 我 们 可 以 使 用 Visual Studio 构 建 一 个 新 的 WPF 应 用 程序 ( 取 名 为 InteractiveTeddyBear )。 完 
成 之 后 ， 将 初始 窗 体 的 大 小 改 为 如 下 所 示 的 Height 和 Width， 并 删除 初始 的 Grid 控件 : 


<Window x:Class="InteractiveTeddyBear.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="MainWindow" Height="824" Width="1056"> 

</Window> 


现在 , 激活 Project Add Existing Item 菜 单 选项 , 使 用 弹出 的 对 话 框 , 导航 到 导出 的 bear paperxaml 
文件 所 在 的 位 置 。 点 击 Add 按 钮 , 会 发 现 该 XAML 文 件 已 经 添加 到 项 目 中 了 (可 以 检查 Solution Explorer 
面板 验证 这 一 点 )。 双 击 该 文件 ， 将 泰 迪 能 图像 数据 加 载 到 Visual Studio 设 计 器 上 。 

查看 bear_paper.xaml 文 件 的 Document Outline 编 辑 器 ， 会 发 现 所 有 XAML 元 素 无 一 缺席 。 我 们 的 目 
标 是 找到 能 的 左 眼 球 和 右 内 耳 ， 并 为 它们 命名 。 你 可 以 手动 找到 正确 的 对 象 ( 这 个 过 程 可 能 很 无 聊 )， 
使 用 可 视 设 计 器 简单 地 点 击 这 些 项 就 能 找到 它们 。Document Outline 编 辑 器 中 相应 的 节点 将 自动 高 亮 。 
选择 左 眼 球 ， 使 用 Properties 编 辑 器 将 该 对 象 命名 为 leftfEye。 选 中 右 耳 的 一 部 分 ( 随便 哪 一 部 分 都 行 )， 
命名 为 rightEar。 图 29-19 展 示 了 这 个 基本 过 程 。 


bear_paperxamb” XxX MainWindowxaml 





wo% - [FE] [Fm + 。 ， 
忆 Design 扩 加 XML 四 加 加 
</linearGradient8rush.i! 字 
< 人 inearGradientBrush.Gi^ 

<GradientStop Coloi 
<GradientStop Coloi™ 

</LinearGradientBrush.' 

</iinearGradientBrush> 
100% ~»* 四 


图 29-19 找 出 对 象 并 命名 
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现在 ,将 整个 XAML Canvas 复 制 到 前 切 板 上 。 这 时 可 以 关闭 bear_paper.xaml 文 件 。 将 设计 器 切换 
回 初始 窗 体 ， 将 Canvas 数 据 粘 贴 到 开放 和 闭合 的 <Window> 元 素 之 间 。 现 在 可 以 看 到 泰 迪 能 数据 显示 在 
应 用 程序 的 主 窗 体 中 。 如 果 愿 意 ， 可 以 随意 调整 图 像 在 布局 管理 器 中 的 确切 位 置 ， 只 要 左 眼 球 和 右 耳 
采 可 见 ， 就 可 以 随时 在 代码 中 与 这 些 对 象 交互 。 


29.7.3 “与 能 共和 舞 


这 时 你 就 可 以 为 leftEye 和 rightEar 对 象 处 理事 件 了 。 在 设计 器 中 选择 对 象 , 激活 Properties 窗 口 的 
Events 区 域 , 按 要 求 输入 事件 处 理 程序 的 名 称 。 在 本 例 中 , 我 们 处 理 这 两 个 对 象 的 MouseLeftButtonDown 
事件 ， 每 次 指定 一 个 方法 名 。 

下 面 这 段 简单 的 代码 将 在 点 击 鼠 标 时 改变 每 个 对 象 的 外 观 ( 如 果 你 不 愿意 输入 下 面 的 所 有 代码 ， 
可 以 简单 地 在 每 个 处 理 程序 中 添加 一 条 MessageBox.Show() 语 句 ， 并 显示 适当 的 信息 )。 


private void leftEye_MouseLeftButtonDown(object sender, 
System.Windows.Input.MouseButtonEventArgs e) 


// 在 点 击 时 改变 眼睛 的 颜色 
leftEye.Fill = new SolidColorBrush(Colors.Red); 


private void rightEar MouseLeftButtonDown(object sender, 
System.Windows.Input.MouseButtonEventArgs e) 


// 在 点 击 时 使 耳朵 变 得 模糊 

System.Windows.Media.Effects.BlurEffect blur = 
new System.Windows.Media.Effects.BlurEffect(); 

blur.Radius = 10; 

rightEar.Effect = blur; 


现在 运行 应 用 程序 。 点 击 熊 的 左 眼 和 右 耳 查看 效果 。 

现在 你 已 经 理解 了 将 Expression Design 创 建 的 复杂 图 像 数 据 导 入 到 Visual Studio 的 过 程 了 ， 更 重要 
的 是 ， 如 何在 代码 中 与 图 像 数据 交互 。 专 业 美术 设计 人 士 生成 复杂 图 像 数据 并 导出 为 XAML 的 能 力 是 
多 么 强大 。 一 旦 生成 了 图 像 数 据 ， 开 发 者 可 以 导入 标记 并 针对 对 象 模型 编写 程序 。 


源 代码 ”InteractiveTeddyBear 项 目的 源 代码 位 于 Chapter 29 子 目录 下 。 


29.8 使 用 可 视 化 层 呈 现 图 形 数据 


WPF 呈 现 图 形 的 最 后 一 种 方法 为 可 视 化 层 。 如 前 所 述 ， 该 层 只 能 通过 代码 访问 〈 它 不 是 XAML 友 
好 的 )。 绝 大 多 数 WPF 应 用 程序 使 用 了 形状 和 几何 图 形 ， 它 们 都 能 运转 良好 。 而 可 视 化 层 则 提供 了 最 
快 的 方式 来 呈现 大 量 的 图 形 数据 。 奇 妙 的 是 ,这 个 非常 底层 的 图 形 层 在 向 较 大 的 区 域 呈现 单个 图 像 时 
也 是 非常 有 用 的 。 例 如 ， 如 果 你 需要 用 一 个 静态 图 像 来 填充 窗 体 的 背景 ， 可 视 化 层 提供 了 最 快速 的 方 
式 ， 或 者 如 果 你 希望 基于 用 户 输入 之 类 的 方式 来 快速 切换 窗 体 背 景 ， 可 视 化 层 也 是 十 分 有 用 的 。 

我 们 不 会 花 太 多 时 间 来 研究 可 视 化 层 的 详细 内 容 ， 我 们 只 建立 一 个 很 小 的 示例 来 演示 基本 信息 。 








29.8 ”使 用 可 视 化 层 呈 现 图 形 数据 1023 


1. Visual 基 类 和 派生 类 

抽象 的 System.Windows.Media.Visual 类 型 只 提供 了 用 于 呈现 图 像 的 部 分 服务 ( 如 呈现 、 命 中 测试 、 
变换 ), 而 没有 提供 其 他 可 以 让 代码 膨胀 的 非 可 视 化 服务 ( 如 输入 事件 、 布 局 服务 、 样 式 和 数据 绑 定 )。 
注意 如 图 29-20 所 示 的 Visual 类 型 的 简单 继承 链 。 
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图 29-20 Visual 类 型 提供 了 基本 的 命中 测试 、 坐 标 变换 和 边界 框 计算 


由 于 Visual 是 抽象 基 类 ， 因 此 我 们 需要 使 用 它 的 派生 类 来 执行 实际 的 呈现 操作 。WPF 提 供 了 几 个 
子 类 ， 如 DrawingVisual、Viewport3DVisual 和 ContainerVisual。 

在 本 例 中 ,我们 只 关注 DrawingVisual， 它 是 一 个 轻 量 级 的 绘图 类 ， 可 以 用 来 呈现 形状 、 图 像 或 
文本 。 

2. DrawingVisual 类 概览 

要 使 用 DrawingVisual 在 平面 上 呈现 数据 ， 需 要 执行 以 下 基本 步骤 : 

口 从 DrawingVisual 中 获取 DrawingContext 对 象 ; 

口 使 用 DrawingContext 呈 现 图形 数 据 。 

这 是 将 数据 呈现 到 平面 所 需要 的 最 基本 的 两 个 步骤 。 但 是 ， 如 果 你 希望 被 呈现 的 图 形 数据 能 够 响 
应 命中 测试 计算 (这 对 添加 用 户 交互 功能 来 说 是 非常 重要 的 )， 你 需要 执行 以 下 额外 的 步骤 : 

口 更 新 你 所 呈现 的 容器 中 的 逻辑 树 和 可 视 化 树 ; 

口 重 写 FrameworkElement 类 中 的 两 个 虚 方法 ， 人 允许 容器 获取 你 创建 的 可 视 化 数据 。 

我 们 来 稍微 讨论 一 下 最 后 这 两 个 步 又。 首先 ， 为 了 演示 如 何 使 用 Drawingvisual 类 呈现 2D 数 据 ， 
使 用 Visual Studio 新 建 一 个 WPF 应 用 程序 RenderingWithVisuals。 我 们 的 首要 目标 是 使 用 DrawingVisual 
为 WPF Image 控 件 动 态 设置 数据 。 将 窗 体 的 XAML 修 改 为 如 下 形式 : 


<Window x:Class="RenderingWithVisuals .MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title=" Fun with the Visual Layer" Height="350" Width="525" 





1 
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Loaded="Window Loaded" WindowStartupLocation="CenterScTeen > 
<StackPanel Background="AliceBlue" Name="myStackPanel"> 
<Image Name="myImage" Height="80"/> 
</StackPanel> 
</Window> 


注意 cImage> 控 件 没有 Source 值 ， 我 们 将 在 运行 时 进行 设置 。 我 们 还 指定 了 窗 体 的 Loaded 事 件 ,将 
使 用 DrawingBrush 对 象 在 内 存 中 构建 图 形 数据 。Loaded 事 件 处 理 程序 的 实现 如 下 所 示 : 


private void Window Loaded(object sender, RoutedEventArgs e) 


{ 


const int TextFontSize = 30; 


// 创建 一 个 System.Windows .Media.FormattedText 对 象 

FormattedText text = new FormattedText("Hello Visual Layer!", 
new System.Globalization.CultureInfo("en-us"), 
FlowDirection.LeftToRight, 
new Typeface(this.FontFamily, FontStyles.Italic, 

FontWeights.DemiBold, FontStretches.UltraExpanded), 

TextFontSize, 
Brushes .Green); 


// 创建 一 个 DrawingVisual， 并 获取 DrawingContext 
DrawingVisual drawingVisual = new DrawingVisual(); 
using(DrawingContext drawingContext = drawingVisual.RenderOpen()) 


// 现在 ， 调 用 DrawingContext 中 的 方法 来 呈现 数据 

drawingContext.DrawRoundedRectangle(Brushes.Yellow, new Pen(Brushes.Black，5)， 
new Rect(5, 5, 450, 100), 20, 20); 

drawingContext.DrawText(text, new Point(20, 20)); 


// 使 用 DrawingVisual 中 的 数据 动态 创建 位 图 

RenderTargetBitmap bmp = new RenderTargetBitmap(500, 100, 100, 90, 
PixelFormats.Pbgra32); 

bmp.Render(drawingVisual); 


// 设置 Image 控 件 的 源 
myImage.Source = bmp; 


} 

这 段 代 码 引 入 了 一 些 新 的 WPF 类 ， 我 将 进行 简要 的 介绍 ( 如 果 感 兴趣 ， 可 以 查看 .NET 
Framework 4.5 SDK 文 档 )。 方 法 的 开始 部 分 创建 了 一 个 FormattedText 对 象 ， 用 来 表示 我 们 构建 的 
内 存 图 像 的 文本 部 分 。 如 你 所 见 , 该 构造 函数 可 以 指定 很 多 特性 ， 如 字体 大 小 、 字 体 族群 、 前 景 颜 
色 和 文本 本 身 。 

接 下 来 ,我们 调用 DrawingVisual 实 例 的 Render0pen() 方 法 来 获取 必需 的 DrawingContext 对 象 。 在 
这 里 , 我 们 在 DrawingVisual 中 呈现 了 一 个 纯色 的 圆 角 矩形， 以 及 之 前 创建 的 格式 化 文本 。 我 们 通过 硬 
编码 的 方式 将 这 两 个 图 形 数据 添加 到 Drawingvisual 中 , 这 在 生产 中 不 见得 是 个 好 主意 , 但 对 于 我 们 的 
测试 来 说 是 无 关 紧 要 的 。 


说 明 在 .NET Framework 4.5 SDK 文 档 中 查看 DrawingContext 类 的 所 有 呈现 成 员 。 如 果 你 过 去 使 用 过 
Windows Forms 图 形 对 象 ，DrawingContext 看 起 来 会 非常 眼熟 。 
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最 后 的 几 条 语句 将 DrawingVisual 映 射 到 RenderTragetBitmap 对 象 ， 后 者 位 于 System. Window.Media. 
Imaging 命 名 空间 ， 可 将 一 个 可 视 化 对 象 转换 为 内 存 中 的 位 图 。 然 后 ， 我 们 设置 Image 控 件 的 Source 属 
性 ， 输 出 结果 如 图 29-21 所 示 。 


a Fun with the Visual Layer 





图 29-21 使 用 可 视 化 层 呈 现 内 存 中 的 位 图 


说 明 System.Windows.Media.Imaging 命 名 空间 包含 许多 额外 的 编码 类 ， 可 以 将 内 存 中 的 Render- 
TargetBitmap 对 象 保存 为 不 同 格式 的 物理 文件 。 更 详细 的 内 容 可 以 查阅 ]pegBitmapEncoder 类 
(或 其 他 编码 类 )。 


3. 在 自 定义 布局 管理 器 中 呈现 可 视 化 数据 

尽管 使 用 DrawingVisual 绘 制 WPF 控 件 的 背景 很 有 趣 , 但 更 常见 的 场景 是 构建 自 定 义 的 布局 管理 器 
( 如 Grid、StackPanel、Canvas 等 )， 其 内 容 由 可 视 化 层 呈 现 。 如 果 你 创建 了 这 样 的 自 定义 布局 管理 器 ， 
可 以 将 其 放 到 普通 的 Window ( Page 或 UserControl ) 中 ,使 UI 的 某 个 部 分 使 用 高 度 优化 的 呈现 代理 ， 而 
宿主 窗 体 的 非 关键 部 分 使 用 形状 和 绘图 呈现 剩余 的 图 形 数据 。 

如 果 你 不 需要 布局 管理 器 的 其 余 功能 ， 可 以 选择 简单 地 扩展 FrameworkElement， 它 仅 包含 使 用 可 
视 化 项 必需 的 基础 设施 。 为 了 演示 这 些 ， 我 们 在 项 目 中 新 建 CustomvisualFrameworkElement 类 ， 从 
FrameworkElement 扩 展 该 类 并 导入 System.Windows、System.Windows .Input 和 System.Windows .Media 命 名 
空间 。 

该 类 将 维护 一 个 VisualCollection 类 型 的 成 员 变 量 , 它 包 含 两 个 固定 的 DrawingVisual 对 象 .( 当然 ， 
你 可 以 通过 鼠标 操作 为 该 集合 添加 新 的 成 员 ， 但 本 例 我 们 尽 可 能 地 保持 简单 。) 其 代码 如 下 所 示 : 

class CustomVisualFrameworkElement : FrameworkElement 


// 我 们 所 创建 的 所 有 可 视 化 对 象 的 集合 


VisualCollection theVisuals; 
public CustomVisualFrameworkElement() 


// 使 用 若干 DrawingVisual 对 象 填充 VisualCollection 
// 构造 函数 的 参数 表示 这 些 可 视 化 对 象 的 拥有 者 
theVisuals = new VisualCollection(this); 
theVisuals.Add(AddRect()); 
theVisuals.Add(AddCircle()); 


} 
private Visual AddCircle() 
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DrawingVisual drawingVisual = new DrawingVisual(); 


// 获取 DrawingContext， 创 建新 的 绘图 内 容 
using (DrawingContext drawingContext = drawingVisual.RenderOpen()) 


// 创建 一 个 圆 图， 并 在 DrawingContext 中 进行 绘制 
Rect rect = new Rect(new Point(160, 100), new Size(320, 80)); 
drawingContext.DrawEllipse(Brushes.DarkBlue, null, new Point(70, 90), 40, 50); 


} 


return drawingVisual; 


private Visual AddRect() 
{ 


DrawingVisual drawingVisual = new DrawingVisual(); 
using (DrawingContext drawingContext = drawingVisual.RenderOpen()) 


Rect rect = new Rect(new Point(160, 100), new Size(320, 80)); 
drawingContext.DrawRectangle(Brushes.Tomato, null, rect); 


return drawingVisual; 


} 

现在 ， 在 将 自 定义 的 FrameworkElement 应 用 于 窗 体 之 前 ， 我 们 必须 重 写 前 面 提 到 的 两 个 关键 的 虚 
方法 ,它们 都 将 在 呈现 过 程 中 由 WPF 在 内 部 进行 调用 。GetVisualChild() 方 法 返回 子 元 素 集合 中 指定 
索引 的 元 素 。 只 读 的 VisualChildrenCount 属 性 返回 该 可 视 化 集合 中 可 视 化 子 元 素 的 数量 。 这 两 个 方法 
实现 起 来 都 非常 简单 ， 因 为 我 们 可 以 将 实际 的 工作 委托 给 VisualCollection 成 员 变量 : 


protected override int VisualChildrenCount 


get { return theVisuals.Count; } 


protected override Visual GetVisualChild(int index) 


// 参数 值 必须 大 于 0， 并 且 要 做 完整 性 检查 
if (index < 0 || index >= theVisuals.Count) 


throw new ArgumentOutOfRangeException(); 
} 


return theVisuals[index]; 


我 们 只 包含 了 测试 自 定义 类 的 最 少 功能 。 更 新 Window 的 XAML 描 述 ， 在 StackPanel 中 添加 一 个 
CustomVisualFrameworkElement 对 象 。 这 需要 你 创建 一 个 自 定义 的 XML 命 名 空间 来 映射 .NET 命 名 空间 
(参见 第 28 章 )。 


<Window x:Class="RenderingWithVisuals.MainWindow" 

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:custom="clr-namespace:RenderingWithVisuals" 
Title="Fun with the Visual Layer" Height="350" Width="525" 
Loaded="Window Loaded" WindowStartupLocation="CenterScreen"> 

<StackPanel Background="AliceBlue" Name="myStackPanel"> 

<Image Name="myImage" Height="80"/> 
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<custom:CustomVisualFrameworkElement/> 
</StackPanel> 
</Window> 


如 果 一 切 正常 ， 运 行程 序 将 看 到 如 图 29-22 所 示 的 界面 。 





避 
站 ”Fun with the Visual Layer 


Hello Visual Layer! 


\ 一 一 | 
图 29-22 ”使 用 可 视 化 层 在 自 定义 的 FrameworkElement 中 呈现 数据 

4. 响应 命中 测试 操作 

由 于 DrawingVisual 不 包含 UIElement 和 FrameworkElement 的 任何 基础 结构 ,因此 你 需要 手工 编写 程 
序 来 添加 计算 命中 测试 操作 的 功能 。 幸 运 的 是 ， 逻 辑 和 可 视 化 树 的 概念 使 得 在 可 视 化 层 进行 这 些 操作 
变 得 十 分 简单 。 事 实证 明 ， 当 你 编写 XAML 时 ， 你 实质 上 就 是 在 构建 一 个 元 素 的 逻辑 树 。 然 而 每 个 逻 
辑 树 的 背后 都 有 一 个 描述 更 加 丰富 的 可 视 化 树 ， 它 也 包含 低级 别 的 呈现 指令 。 

第 31 章 将 深入 研究 这 些 树 的 细节 ,不 过 现在 我 们 仅 需要 了 解 ， 只 有 当 你 向 这 些 数据 结构 注册 自 定 
义 的 可 视 化 对 象 后 ， 才 能 执行 命中 测试 操作 。 幸 而 ，VisualCollection 容 器 已 经 为 我 们 做 好 了 这 一 切 。 
(这 也 解释 了 为 什么 我 们 需要 将 自 定义 的 FrameworkElement 作 为 VisualCollection 构 造 函数 的 参数 。) 

首先 ， 更 新 CustomVisualFrameworkElement 类 ， 在 构造 函数 中 使 用 标准 C 术 香 法 添加 MouseDown 事 件 
处 理 程序 ， 如 下 所 示 : 

this.MouseDown += MyVisualHost MouseDown; 

该 事件 处 理 程序 的 实现 将 调用 VisualTreeHelper.HitTest() 方 法 ,检查 鼠标 是 否 在 所 呈现 的 可 视 化 
对 象 的 边界 之 内 。 我 们 需要 为 HitTest() 指 定 一 个 HitTestResultCallback 委 托 作 为 参数 来 执行 这 个 计 
算 。 如 果 单 击 了 可 视 化 对 象 ， 我们 将 在 它 的 原始 呈现 和 扭曲 呈现 两 者 之 间 进 行 切 换 。 为 
CustomVisualFrameworkElement 类 添加 如 下 的 方法 : 


void MyVisualHost MouseDown(object sender, MouseButtonEventArgs e) 


























// 找到 用 户 单 击 的 位 置 
Point pt = e.GetpPosition((UIElement)sender); 


// 通过 委托 来 调用 辅助 方法 ， 检 查 是 否 单 击 了 可 视 化 对 象 
VisualTreeHelper.HitTest(this, null, 
new HitTestResultCallback(myCallback), new PointHitTestParameters(pt)); 
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} 
public HitTestResultBehavior myCallback(HitTestResult result) 


// 如 果 单 击 了 可 视 化 对 象 ， 则 在 其 原始 呈现 和 捏 曲 呈 现 之 间 进 行 切 换 
if (result.VisualHit.GetType() == typeof(DrawingVisual)) 


if (((DrawingVisual)result.VisualHit).Transform == null) 
((DrawingVisual)result.VisualHit).Transform = new SkewTransform(7, 7); 
else 
((DrawingVisual)result.VisualHit).Transform = null; 
} 
// 告诉 HitTest() 停 止 深入 可 视 化 树 


return HitTestResultBehavior.Stop; 


再 次 运行 程序 ， 现 在 可 以 单 击 所 呈现 的 可 视 化 对 象 并 看 到 它 的 变换 行为 。 这 只 是 关于 WPF 可 视 化 
层 非 常 简 单 的 一 个 示例 ， 你 还 可 以 在 XAML 中 使 用 同样 的 画笔 、 画 刷 、 图 形变 换 、 布 局 管理 需 等 。 这 
样 ， 你 就 已 经 对 如 何 使 用 Visual 派 生 类 有 了 相当 多 的 了 解 。 


源 代码 ”RenderingWithVisuals 项 目的 源 代码 位 于 Chapter 29 子 目录 下 。 





这 就 是 我 们 要 介绍 的 WPF 图 形 呈 现 服务 的 所 有 内 容 。 尽 管 我 们 涵盖 了 很 多 有 趣 的 话题 ， 但 实际 上 
只 涉及 了 WPF 图 形 功 能 的 皮毛 。 我 将 深入 研究 形状 、 绘 图 、 画 刷 、 图 形变 换 和 可 视 化 等 话题 的 事情 留 
给 读者 。( 当然 ， 可 以 肯定 的 是 ， 你 将 在 其 余 WPF 章 节 中 看 到 这 些 话 题 的 更 多 细节 。) 


29.9 小 结 


由 于 WPF 是 一 个 图 形 密集 的 GUI API， 因 此 自然 而 然 地 提供 了 多 种 呈现 图 形 输 出 的 方式 。 本 章 开 
头 分 别 介绍 了 3 种 WPF 应 用 程序 呈现 图 形 的 方式 ( 形状、 绘图 和 可 视 化 ), 接着 讨论 了 不 同 的 呈现 基 元 ， 
如 画 刷 、 画 笔 和 图 形变 换 。 

在 构建 交互 式 的 2D 呈 现时 , 形状 是 最 简单 的 方法 。 但 对 于 静态 的 、 非 交互 式 的 呈现 来 说 , 使 用 绘 
图 和 几何 图 形 则 是 最 佳 的 方式 ， 而 可 视 化 层 (只 能 用 代码 访问 ) 提供 了 更 多 的 控制 和 更 优 的 性 能 。 











章 介绍 三 个 重要 的 (也 是 互相 关联 的 ) 话题 , 它们 将 加 深 你 对 WPF API 的 理解 。 首 先 要 学 习 

的 是 逻辑 资源 的 作用 。 稍 后 你 会 看 到 ， 逻辑 资源 ( 也 称 为 对 象 资源 ) 系统 是 一 种 在 WPF 应 用 
程序 中 对 常用 对 象 进行 命名 和 引用 的 方式 。 逻 辑 资源 常常 存在 于 XAML 中 ， 不 过 它们 也 可 以 定义 在 程 
序 代码 中 。 

接 下 来 你 将 学 习 如 何 定义 、 执 行 和 控制 一 个 动画 序列 。 也 许 会 出 乎 你 的 意料 ，WPF 动 画 可 不 仅 局 
限于 视频 游戏 和 多 媒体 应 用 。 在 WPF API 下 ， 动 画 可 以 使 按钮 在 被 单 击 后 神奇 地 发 光 ， 或 使 DataGrid 
的 选中 行 变 得 很 大 。 理 解 动画 是 构建 自 定义 控制 模板 ( 将 在 第 31 章 中 介绍 ) 的 关键 。 

最 后 我 们 将 探索 WPF 样 式 的 作用 。WPF 应 用 程序 可 以 为 控件 定义 通用 的 外 观 和 体验 , 这 与 网 页 中 
使 用 CSS 或 ASPNET 主 题 引擎 非常 类 似 。 你 可 以 将 这 些 样式 定义 在 标记 中 ， 并 保存 为 对 象 资 源 供 以 后 
使 用 ， 也 可 以 在 运行 时 动态 地 加 载 它们 。 


30.1 理解 WPF 资源 系统 


我 们 的 第 一 个 任务 是 研究 退 入 和 访问 应 用 程序 资源 这 个 话题 。WPF 支 持 两 种 风格 的 资源 。 第 一 种 
是 二 进 制 资源 (binary resource )， 这 也 是 大 多 数 程序 员 在 传统 意义 上 所 理解 的 那 种 资源 ( 如 内 柑 的 图 
像 文 件 或 声音 片段 、 应 用 程序 图 标 ， 等 等 )。 

第 二 种 称 为 对 象 资源 (objectresource ) 或 逻辑 资源 ( logical resource )， 它 表示 一 个 命名 的 .NET 对 
象 ， 可 以 打包 并 在 整个 应 用 程序 中 进行 复 用 。 由 于 所 有 NET 对 象 都 可 以 打包 为 对 象 资源 ， 因 此 你 可 以 
定义 通用 的 图 像 基 元 (如 画 刷 、 画 笔 、 动 画 等 )， 并 在 需要 时 进行 引用 ， 这 在 处 理 各 种 图 形 数据 时 是 
非常 有 帮助 的 。 
使 用 二 进 制 资源 

在 展开 对 象 资源 的 话题 之 前 ， 我 们 先 来 快速 学 习 一 下 如 何 打包 诸如 图 标 或 图 像 文件 ( 如 公司 logo 
或 动画 中 的 图 片 ) 这 种 二 进 制 资源 。 用 Visual Studio 创 建 一 个 新 的 WPF 应 用 程序 BinaryResourcesApp。 
修改 初始 的 窗 体 标记 ， 用 DockPanel 作 为 根 布局 : 


<Window x:Class="BinaryResourcesApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Binary Resources" Height="500" Width="649"> 


<DockPanel LastChildFill="True"> 
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</DockPanel> 


</Window> 

现在 ,假设 你 的 应 用 程序 会 根据 用 户 的 输入 显示 窗 体内 部 三 个 图 像 文 件 中 的 一 个 。WPF Image 控 
ai operetta (*.bmp、*.gif、*.ico 、*.jpg、*.png、*.wdp 和 *.tiff)， 还 可 以 显示 
DrawingImage 中 的 数据 ( 参见 第 29 章 )。 我 们 来 为 窗 体 建立 一 个 UI[， 其 DockPanel 中 有 一 个 工具 条 ， 工 
具 条 包含 Next 和 Previous 按 钮 。 在 工具 条 下 方 放 置 一 个 Image 控 件 ， 目 前 没有 设置 其 Source 属 性 的 值 ， 
因为 我 们 要 在 代码 中 进行 操作 : 


<Window x:Class="BinaryResourcesApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Binary Resources" Height="500" Width="649"> 


<DockPanel LastChildFill="True"> 
<ToolBar Height="60" Name="picturePickerToolbar" DockPanel.Dock="Top"> 
<Button x:Name="btnPreviousImage" Height="40" Width="100" BorderBrush="Black" 
Margin="5" Content="Previous" Click="btnpreviousImage Click"/> 
<Button x:Name="btnNextImage" Height="40" Width="100" BorderBrush="Black" 
Margin="5" Content="Next" Click="btnNextImage Click"/> 
</ToolBar> 


《<1-- 我 们 将 在 代码 中 填充 Image --> 
<Border BorderThickness="2" BorderBrush="Green"> 
<Image x:Name="imageHolder" Stretch="Fill" /> 
</Border> 
</DockPanel> 


</Window> 


注意 ， 每 个 Button 对 象 都 对 Click 事 件 进 行 了 处 理 。 假 设 已 经 使 用 IDE 处 理 了 这 些 事件 ， 那 么 你 将 
在 C# 代 码 中 得 到 两 个 空 方法 。 那 么 ， 我 们 如 何 编写 Click 事 件 处 理 程序 来 循环 图 像 数 据 呢 7 更 重要 的 
是 ,我 们 是 希望 图 像 数 据 位 于 用 户 硬盘 还 是 租 入 到 编译 的 程序 集中 ?让 我 们 来 看 看 我 们 的 选择 。 

1. 在 项 目 中 使 用 松散 的 资源 文件 

假设 你 希望 将 图 像 作为 松散 文件 发 布 在 应 用 程序 安装 路 径 的 某 个 子 目录 中 。 在 Visual Studio 的 
Solution Explorer 窗 体 中 ， 右 击 项 目 节 点 并 选择 Add 一 New Folder 菜 单 选 项 创建 一 个 子 目录 Images。 

现在 , 右 击 该 文件 来 ， 选 择 Add 一 Existing Item 菜 单 选项 ,将 图 像 文 件 复制 到 子 目 录 中 。 在 本 项 目 
的 可 下 载 源 代码 中 ， 你 会 发 现 3 个 图 像 文 件 Welcome.jpg、Dogs.jpg 和 Deerjpg。 你 可 以 将 它们 添加 到 项 
目 中 ， 也 可 以 自行 选择 3 个 图 像 文件 。 图 30-1 显 示 了 当前 的 设置 。 


OUTON DDLORER ee 
i tH sieo 
Saar Fire 
5 Solution BinaryResourcesApP ( project) 
scesApp 





图 30-1 WPF 项 目 中 包含 图 像 数据 的 子 目 录 
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2. 配置 松散 资源 

当 使 用 Visual Studio 向 输出 目录 复制 项 目 内 容 时 ， 你 需要 在 Properties 窗 体 中 调整 一 些 设置 。 要 确 
保 \Images 文 件 夹 下 的 内 容 全 部 复制 到 \bin\Debug 目 录 下 ， 首 先 选择 Solution Explorer 中 的 所 有 文件 。 然 
后 ， 在 Properties 窗 体 中 ， 将 Build Action 属 性 设置 为 Resource， 将 Copy to Output Directory 属 性 设置 为 
Copy always (如 图 30-2 所 示 )。 


2 PROPERTIES CPT 二 全 | 


aa 
Copy to Output Directory 


Custom Tool 
Custom Tool Namespace 
File Name 





How the file relates to the build and deployment processes. 





图 30-2 设置 图 像 数 据 使 其 能 够 复制 到 输出 目录 中 


重新 编译 程序 ， 单 击 Solution Explorer 中 的 Show all Files 按 钮 ， 查 看 \bin\Debug 目 录 下 的 Image 文 件 
夹 ( 可 能 需要 单 击 刷新 按钮 )。 如 图 30-3 所 示 。 


名 时 # 有 天国 @| 甸 
Search Solution Explorer (Ctrls7) 
图 Solution 'BinaryResourcesApp' (1 project} 
4 BinaryResourcesApp 
b 
> 


BinayResourcesApp.exe 

[3 BinaryResourcesApp.pdb 

1 BinaryResourcesApp.vshost.exe 

党 BinaryResourcesApp.vshost.exe.manifest 


MD MainWindow.xaml 





SOLUTION EXPLORER TEAM EXPLORER 


图 30-3 复制 的 数据 
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3. 加 载 图 像 

WPF 提 供 了 一 个 BitmapImage 类 ， 位 于 System.Windows.Media.Imaging 命 名 空间 下 。 它 可 以 加 载 一 
个 位 置 由 System.Uri 对 象 表示 的 图 像 文件 的 数据 。 你 可 以 向 下 面 这 样 在 窗 体 的 Loaded 事 件 处 理 程序 中 
填充 BitmapImage 类 型 的 List<Ty> : 

public partial class MainWindow : Window 


// BitmapImage 文 件 的 列表 
List<BitmapImage> images = new List<BitmapImage>(); 


// 列表 的 当前 位 置 
private int currImage = 0; 
private const int MAX IMAGES = 2; 


private void Window Loaded(object sender, RoutedEventArgs e) 


try 
{ 


string path = Environment.CurrentDirectory; 


// 在 窗 体 加 载 时 加 载 图 像 

images.Add(new BitmapImage(new Uri(string.Format(@"{0}\Images\Deer.jpg", path)))); 
images.Add(new BitmapImage(new Uri(string.Format(@"{0}\Images\Dogs.jpg", path)))); 
images.Add(new BitmapImage(new Uri(string.Format(@"{0}\Images\Welcome.jpg", path)))); 


// 显示 列表 中 的 第 一 幅 图 像 


imageHolder.Source = images[currImage]; 
catch (Exception ex) 


MessageBox.Show(ex.Message); 


} 

注意 该 类 还 定义 了 一 个 int 成 员 变量 ( currImage )， 它 支持 Click 事 件 处 理 程序 遍历 List<T> 中 的 各 
项 ， 并 将 其 赋值 给 Image 控 件 的 Source 属 性 进行 显示 。( 在 这 里 ，Loaded 事 件 处 理 程序 将 Source 属 性 的 
值 设置 为 List<T> 中 的 第 一 幅 图 像 。) 此 外 ，MAX_IMAGES 常 量 可 以 在 迭代 列表 时 检查 其 上 下 限 。Cclick 事 
件 处 理 程序 如 下 所 示 : 


private void btnPreviousImage_Click(object sender, RoutedEventArgs e) 


if (--currImage < 0) 
currImage = MAX_IMAGES; 
imageHolder.Source = images[currImage]; 


} 
private void btnNextImage Click(object sender, RoutedEventArgs e) 
if (++currImage > MAX _ IMAGES) 


currImage = 0; 
imageHolder. Source = images[currImage]; 


= 一 


运行 程序 ， 就 可 以 翻阅 每 张 图 片 了 。 
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4. 内 内 应 用 程序 资源 

如 果 你 希望 将 图 像 文件 作为 二 进 制 资源 直接 编译 到 .NET 程 序 集中 , 需要 在 Solution Explorer 中 选择 
图 像 文件 ( 在 \Images 目 录 下 , 而 非 \bin\Debug\mages 目 录 )。 然后 将 Build Action 属 性 改 为 Resource 、Copy 
to Output Directory 属 性 改 为 Do not copy ( 如 图 30-4 所 示 )。 


， ， 。 Resource 
-Copy to Output Directory Do not copy 


Custom Tool 


Custom Tool Namespace 
~ File Name 
Full Path 





Build Action 
How the file relates to the build and deployment processes. 








图 30-4 ”将 图 像 配置 为 内 嵌 资 源 


现在 打开 Visual Studio 的 Build 菜 单 ， 选 择 Clean Solution 选 项 清空 \bin\Debug\Images 下 的 当前 内 容 ， 
然后 重新 编译 项 目 。 刷新 Solution Explorer， 观 察 \bin\Debug 目 录 下 是 否 还 存在 Images 子 目录 。 使 用 当前 的 
生成 选项 ， 图 像 数 据 将 不 会 复制 到 输出 目录 ， 而 是 内 榜 到 程序 集中 。 
这 样 调整 之 后 ， 我 们 需要 修改 代码 ， 提 取 编 译 到 程序 集中 的 图 像 进行 加 载 : 
private void Window Loaded(object sender, RoutedEventArgs e) 
try 
images.Add(new BitmapImage(new Uri(@"/Images/Deer.jpg", Urikind.Relative))); 
images.Add(new BitmapImage(new Uri(@"/Images/Dogs.jpg", UriKind.Relative))); 


images.Add(new BitmapImage(new Uri(@"/Images/Welcome.jpg", Urikind.Relative))); 
imageHolder.Source = images[currImage]; 


catch (Exception ex) 
MessageBox.Show(ex.Message); 
} 


注意 , 在 本 例 中 我 们 不 再 需要 指定 安装 路 径 , 只 需要 简单 地 列 出 资源 名 称 及 其 所 在 子 目录 的 名 称 。 
此 外 ， 在 创建 Uri 对 象 时 ， 我 们 还 将 Urikind 指 定 为 Relative。 这 样 ， 无 论 在 什么 情况 下 我 们 的 可 执行 
文件 都 是 一 个 独立 的 实体 ， 可 以 在 电脑 的 任何 路 径 上 运行 ， 因 为 所 有 的 编译 数据 都 已 经 存在 于 二 进 制 
文件 中 。 图 30-5 显 示 了 完整 的 应 用 程序 。 
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图 30-5 ”简单 的 图 片 查看 器 


源 代码 “BinaryResourcesApp 的 源 代码 位 于 Chapter 30 子 目录 下 。 


30.2 ”使 用 对 象 ( 有 逻辑 ) 资源 


在 构建 WPF 应 用 时 ， 我们 常常 定义 一 段 XAML, 将 其 用 于 一 个 窗 体 的 多 个 位 置 ,或 横 跨 多 个 窗 体 
或 项 目 。 例如， 假设 你 正在 使 用 Expression Blend 创 建 完 美的 线性 渐变 画 刷 ， 包 含 10 行 标记 。 现 在 你 希 
望 将 该 画 刷 作为 项 目 中 所 有 Button 的 背景 ， 该 项 目 包含 8 个 窗 体 ，16 个 Button。 

将 XAML 复 制 粘贴 到 每 个 控件 是 最 糟糕 的 做 法 。 在 你 需要 调整 画 刷 的 外 观 时 , 这 无 疑 将 是 一 场 疆 梦 。 

谢 天 谢 地 ， 对 象 资源 可 以 定义 一 小 段 命名 的 XAML， 并 将 其 保存 在 合适 的 字典 中 供 以 后 使 用 。 与 
二 进 制 资源 类 似 ， 对 象 资源 通常 都 编译 到 需要 它们 的 程序 集中 。 不 过 你 不 需要 修改 Build Action 属 性 。 
我 们 只 需 将 XAML 放 置 到 正确 的 位 置 ， 编 译 器 将 完成 剩 下 的 工作 

使 用 对 象 资源 是 WPF 开 发 的 重要 部 分 。 正 如 你 将 看 到 的 那样 , 对 象 资源 比 自 定义 画 刷 要 复杂 得 多 。 
你 可 以 定义 基于 XAML 的 动画 、3D 呈 现 、 自 定义 控件 样式 、 数 据 模板 、 控 件 模板 ， 等 等 ， 并 将 它们 统 
统 打包 成 可 重用 的 资源 。 


30.2.1 Resources 属 性 的 作用 


如 前 所 述 ， 要 在 应 用 程序 中 使 用 对 象 资源 ， 必 须 将 它们 放置 在 合适 的 字典 对 象 中 。 每 个 Frame- 
workElement 派 生 类 都 包含 一 个 Resources 属 性 ， 它 封装 了 一 个 ResourceDictionary 对 象 ， 用 来 保存 定义 
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的 对 象 资源 。 由 于 ResourceDictionary 基 于 System.0bject 类 型 并 且 可 由 XAML 或 程序 代码 进行 操作 ， 
因此 可 以 保存 任何 类 型 。 

在 WPF 中 ， 所 有 控件 、Window、Page (在 创建 导航 应 用 或 XBAP 程 序 时 使 用 ) 和 UserControl 都 扩 
展 了 FrameworkElement， 因 此 所 有 部 件 都 可 以 访问 ResourceDictionary。 此 外 ， 尽管 Application 类 未 继 
承 FrameworkElement， 但 它 也 支持 一 个 同名 的 Resources 属 性 并 且 作用 也 相同 。 


30.2.2 ”定义 窗口 级 别 的 资源 


在 开始 探索 对 象 资 源 的 作用 之 前 ， 先 使 用 Visual Studio 新 建 一 个 WPF 应 用 程序 ObjectResources- 
App, 并 将 初始 的 Grid 修改 为 水 平 对 齐 的 StatckpPanel 布 局 管理 器 。 在 这 个 Stackpanel 中 定义 两 个 Button 
控件 (我们 不 需要 太 多 的 东西 来 演示 对 象 资源 的 作用 ， 这 些 就 足够 了 ): 


<Window x:Class="0bjectResourcesApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Object Resources" Height="350" Width="525"> 


<StackPanel Orientation="Horizontal"> 
<Button Margin="25" Height="200" Width="200" Content="OK" FontSize="20"/> 
<Button Margin="25" Height="200" Width="200" Content="Cancel" FontSize="20"/> 
</StackPanel> 


</Window> 
现在 , 使 用 集成 的 画 刷 编辑 器 ( 在 第 29 章 中 讨论 过 ) 将 OK 按钮 的 Background 颜 色 属 性 设置 为 自 定 
义 的 画 刷 类 型 。 注 意 画 刷 是 如 何 垦 入 到 <Button> 和 </Button> 标 签 作用 域内 的 : 


<Button Margin="25" Height="200" Width="200" Content="OK" FontSize="20"> 
<Button.Background> 
<RadialGradientBrush> 
<GradientStop Color="#FFC44EC4" Offset="0" /> 
<GradientStop Color="#FF829CEB" Offset="1" /> 
<GradientStop Color="#FF793879" Offset="0.669" /> 
</RadialGradientBrush> 
</Button.Background> 
</Button> 


要 想 让 Cancel 按 钮 也 能 使 用 该 画 刷 ， 我 们 需要 将 cRadialGradientBrush> 的 作用 域 扩大 到 父 元 素 的 
资源 字典 中 。 例 如 ,将 其 移动 到 <StatckPanel> 中 ， 由 于 两 个 按钮 都 位 于 该 布局 管理 器 中 ， 因 此 可 以 使 
用 同样 的 画 刷 。 我 们 甚至 可 以 将 画 刷 打包 到 window 本 身 的 资源 字典 中 ， 这 样 窗 体内 容 中 ( 如 内 租 的 面 
板 ) 的 所 有 部 分 都 可 以 随意 使 用 。 

在 定义 资源 时 ,可 以 使 用 属性 元 素 语法 设置 Resources 属 性 。 你 还 需要 给 资源 项 设置 一 个 x:Key 值 ， 
当 窗 体 的 其 他 部 分 希望 引用 该 对 象 资源 时 ， 可 以 使 用 它 。 要 注意 x:Key 和 x:Name 是 不 同 的 ! x:Name 特 性 
可 以 将 对 象 作 为 代码 文件 中 的 成 员 变 量 进行 访问 ， 而 x:Key 特 性 用 来 引用 资源 字典 中 的 某 项 。 

Visual Studio 和 Expression Blend 都 可 以 使 用 相应 的 Properties 窗 口 将 资源 提升 到 一 个 更 高 的 作用 
域 。 在 Visual Studio 中 ， 首 先 确定 类 型 为 复杂 对 象 并 希望 将 其 封装 为 资源 的 属性 (本 例 中 的 Background 
属性 )。 在 该 属性 旁边 可 以 看 到 一 个 白色 小 方形 按钮 ， 单 击 可 以 打开 一 个 弹出 菜单 。 在 弹出 菜单 中 选 
择 “Convert to New Resource...” 选 项 ( 如 图 30-6 所 示 )。 
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图 30-6 ”将 复杂 对 象 移 至 资源 容器 


然后 将 要 求 你 对 资源 命名 (myBrush ), 并 指定 其 位 置 。 本 例 中 保留 当前 文档 的 默认 选择 ( 如 图 30-7 
所 示 )。 
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图 30-7 命名 对 象 资源 
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完成 之 后 ， 标 记 将 被 调整 为 如 下 形式 : 


<Window x:Class="0bjectResourcesApp.MainWindow” 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Object Resources" Height="350" Width="525"> 


<Window.Resources> 
<RadialGradientBrush x:Key="myBrush"> 
<GradientStop Color="#FFC44EC4" Offset="0" /> 
<GradientStop Color="#FF829CEB" Offset="1" /> 
<GradientStop Color="#FF793879" Offset="0.669" /> 
</RadialGradientBrush> 
</Window.Resources> 


<StackPanel Orientation="Horizontal"> 
<Button Margin="25" Height="200" Width="200" Content="OK" 
FontSize="20" Background="{StaticResource myBrush}"></Button> 
<Button Margin="25" Height="200" Width="200" Content="Cancel" FontSize="20"/> 
</StackPanel> 


</Window> 
注意 ， 新 的 <Window.Resources> 标 签 包 含 一 个 RadialGradientBrush 对 象 ， 其 键 值 为 myBrush。 


30.2.3 {StaticResource} 标 记 扩 展 


提取 对 象 资源 后 发 生 的 另 一 个 变化 是 , 提取 的 目标 属性 ( 还 是 Background ) 现 在 使 用 了 {StaticResource} 
标记 扩展 ， 并 用 键 的 名 称 作为 参数 。 现 在 ，Cancel 按 钮 可 以 随意 使 用 同样 的 画 刷 来 绘制 背景 。 或 者 ， 
如 果 Cancel 按 钮 包含 某 些 复杂 内 容 ，Button 的 任何 子 元 素 都 可 以 使 用 这 个 窗 体 级 别 的 资源 一 一 例如 ， 
Ellipse 的 Fill 属 性 : 


<StackPanel Orientation="Horizontal"> 
<Button Margin="25" Height="200" Width="200" Content="OK" FontSize="20" 
Background="{StaticResource myBrush}"> 
</Button> 


<Button Margin="25" Height="200" Width="200" FontSize="20"> 
<StackPanel> 
<Label HorizontalAlignment="Center" Content= "No Way!"/> 
<Ellipse Height="100" Width="100" Fill="{StaticResource myBrush}"/> 
</StackPanel> 
</Button> 
</StackPanel> 


30.2.4 {DynamicResource} 标 记 扩 展 


当 连 接 资源 时 ， 属 性 也 可 以 使 用 {DynamicResource} 扩 展 标记 。 要 了 解 其 不 同 之 处 ， 先 将 OK 按钮 
命名 为 btn0Kk， 并 添加 click 事 件 处 理 程序 。 在 事件 处 理 程序 中 使 用 Resources 属 性 获取 自 定义 画 刷 ， 并 
对 其 进行 修改 : 

了 void btnOK Click(object sender, RoutedEventArgs e) 

// 获取 画 刷 并 进行 修改 


RadialGradientBrush b = (RadialGradientBrush)Resources["myBrush"]; 
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b.GradientStops[1] = new GradientStop(Colors.Black, 0.0); 


说 明 这 里 我 们 使 用 Resources 索 引 器 通过 名 称 来 定位 资源 。 但 是 ， 要 知道 如 果 没 有 找到 资源 将 会 抛 
出 一 个 运行 时 异常 。 你 还 可 以 使 用 TryFindResource() 方 法 ， 在 制定 的 资源 不 存在 的 情况 下 返 
回 null， 而 不 会 抛 出 运行 时 错误 。 


运行 程序 并 单 击 OK 按钮 ， 你 会 发 现 画 刷 发 生 了 改变 ,并且 所 有 的 按钮 也 都 用 修改 后 的 画 刷 进行 
了 更 新 。 但 是 ， 如 果 完 全 更 改 由 myBrush 键 指定 的 画 刷 类 型 会 发 生 什么 样 的 情况 呢 ? 例 如 : 
private void btnOK Click(object sender, RoutedEventArgs e) 


// 用 全 新 的 画 刷 蔡 换 原来 的 myBrush 
Resources["myBrush"] = new SolidColorBrush(Colors.Red); 


这 时 再 单 击 按钮 ， 不 会 发 生 任 何 改变 。 这 是 因为 {StaticResource} 扩 展 标记 只 加 载 一 次 资源 ， 并 
在 应 用 程序 声明 周期 与 原始 对 象 保 持 “ 连 接 ”。 不 过 ， 如 果 我 们 将 所 有 {StaticResource} 改 为 
{DynamicResource}， 那 么 我 们 的 自 定义 画 刷 将 会 如 期 地 变 为 纯 红 色 的 画 刷 。 

实质 上 ，{DynamicResource} 扩 展 标 记 可 以 探测 实际 的 对 象 是 否 被 新 的 对 象 所 替换 。 正 如 你 猜测 的 
那样 ， 这 需要 额外 的 运行 时 基础 结构 ， 因 此 除非 你 确定 会 在 运行 时 更 改 对 象 资源 ， 并 且 希 望 通知 所 有 
使 用 该 资源 的 项 ， 否 则 请 坚持 使 用 {StaticResource}。 


30.2.5 ”应 用 程序 级 别 的 资源 


当 窗 体 的 资源 字典 有 了 对 象 资源 以 后 ， 窗 体 中 的 所 有 项 都 可 以 自由 使 用 这 些 资源 , 但 同一 个 应 用 
程序 中 的 其 他 窗 体 却 无 法 享用 。 将 Cancel 按 钮 命名 为 btnCancel， 并 添加 Click 事 件 处 理 程序 。 为 当前 
项 目 添加 包含 一 个 按钮 的 新 窗 体 ( 命名 为 TestWindow.xaml )， 单 击 按钮 将 关闭 该 窗 体 : 


public partial class TestWindow : Window 





public TestWindow() 


InitializeComponent(); 


private void btnClose Click(object sender, RoutedEventArgs e) 
this.Close(); 


} 
在 第 一 个 窗 体 Cancel 按 钮 的 Click 事 件 处 理 程序 中 ， 加 载 并 显示 这 个 新 的 window， 如 下 : 


private void btnCancel Click(object sender, RoutedEventArgs e) 


TestWindow w = new TestWindow(); 

w.Owner = this; 

w.WindowStartupLocation = WindowStartupLocation.CenterOwner; 
Ww. ShowDialog(); 
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新 的 窗 体 无 法 使 用 myBrush， 因 为 它 不 在 同一 个 “作用 域 ” 之 内 。 解决 方法 是 在 应 用 程序 级 别 定 义 对 
象 资源 , 而 不 是 某 个 特定 的 窗 体 级 别 。 不 过 这 无 法 在 Visual Studio 中 自动 完成 ,所 以 需要 将 当前 画 刷 对 象 
从 <Windows.Resources> 作 用 域 剪 切 出 来 ， 复 制 到 App.xaml 文 件 的 <Application.Resources> 作 用 域 中 : 


<Application x:Class="0bjectResourcesApp.App" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft .com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 


<Application.Resources> 
<RadialGradientBrush x:Key="myBrush"> 
<GradientStop Color="#FFC44EC4" Offset="0" /> 
<GradientStop Color="#FF829CEB" Offset="1" /> 
<GradientStop Color="#FF793879" Offset="0.669" /> 
</RadialGradientBrush> 
</Application.Resources> 


</Application> 


现在 TestWindow 可 以 随意 使 用 这 个 画 刷 来 绘制 背景 了 ,找到 新 Window 的 Background 属 性 , 单 击 Brush 
resources 选 项 卡 查看 应 用 程序 级 别 的 资源 ( 如 图 30-8 所 示 )。 






| qh Name <No Name> [| 多 

| Type Window 

| Search Propertes 万 
Arrange by: Category ~ 


4 Brush 


OpacityMask No brush 


四 = 国 画 [li 


| 4 Local Brush Resources 


4 System Brush Resources 
ActiveBorderBrushKey | | 
ActiveCaptionBrushKey | 
WN ActveCaptionTextBrushKey 











1 AppWorkspaceBrushKey 
ControlBrushKey 
Sl ControlDark8rushKey 





图 30-8 使 用 应 用 程序 级 别 的 资源 


30.2.6 ”定义 合并 的 资源 字典 


应 用 程序 级 别 的 资源 是 个 不 错 的 选择 ， 但 如 果 你 希望 定义 一 些 复杂 (或 不 那么 复杂 ) 的 资源 并 
在 多 个 WPF 项 目 中 复 用 ,应 该 如 何 是 好 呢 ? 这 时 你 需要 定义 合并 的 资源 字典 。 它 只 不 过 是 一 个 包含 
了 对 象 资源 集合 的 .xaml 文 件 。 单 个 项 目 可 以 包含 任意 多 个 这 种 文件 ( 用 来 保存 所 有 画 刷 的 文件 、 用 
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来 保存 所 有 动画 的 文件 ， 等 等 )， 每 个 文件 都 能 通过 Project 菜 单 的 Add New Item 对 话 框 插入 ( 如 图 
30-9 所 示 )。 
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图 30-9 插入 新 的 合并 的 资源 字典 
在 MyBrushes.xaml 文 件 中 ， 我 们 将 Application.Resources 作 用 域 中 的 资源 转移 到 字典 中 ， 如 下 : 


<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 





<RadialGradientBrush x:Key="myBrush"> 
<GradientStop Color="#FFC44EC4" Offset="0" /> 
<GradientStop Color="#FF829CEB" Offset="1" /> 
<GradientStop Color="#FF793879" Offset="0.669" /> 
</RadialGradientBrush> 


</ResourceDictionary> 

现在 ,尽管 资源 字典 已 经 成 为 项 目的 一 部 分 , 但 它 仍然 将 产生 运行 时 错误 。 因 为 所 有 资源 字典 都 
必须 合并 到 一 个 已 知 的 资源 字典 中 (通常 为 应 用 程序 级 别 的 字典 )。 可 以 使 用 如 下 的 格式 ( 注意， 多 
个 资源 字典 可 以 通过 在 <ResourceDictionary.MergedDictionaries> 作 用 域内 添加 <Resource- 
Dictionary> 元 素来 进行 合并 )。 


<Application x:Class="0bjectResourcesApp.App" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 


《<1-- 引入 MyBrushes.xaml 文 件 中 的 还 辑 资 源 --> 
<Application.Resources> 
<ResourceDictionary> 
<ResourceDictionary.MergedDictionaries> 
<ResourceDictionary Source = "MyBrushes.xaml"/> 
</ResourceDictionary.MergedDictionaries> 
</ResourceDictionary> 
</Application.Resources> 


</Application> 





30.2.7 ”定义 只 含 资源 的 程序 集 


最 后 , 你 可 以 创建 只 包含 对 象 资源 字典 的 .NET 类 库 。 定 义 可 用 于 计算 机 级 别 的 主题 是 非常 有 用 的 。 
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你 可 以 将 对 象 资源 打包 到 一 个 辅助 的 程序 集中 ， 要 用 到 它们 的 应 用 程序 可 以 将 其 加 载 到 内 存 中 。 


要 构建 一 个 只 含 资 源 的 程序 集 ， 最 简单 的 方式 是 通过 WPF User Control Library 项 目 。 在 当前 解决 
方案 中 添加 这 样 一 个 项 目 ( 取 名 为 MyBrushesLibrary ), 使 用 Visual Studio 中 的 Add 一 New Project 荣 单项 


(如 图 30-10 所 示 )。 





家 
dd New Project 





| 下 Recent 
| ted 


Visualce 


LightSwiteh 

Other Langusges 
Other Project Types 
Test Projects 


1 Online 





Explorer 如 图 30-11 所 示 。 
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图 30-10 ”为 构建 只 含 资源 的 程序 集 添加 一 个 User Control Library 
然后 ， 彻 底 删 除 项 目 中 的 UserControll.xaml ( 我 们 只 需要 被 引用 的 WPF 程 序 集 )。 接 下 来 ,将 
MyBrushes.xaml 文 件 拖 忠 到 MyBrushes Library 项 目 中 ， 并 从 ObjectResourcesApp 项 目 中 删除 。Solution 





-x 






Dp- 














将 MyBrushes.xaml 文 件 移动 到 新 的 库 项 目 中 


Windows Presentation Foundation custom | 
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编译 User Control Library 项 目 。 然 后 使 用 Add Reference 对 话 框 在 ObjectResourcesApp 项 目 中 引用 该 
库 。 现 在 ， 你 可 以 在 ObjectResourcesApp 项 目 中 的 应 用 程序 级 别 的 资源 字典 中 合并 这 些 二 进 制 资源 。 
合并 的 语法 有 点 睡 涩 ， 如 下 : 
<Application.Resources> 
<ResourceDictionary> 
<ResourceDictionary.MergedDictionaries> 
《<1-- 语法 为 /Name0fAssembly;Component/Name0fXamlFileInAssembly.xaml --> 
<ResourceDictionary Source = "/MyBrushesLibrary;Component/MyBrushes.xaml"/> 
</ResourceDictionary.MergedDictionaries> 


</ResourceDictionary> 
</Application.Resources> 


首先 ， 要 注意 这 个 字符 串 对 空格 敏感 。 如 果 在 分 号 或 斜 线 前 后 添加 了 空格 ,将 得 到 运行 时 错误 。 
该 字符 串 的 第 一 部 分 是 外 部 库 的 名 称 ( 不 含 文件 扩展 名 )。 在 分 号 之 后 ， 输 入 单词 Component， 然 后 是 
编译 的 二 进 制 资源 的 名 称 ， 与 原始 的 XAML 资 源 字典 相同 。 

这 就 是 我 们 对 于 WPF 资 源 管理 系统 的 研究 。 你 可 以 在 大 多 数 应 用 程序 以 及 本 书 其 他 WPF 章 节 中 好 
好 使 用 这 些 技 术 。 接 下 来 ， 我 们 开始 研究 WPF 中 集成 的 动画 API。 


源 代 码 ”ObjectResourcesApp 项 目的 源 代码 位 于 Chapter 30 子 目录 下 。 





30.3 理解 WPF 动画 服务 


除了 第 29 章 介绍 的 图 形 呈 现 服 务 以 外 ，WPF 还 提供 了 支持 动画 服务 的 编程 接口 。 动 画 这 个 词 意 味 
着 炫 动 的 公司 logo、 旋 转 的 图 像 资 源 序列 ( 为 了 产生 移动 的 视觉 效果 入 在 屏幕 上 跳动 的 文字 或 视频 游 
戏 、 多 媒体 应 用 这 样 的 特殊 类 型 的 应 用 程序 。 

WPF 动 画 API 完 全 能 够 达到 这 些 目 的 ， 并且 还 能 随时 为 应 用 程序 添加 额外 的 效果 。 例 如 ， 你 可 以 
为 按钮 添加 一 个 动画 效果 ， 当 鼠标 光标 悬浮 在 按钮 边框 时 按钮 会 稍稍 放大 ( 当 鼠 标 光标 移 开 边框 时 ， 
按钮 将 恢复 原来 的 大 小 )。 或 者 为 窗 体 添加 一 个 动画 ， 使 其 在 关闭 时 产生 特殊 的 视觉 效果 ， 如 慢 慢 变 
为 透明 。 事实 上 , 如 果 你 希望 提供 更 丰富 的 用 户 体验 , 可 以 将 WPF 动 画 用 于 各 种 应 用 程序 ( 商业 应 用 、 

如 同 WPF 的 其 他 方面 一 样 , 构建 动画 的 概念 也 不 是 全 新 的 ,与 以 前 用 到 的 那些 API( 如 Windows 
Form ) 所 不 同 的 是 ， 你 不 需要 手动 编写 底层 代码 。 使 用 WPF ， 你 不 需要 创建 后 台 线 程 或 定时 器 以 
推进 动画 序列 ， 不 需要 定义 自 定 义 类 型 来 表示 动画 ， 不 需要 探 除 和 重 绘图 像 以 及 其 他 烦琐 的 数学 
计算 。 

和 WPF 的 其 他 方面 类 似 ， 你 可 以 完全 使 用 XKAML 构 建 动画 , 也 可 以 完全 使 用 C# 代 码 ， 或 者 两 者 相 


结合 。 








说 明 Visual Studio 没 有 提供 创建 动画 的 GUI 动 画工 具 。 如 果 希 望 使 用 Visual Studio 创 建 动 画 ， 需 要 直 
- 接 输入 XAML。 实 际 上 Expression Blend 有 个 内 置 的 动画 编辑 器 ， 可 以 大 大 简化 相关 操作 。 
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30.3.1 动画 类 型 的 作用 


要 想 理解 WPF 对 于 动画 的 支持 ， 必 须 先 研究 PresentationCore.dll 中 System.Windows .Media.Animation 
命名 空间 下 的 各 种 动画 类 。 使 用 Animation 标 记 命 名 的 类 型 超过 了 100 个 。 

这 些 类 型 可 以 分 为 三 大 类 。 首 先 ， 遵 循 0a 妇 TypeAnimation 命 名 约定 的 类 ( ByteAnimation 、 
ColorAnimation、DoubleAnimation、Int32Animation 等 ) 可 以 使 用 线性 插值 动画 。 你 可 以 将 某 个 值 从 起 
点 到 终点 随 着 时 间 的 推移 缓慢 地 变化 。 

其 次 ， 遵 循 Da 妇 TypeAnimationUsingkeyFrames 命 名 约定 的 类 ( StringAnimationUsingKeyFrames 、 
DoubleAnimationUsingKeyFrames 、PointAnimationUsingKeyFrames 等 ) 表示 “关键 帧 动画 ”"， 可 以 在 一 
段 时 间 内 循环 一 组 已 定义 的 值 。 例 如 ， 你 可 以 使 用 关键 帧 通过 循环 一 系列 单个 字符 来 改变 按钮 的 
标题 。 

最 后 ,遵循 023ta7ypeAnimationUsingPath 命 名 约定 的 类 ( DoubleAnimationUsingPath、PointAnimation 
UsingPath 等 ) 是 基于 路 径 的 动画 ， 它 可 以 使 对 象 按照 定义 好 的 路 径 移 动 。 举 个 例子 ， 如 果 你 正在 构建 
一 个 GPS 应 用 程序 ， 就 可 以 使 用 基于 路 径 的 动画 ， 使 某 个 东西 按照 最 快 路 径 到 达 用 户 的 目的 地 。 

显然 ， 这 些 类 不 是 用 来 直接 为 某 个 特殊 的 数据 类 型 变量 提供 动画 序列 的 。( 那么 ， 我 们 究竟 如 何 
才能 使 用 Int32Animation 对 “9” 这 个 值 执行 动画 呢 ? ) 

例如 ，Label 类 型 的 Height 和 Width 属 性 都 是 double 类 型 的 依赖 属性 。 如 果 你 希望 定义 一 个 动画 在 
某 个 时 间 跨 度 内 增加 标签 的 高 度 ， 可 以 将 一 个 DoubleAnimation 对 象 关 联 到 Height 属 性 ， 并 允许 WPF 处 
理 执行 实际 动画 的 细节 。 再 举 一 个 例子 ， 如 果 你 希望 在 5 秒 钟 内 将 一 个 画 刷 类 型 的 颜色 由 绿色 改 为 黄 
色 ， 可 以 使 用 ColorAnimation 类 型 。 

这 些 Animation 类 都 可 以 关联 到 类 型 匹配 的 依赖 属性 。 正 如 第 31 章 将 介绍 的 那样 , 依赖 属性 是 特殊 
类 型 的 属性 ， 很 多 WPF 服 务 如 动画 、 数 据 绑 定 和 样式 都 要 用 到 。 

按照 惯例 ， 依 赖 属性 定义 为 类 的 静态 只 读 字 段 ， 命 名 方式 为 普通 属性 名 称 加 上 Property 后 级。 例 
如 ，Button 的 Height 属 性 的 依赖 属性 为 Button.HeightProperty。 


30.3.2 To、From 和 By 属性 


所 有 Animation 类 都 定义 了 几 个 关键 属性 用 来 控制 执行 动画 的 开始 和 结束 值 。 

口 To: 表示 动画 的 结束 值 。 

口 From: 表示 动画 的 起 始 值 。 

口 By: 标识 要 改变 的 起 始 值 的 总 数目 。 

尽管 所 有 的 Animation 类 都 支持 To、From 和 By 属性 , 但 它们 并 未 继承 基 类 的 虚 成 员 。 理 由 是 这 些 属 
性 所 封装 的 基本 类 型 不 其 相同 ( 如 整 型 、 颜 色 、Thickness 对 象 等 )， 使 用 一 个 基 类 来 表示 这 些 属性 将 
导致 复杂 的 代码 结构 。 

你 可 能 也 不 知道 为 什么 没有 使 用 .NET 泛 型 来 定义 一 个 包含 单个 类 型 参数 的 泛 型 动画 类 ( 如 
Animation<T> )。 同 样 ， 由 于 大 量 的 基本 数据 类 型 ( 颜色 、 向 量 、 整 数 、 字 符 串 等 ) 用 于 动画 的 依 
赖 属性 ， 使 用 泛 型 不 会 得 到 一 个 预期 的 干净 的 解决 方案 ( 更 何况 XAML 对 泛 型 类 型 的 支持 也 很 
有 限 )。 
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30.3.3 Timeline 基 类 的 作用 


尽管 没有 使 用 单独 的 基 类 定义 To 、From 和 By 虚 属 性 ， 这 些 Animation 类 却 都 继承 了 基 类 
System.Windows .Media.Timeline。 该 类 型 提供 了 大 量 的 属性 来 控制 动画 的 进度 ， 如 表 30-1 所 示 。 


表 30-1 Timeline 基 类 的 关键 成 员 





属 性 含 义 
AccelerationRatio、DecelerationRatio、 这 些 属性 可 以 用 来 控制 动画 序列 的 整体 进度 
SpeedRatio 
AutoReverse 获取 或 设置 一 个 值 ， 指 示 时 间 段 在 完成 向 前 的 循环 后 是 否 自动 回放 ( 默认 
值 为 false ) 
BeginTime 获取 或 设置 时 间 段 开始 的 时 间 。 默 认 值 为 0， 表 示 立 即 开 始 动画 
Duration 设置 播放 时 间 段 的 一 个 持续 的 时 间 
FillBehavior、 RepeatBehavior 这 些 属 性 用 来 控制 时 间 段 完成 之 后 要 发 生 的 事情 ( 重复 动画 或 什么 都 不 做 ) 


30.3.4 用 C# 代 码 创建 动画 


有 具体 来 说 ,我 们 将 创建 含有 一 个 Button 的 窗 体 ， 每 当 鼠 标 滑 入 按钮 表面 时 窗 体 将 神奇 地 开始 转圈 
( 围绕 左上 角 )。 使 用 Visual Studio 新 建 一 个 WPF 应 用 程序 SpinningButtonAnimationApp。 按 如 下 的 代码 
修改 初始 的 标记 ( 注意 我 们 处 理 了 按钮 的 MouseEnter 事 件 ): 


<Window x:Class="SpinningButtonAnimationApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Animations in C# code" Height="350" 
Width="525" WindowStartupLocation="CenterScreen"> 
<Grid> 

<Button x:Name="btnSpinner" Height="50" Width="100" Content="I Spin!" 
MouseEnter="btnSpinner MouseEnter"/> 

</Qrid> 

</Window> 


现在 ， 在 C# 代 码 文件 中 引入 System.Windows .Media.Animation 命 名 空间 并 添加 如 下 代码 : 
public partial class MainWindow : Window 
private bool isSpinning = false; 
private void btnSpinner MouseEnter(object sender, MouseEventArgs e) 
if (!isSpinning) 
' isSpinning = true; 
// 创建 一 个 double 动 画 对 象 ， 并 注册 其 Completed 事 件 
DoubleAnimation dblAnim = new DoubleAnimation(); 
dblAnim.Completed += (0o, s) => { isSpinning = false; }; 
// 设置 起 始 和 结束 值 


dblAnim.From = 0; 
dblAnim.To = 360; 
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// 创建 RotateTransform 对 象 ， 并 设置 按钮 的 RenderTransform 属 性 
RotateTransform rt = new RotateTransform(); 
btnSpinner.RenderTransform = rt; 


// 现在 ， 执行 RotateTransform 对 象 
rt.BeginAnimation(RotateTransform.AngleProperty, dblAnim); 


} 
} 
上 


该 方法 的 首要 任务 是 配置 DoubleAnimation 对 象 ， 它 的 起 始 值 为 0， 结 束 值 为 360。 我 们 还 处 理 了 该 
对 象 的 Completed 事 件 ， 如 果 当 前 动画 执行 完毕 ， 就 将 类 级 别 的 boo1 变 量 设置 为 false， 让 它 不 再 重新 
开始 。 

接 下 来 ,我们 创建 一 个 RotateTransform 对 象 , 将 它 连 接 到 Button 控 件 (btnSpinner ) 的 RenderTrans- 
form 属 性 。 最 后 ， 通 知 RenderTransform 对 象 使 用 我 们 的 DoubleAnimation 对 象 对 Angle 属 性 执行 动画 。 
在 编写 动画 代码 时 ， 通 常 要 调用 BeginAnimation() 方 法 ， 将 希望 执行 动画 的 依赖 属性 ( 依 惯例 应 为 类 
的 静态 字段 ) 和 相关 的 动画 对 象 作为 参数 传人 。 

让 我 们 为 程序 添加 另 一 个 动画 , 当 单 击 按钮 时 , 它 将 逐渐 消失 。 首先 , 处 理 btnspinner 对 象 的 Click 
事件 ， 然 后 为 事件 处 理 程序 添加 如 下 代码 : 


private void btnSpinner Click(object sender, RoutedEventArgs e) 


DoubleAnimation dblAnim = new DoubleAnimation(); 
dblAnim.From = 1.0; 

dblAnim.To = 0.0; 
btnSpinner.BeginAnimation(Button.OpacityProperty, dblAnim); 


这 里 , 我 们 改变 0pacity 属 性 的 值 , 使 按钮 从 视图 中 消失 。 但 是 现在 这 样 做 有 点 困难 ， 因 为 按钮 正 
在 快速 旋转 ! 那么 ， 如 何 控制 动画 的 速度 呢 ? 你 能 这 么 问 让 我 甚 感 欣 慰 。 


30.3.5 ”控制 动画 的 速度 


默认 情况 下 , 一 个 动画 从 From 的 值 转换 到 To 的 值 大 约 需 要 1 秒 的 时 间 。 因 此 , 单 击 按钮 时 它 首先 用 
1 秒 的 时 间 旋 转 360” 然 后 才 会 逐渐 消失 。 

如 果 你 需要 自 定义 动画 执行 的 时 间 ， 可 以 通过 动画 对 象 的 Duration 属 性 ， 该 属性 为 一 个 Duration 
对 象 的 实例 。 通 常情 况 下 ， 将 一 个 Timespan 对 象 传 人 Duration 的 构造 函数 ， 以 此 来 建立 时 间 跨 度 。 下 
面 的 代码 使 按钮 的 旋转 时 间 达 到 4 秒 : 

private void btnSpinner MouseEnter(object sender, MouseEventArgs e) 

if (!isSpinning) 
isSpinning = true; 
// 创建 一 个 double 动 画 对 象 ， 并 注册 其 Completed 事 件 


DoubleAnimation dblAnim = new DoubleAnimation(); 
dblAnim.Completed += (0，s) => { isSpinning = false; }; 


// 按钮 将 旋转 4 秒 


dblAnim.Duration = new Duration(TimeSpan.FromSeconds(4)); 
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} 
} 


经 过 这 一 调整 ， 你 将 有 机 会 在 按钮 旋转 的 时 候 单 击 它 ， 从 而 使 它 逐 渐 消 失 。 





说 明 一 个 Animation 类 的 BeginTime 属 性 同样 含有 TimeSpan 对 象 。 该 属性 可 以 在 一 个 动画 序列 开始 之 
前 建立 一 个 等 待 时 间 。 








30.3.6 ”动画 的 反 转 和 循环 


你 可 以 将 Animation 对 象 的 AutoReverse 属 性 设置 为 true， 这 样 在 动画 序列 完成 之 后 将 自动 反 转 动 
画 。 例 如 ， 如 果 和 希望 按钮 消失 之 后 再 恢复 显示 ， 可 以 编写 如 下 的 代码 : 


private void btnSpinner Click(object sender, RoutedEventArgs e) 


DoubleAnimation dblAnim = new DoubleAnimation(); 
dblAnim.From = 1.0; 
dblAnim.To = 0.0; 


// 结束 之 后 反 转 

dblAnim.AutoReverse = true; 

btnSpinner.BeginAnimation(Button.OpacityProperty, dblAnim); 
} 


如 果 和 希望 动画 重复 播放 数 次 (或 一 直 重 复 播放 )， 可 以 使 用 所 有 Animation 类 都 拥有 的 Repeat- 
Behavior 属 性 。 将 一 个 简单 的 数值 传人 它 的 构造 函数 ， 就 可 以 以 硬 编码 的 方式 指定 重复 播放 的 次 数 。 

男 一 方面 ， 如 果 将 一 个 TimeSpan 传 人 构造 函数 ， 可 以 指定 动画 重复 播放 的 持续 时 间 。 最 后 ， 如 果 
希望 动画 无 止境 地 循环 下 去 ， 可 以 简单 地 指定 为 RepeatBehavior.Forever。 在 本 例 中 ,我们 可 以 使 用 
以 下 3 种 方法 改变 DoubleAnimation 对 象 的 重复 行为 : 

// 一 直 循 环 


dblAnim.RepeatBehavior = RepeatBehavior.Forever; 


// 循环 3 次 
dblAnim.RepeatBehavior = new RepeatBehavior(3); 


// 循环 30 秒 

dblAnim.RepeatBehavior = new RepeatBehavior(TimeSpan.FromSeconds(30)); 

使 用 C# 代 码 和 WPF 动 画 API 对 对 象 的 某 些 部 分 执行 动画 的 研究 就 到 此 结束 了 。 接 下 来 我 们 将 学 习 
如 何 使 用 XAML 做 同样 的 事情 。 








源 代码 SpinningButtonAnimationApp 项 目的 源 代码 位 于 Chapter 30 子 目录 下 。 
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30.4 用 XAML 创建 动画 


用 标记 创建 动画 跟 在 代码 中 创建 是 类 似 的 ， 至 少 对 于 简单 的 动画 序列 来 说 是 这 样 。 但 是 如 果 需 要 
得 到 更 复杂 的 动画 ， 就 要 同时 修改 多 个 属性 的 值 ， 标 记 数 量 将 会 显著 增加 。 即 便 是 使 用 工具 来 生成 基 
于 XAML 的 动画 ， 了 解 如 何 使 用 XAML 表 示 动 画 仍然 是 十 分 重要 的 ， 它 可 以 使 你 更 方便 地 调整 和 修改 
工具 生成 的 内 容 。 








说 明 在 可 下 载 源 代码 的 XamlAnimations 文 件 夹 中 , 你 将 发 现 大 量 的 XAMIL 文 件 。 在 进行 本 节 剩 余部 
分 的 学 习 时 ， 可 以 将 这 些 标 记 复 制 到 自 定 义 的 XAML 编辑 器 或 Kaxaml 编 辑 器 中 ， 并 查看 结果 。 








在 标记 中 创建 动画 和 用 代码 创建 在 很 大 程度 上 是 一 样 的 。 你 都 需要 配置 一 个 Animation 对 象 , 并 将 
它 关 联 到 某 个 属性 。 但 最 大 的 不 同 是 , WPF 对 函数 调用 来 说 是 不 友好 的 。 你 不 能 调用 BeginAnimation() ， 
只 能 使 用 演示 图 板 (storyboard ) 作为 间接 层 。 

让 我 们 通过 一 个 完整 的 示例 来 演示 如 何 用 XAML 定 义 动画 ， 并 进行 详细 的 说 明 。 下 面 的 XAML 定 
义 显示 了 一 个 含有 标签 的 窗 体 。 在 Label 对 象 加 载 到 内 存 时 ， 开 始 执 行 一 个 动画 序列 ， 在 4 秒 之 内 使 字 
体 从 12 增 大 到 100。 只 要 Window 对 象 还 在 内 存 中 ， 这 个 动画 就 会 一 直 重 复 播放 。 这 段 标记 位 于 
GrowLabelFont.xaml 文 件 中 ， 你 可 以 将 它 复制 到 MyXamlPad.exe 应 用 程序 中 并 观察 其 行为 。 


<Window 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Height="200" Width="600" WindowStartupLocation="CenterScreen" Title="Growing Label Font!"> 
<StackPanel> 
<Label Content = "Interesting..."> 
<Label.Triggers> 
<EventTrigger RoutedEvent = "Label.Loaded"> 
<EventTrigger.Actions> 
<BeginStoryboard> 
<Storyboard TargetProperty = "FontSize"> 
<DoubleAnimation From = "12" To = "100" Duration = "0:0:4" 
RepeatBehavior = "Forever"/> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger.Actions> 
</EventTrigger> 
</Label.Triggers> 
</Label> 
</StackPanel> 
</Window> 


下 面 我 们 来 详细 分 析 这 个 示例 。 


30.4.1 演示 图 板 的 作用 


我 们 从 最 里 面 的 元 素 开 始 向 外 分 析 。 首 先是 <DoubleAnimation> 元 素 ， 它 设置 的 属性 与 程序 代码 中 
相同 ( From、To、Duration 和 RepeatBehavior ): 
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<DoubleAnimation From = "12" To = "100" Duration = "0:0:4" 
RepeatBehavior = "Forever"/> 


如 前 所 述 ，Animation 元 素 放置 在 <Storyboard> 元 素 中 ， 它 通过 TargetProperty 属 性 将 动画 对 象 映 
射 到 父 类 型 的 某 个 属性 一 一 本 例 为 FontSize。《Storyboard> 总 是 包含 在 父 元 素 <BeginStoryboard> 中 。 


<BeginStoryboard> 
<Storyboard TargetProperty = "FontSize"> 
<DoubleAnimation From = "12" To = "100" Duration = "0:0:4" 
RepeatBehavior = "Forever"/> 
</Storyboard> 
</BeginStoryboard> 


30.4.2 ”事件 触发 器 的 作用 


定义 了 <BeginStoryboard> 元 素 之 后 , 我 们 就 需要 指定 一 些 行 为 来 开始 执行 动画 。WPF 包 含 几 种 不 
同 的 方法 在 标记 中 响应 运行 时 条 件 ， 其 中 一 种 称 为 触发 器 。 触 发 器 可 以 理解 为 在 一 个 较 高 层次 上 响应 
XAML 中 事件 条 件 的 方式 ， 而 不 需要 编写 程序 代码 。 

通常 ， 在 C# 中 响应 事件 时 ， 需 要 编写 事件 发 生 时 执行 的 代码 。 但 触发 器 则 是 某 个 事件 发 生 后 的 一 


在 事件 发 生 并 通知 你 之 后 ， 可 以 开启 演示 图 板 。 在 本 例 中 ， 我 们 响应 Label 加 载 到 内 存 的 事件 。 
由 于 我 们 感 兴趣 的 是 Label 的 Loaded 事 件 ， 因 此 <EventTrigger> 将 放置 在 Label 的 触发 器 集合 中 : 


<Label Content = "Interesting..."> 
<Label.Triggers> 
<EventTrigger RoutedEvent = "Label.Loaded"> 
<EventTrigger.Actions> 
<BeginStoryboard> 
<Storyboard TargetProperty = "FontSize"> 
<DoubleAnimation From = "12" To = "100" Duration = "0:0:4" 
RepeatBehavior = "Forever"/> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger.Actions> 
</EventTrigger> 
</Label.Triggers> 
</Label> 


让 我 们 再 看 一 个 在 XAML 中 定义 动画 的 示例 ， 这 次 我 们 使 用 关键 帧 动画 。 


30.4.3 ”使 用 不 连续 的 关键 帧 创建 动画 


线性 插值 动画 对 象 只 能 在 起 始点 和 结束 点 之 间 移 动 ， 与 此 不 同 的 是 ， 关 键 帧 可 以 创建 一 个 包含 特 
殊 值 的 集合 ， 动 画 将 在 这 些 特殊 的 时 间 点 播放 。 

为 了 演示 不 连续 的 关键 帧 类 型 , 我 们 创建 一 个 Button 控 件 , 对 其 内 容 执行 动画 , 在 3 秒 的 时 间 内 逐 
字符 显示 “OK!”。 下 面 的 标记 位 于 StringAnimation.xaml 文 件 中 ,将 其 复制 到 MyXamlPad.exe 程 序 并 观 
察 输出 结果 : 


<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Height="100" Width="300" 
WindowStartupLocation="CenterScreen" Title="Animate String Data!"> 
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<StackPanel> 
<Button Name="myButton" Height="40" 
FontSize="16pt" FontFamily="Verdana”" Width = "100"> 
<Button. Triggers> 
<EventTrigger RoutedEvent="Button.Loaded"> 
<BeginStoryboard> 
<Storyboard> 
<StringAnimationUsingKeyFrames RepeatBehavior = "Forever" 
Storyboard.TargetName="myButton" 
Storyboard.TargetProperty="Content" 
Duration="0:0:3"> 
<DiscreteStringKeyFrame Value="" KeyTime="0:0:0" /> 
<DiscreteStringKeyFrame Value="0" KeyTime="0:0:1" /> 
<DiscreteStringKeyFrame Value="OK" KeyTime="0:0:1.5" /> 
<DiscreteStringKeyFrame Value="OK!" KeyTime="0:0:2" /> 
</StringAnimationUsingKeyFrames> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger> 
</Button. Triggers> 
</Button> 
</StackPanel> 
</Window> 


首先 我 们 为 按钮 定义 了 一 个 事件 触发 器 ， 以 确保 在 按钮 加 载 到 内 存 时 能 够 执行 演示 图 板 。 
StringAnimationUsingKeyFrames 类 通过 Stroryboard.TargetName 和 Storyboard.TragetProperty 属 性 负 
责 改变 按钮 的 内 容 。 

在 <StringAnimationUsingKeyFrames> 元 素 的 作用 域内 ， 我 们 定义 了 4 个 DiscretestringKeyFrame 元 
素 , 它们 将 在 2 秒 之 内 改变 按钮 的 Content 属 性 ( StringAnimationUsingKeyFrames 建 立 的 持续 时 间 为 3 秒 ， 
因此 在 最 后 的 “!” 和 下 一 循环 的 “O” 之 间 会 有 一 个 短暂 的 停顿 )。 

现在 你 应 该 对 如 何 使 用 C# 代 码 和 XAML 构 建 动画 有 了 更 多 的 了 解 ， 下 面 让 我 们 将 注意 力 转移 到 
WPF 样 式 上 来 ， 它 大 量 应 用 于 图 形 、 对 象 资源 和 动画 之 中 。 


源 代码 “这些 XAML 文 件 位 于 Chapter 30 下 的 XamlAnimations 子 目录 中 。 


30.5 WPF 样式 的 作用 


在 构建 WPF 应 用 程序 的 UI 时 ， 多 个 控件 需要 显示 同样 的 外 观 是 很 常见 的 。 例 如 ,你 可 能 希望 所 有 
的 按钮 都 有 同样 的 高 度 、 宽 度 、 背 景 颜色 以 及 字体 大 小 。 尽 管 你 可 以 将 每 个 按钮 的 这 些 属 性 都 设置 成 
相同 的 值 ， 但 如 果 以 后 要 修改 这 些 值 就 会 变 得 异常 复杂 ， 因 为 每 次 改变 你 都 需要 重新 设置 这 些 对 象 的 
各 个 属性 。 

幸运 的 是 ，WPF 可 以 使 用 样式 方便 地 限制 相关 控件 的 外 观 。 简 而 言 之 ，WPF 样 式 是 一 个 对 象 , 它 包 
含 一 个 属性 / 值 对 和 集合。 从 编程 角度 来 说 ， 一 个 独立 的 样式 是 由 System.Windows.Style 类 来 表示 的 。 该 类 
包含 一 个 名 为 Setters 的 属性 , 它 是 一 个 Setter 对 象 的 强 类 型 集合 ,Setter 就 是 用 来 定义 属性 / 值 对 的 对 象 。 

除了 Setters 集 合 ，Style 类 还 定义 了 一 些 重要 的 成 员 ， 可 以 合并 触发 器 、 限 制 样式 所 针对 的 类 型 
其 至 基于 已 知 的 样式 创建 新 的 样式 ( 可 以 理解 为 “样式 的 继承 ”)。 要 特别 注意 以 下 Style 类 的 成 员 。 


1050 第 30 章 WPF 资源 、 动 画 和 样式 


DO Triggers: 触发 器 对 象 的 集合 ， 可 以 获取 样式 中 不 同 的 事件 条 件 。 
口 Based0n: 可 以 基于 一 个 已 知 的 样式 来 构建 新 的 样式 。 
口 TargetType: 限制 样式 所 针对 的 类 型 。 


30.5.1 定义 并 使 用 样式 


几乎 在 所 有 情况 下 ， 样 式 对 象 都 将 被 打包 为 对 象 资源 。 与 其 他 对 象 资源 一 样 ， 可 以 将 其 打包 为 窗 
体 级 别 或 应 用 程序 级 别 ， 或 者 一 个 专门 的 资源 字典 (这 使 style 对 象 在 应 用 程序 中 的 访问 变 得 十 分 方 
便 )。 我 们 的 目标 是 定义 一 个 Style 对象， 使 它 至 少 能 够 用 一 组 属性 / 值 对 来 填充 一 个 Setters 集 合 。 

在 Visual Studio 中 新 建 一 个 WPF 应 用 程序 WpfStyles， 并 创建 一 个 用 于 所 有 控件 基本 字体 的 样式 。 
打开 App.xaml 文 件 ， 定 义 如 下 命名 的 样式 : 


<Application x:Class="WpfStyles.App" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 


<Application.Resources> 
<Style x:Key ="BasicControlStyle"> 
<Setter Property = "Control.FontSize" Value ="14"/> 
<Setter Property = "Control.Height" Value = "40"/> 
<Setter Property = "Control.Cursor" Value = "Hand"/> 
</Style> 
</Application.Resources> 


</Application> 

注意 ， 我 们 为 BasicControlstyle 的 内 部 集合 添加 了 3 个 Setter 对 象 。 现 在 ， 我 们 在 主 窗 体 中 对 一 
些 控 件 应 用 该 样式 。 由 于 该 样式 为 对 象 资源 ， 要 应 用 它 的 对 象 资源 需要 使 用 {StaticResources} 或 
{DynamicResources} 标 记 扩展 来 定位 样式 。 找到 样式 之 后 , 它们 会 用 这 个 资源 项 设置 同样 的 属性 style。 
考虑 如 下 的 <Window> 定 义 : 


<Window x:Class="WpfStyles.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="A Window with Style!" Height="229" 
Width="525" WindowStartupLocation="CenterScreen"> 


<StackPanel> 
<Label x:Name="lblInfo" Content="This style is boring..." 
Style="{StaticResource BasicControlStyle}" Width="150"/> 
<Button x:Name="btnTestButton" Content="Yes, but we are reusing settings!" 
Style="{StaticResource BasicControlStyle}" Width="250"/> 
</StackPanel> 


</Window> 


运行 该 程序 ， 你 会 发 现 两 个 控件 都 支持 同样 的 光标 、 高 度 和 字体 大 小 。 


30.5.2 ” 重 写 样式 设置 
这 里 的 Button 和 Label 都 使 用 了 样式 定义 的 限制 。 当 然 , 如 果 控 件 需要 应 用 一 个 样式 并 修改 其 中 的 
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某 些 设置 ， 也 是 可 以 的 。 例 如 ，Button 现 在 将 使 用 help 光标 〈 而 不 是 样式 中 定义 的 Hand 光 标 ): 


<Button x:Name="btnTestButton" Content="Yes, but we are reusing settings!" 
Cursor="Help" Style="{StaticResource BasicControlStyle}" Width="250" /> 


控件 属性 的 设置 是 在 处 理 样式 之 后 进行 的 ， 因 此 控件 可 以 逐个 “ 重 写 ” 这 些 设置 。 


30.5.3 ”使 用 TargetType 自 动 应 用 样式 


当前 样式 的 定义 方式 是 任何 控件 都 可 以 使 用 (并 需要 显 式 设置 控件 的 Style 属 性 )， 因 为 所 设置 的 
每 个 属性 都 属于 Control 类 。 一 个 程序 往往 会 定义 很 多 设置 , 这 就 将 导致 大 量 的 重复 代码 。 要 想 使 这 些 
样式 简洁 一 些 , 方法 之 一 是 使 用 TargetType 特 性 。 将 该 特性 添加 到 style 的 开放 元 素 中 ， 只 需要 指定 一 
次 该 样式 可 以 应 用 的 对 象 : 


<Style x:Key ="BasicControlStyle" TargetType="Control"> 
<Setter Property = "FontSize" Value ="14"/> 
<Setter Property = "Height"” Value = "40"/> 
<Setter Property = "Cursor" Value = "Hand"/> 

</Style> 





说 明 在 对 基 类 型 构建 样式 时 ， 你 不 必 关 心 派生 类 型 是 否 支持 某 个 依赖 属性 。 如 果 不 支持 ， 将 会 自 
动 忽略 。 





这 有 些 帮助 ， 但 样式 还 是 可 以 用 于 任何 控件 。 在 你 需要 定义 用 于 特殊 控件 类 型 的 样式 时 ， 
TargetType 特 性 尤其 有 用 。 在 应 用 程序 的 资源 字典 中 添加 如 下 的 样式 : 


<Style x:Key ="BigGreenButton" TargetType="Button"> 
<Setter Property = "FontSize" Value ="20"/> 

"Height" Value = "100"/> 

"Width" Value = "100"/> 

"Background" Value = "DarkGreen"/> 

"Foreground" Value = "Yellow"/> 


<Setter Property 

<Setter Property 

<Setter Property 

<Setter Property 
</Style> 


该 样式 将 仅 对 Button 控 件 生 效 ( 或 Button 的 子 类 )， 如 果 将 其 应 用 到 不 兼容 的 元 素 中 , 将 得 到 标记 
和 编译 器 错误 。 如 果 Button 像 下 面 这 样 使 用 新 样式 : 


<Button x:Name="btnTestButton" Content="OK!" 
Cursor="Help" Style="{StaticResource BigGreenButton}" Width="250" /> 


输出 结果 如 图 30-12 所 示 。 


和 半 和 








图 30-12 ”使 用 不 同样 式 的 控件 
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30.5.4 ”继承 已 有 的 样式 


你 还 可 以 使 用 Basedon 属 性 根据 已 有 样式 构建 新 的 样式 ,被 扩展 的 样式 在 字典 中 必须 有 一 个 合适 的 
x:Key， 派 生 的 样式 在 {StaticResource} 标 记 扩 展 中 通过 名 称 引 用 它 。 以 下 是 基于 BigGreenButton 构 建 
的 新 样式 ， 它 将 按钮 元 素 旋转 20° : 


<1-- 该 样式 基于 BigGreenButton --> 
<Style x:Key ="TiltButton" TargetType="Button" BasedOn = "{StaticResource BigGreenButton}"> 
<Setter Property = "Foreground" Value = "White"/> 
<Setter Property = "RenderTransform"> 
<Setter.Value> 
<RotateTransform Angle = "20"/> 
</Setter.Value> 
</Setter> 
</Style> 


这 时 ， 输 出 结果 如 图 30-13 所 示 。 








图 30-13 ”使 用 派生 的 样式 


30.5.5 未 命名 样式 的 作用 


假设 你 希望 所 有 的 TextBox 控 件 都 有 同样 的 外 观 ， 那 么 可 以 定义 一 个 样式 作为 应 用 程序 级 别 的 资 
源 ， 这 样 程序 中 的 所 有 窗口 都 能 访问 该 资源 。 尽 管 这 么 做 可 行 ， 但 如 果 你 有 成 百 上 千 个 窗口 包含 成 百 
上 千 个 TextBox 控 件 ， 你 就 需要 对 Style 属性 设置 成 百 上 千 次 ! 

在 一 个 给 定 的 XAML 作 用 域内 ，WPF 样 式 可 以 隐 式 地 应 用 于 所 有 控件 。 要 创建 这 样 一 个 样式 ， 只 
需要 使 用 TargetType 属 性 而 不 用 设置 Style 资源 的 x:Key 值 。 这 种 “未 命名 的 样式 ”将 应 用 于 所 有 类 型 
正确 的 控件 ,以 下 是 男 一 个 应 用 程序 级 别 的 样式 , 它 将 自动 应 用 于 当前 应 用 程序 中 所 有 的 TextBox 控 件 。 

<1-- 所 有 文本 框 的 默认 样式 --> 

<Style TargetType="TextBox"> 

<Setter Property = "FontSize" Value ="14"/> 
<Setter Property = "Width" Value = "100"/> 

<Setter Property = "Height" Value = "30"/> 

<Setter Property = "BorderThickness" Value = "5"/> 
<Setter Property = "BorderBrush" Value = "Red"/> 


<Setter Property = "FontStyle" Value = "Italic"/> 
</Style> 


现在 我 们 可 以 定义 任意 多 的 TextBox 控 件 ， 它 们 将 自动 显示 这 个 定义 好 的 外 观 。 如 果 某 个 TextBox 


| 
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不 想 使 用 该 默认 外 观 ， 可 以 将 Style 属 性 设置 为 {x:Nul1}。 例 如 ，txtTest 将 使 用 默认 的 未 命名 样式 ， 
而 txtTest2 将 显示 自己 的 外 观 : 


<TextBox x:Name="txtTest"/> 
<TextBox x:Name="txtTest2" Style="{x:Null}" BorderBrush="Black" 
BorderThickness="5" Height="60" Width="100" Text="Ha!l"/> 


30.5.6 ”使 用 触发 器 定义 样式 


WPF 样 式 也 可 以 包含 触发 器 ，Trigger 对 象 可 以 被 包 庄 在 Style 对 象 的 Triggers 集 合 中 。 在 样式 中 
使 用 触发 器 可 以 定义 一 些 <Setter> 元 素 ， 只 有 在 给 定 触 发 器 的 条 件 为 true 时 ， 这 些 样 式 才 会 生效 。 例 
如 ， 你 可 能 需要 在 鼠标 悬 停 在 按钮 上 时 放大 字体 的 颜色 ,或 者 对 当前 获取 焦点 的 文本 框 用 某 种 颜色 进 
行 高 亮 显 示 。 这 时 触发 器 十 分 有 用 ， 你 可 以 在 某 个 属性 改变 时 执行 特殊 的 行为 ， 而 不 必 在 后 台 代 码 文 
件 中 显 式 编写 C# 代 码 。 


《1-- 所 有 文本 框 的 默认 样式 --> 

<Style TargetType="TextBox"> 
<Setter Property = "FontSize" Value ="14"/> 
<Setter Property = "Width" Value = "100"/> 
<Setter Property = "Height" Value = "30"/> 
<Setter Property = "BorderThickness" Value = "5"/> 
<Setter Property = "BorderBrush" Value = "Red"/> 
<Setter Property = "FontStyle" Value = "Italic"/> 
《1-- 下 面 的 setter 将 只 在 文本 框 获得 焦点 时 生效 --》> 
<Style.Triggers> 

<Trigger Property = "IsFocused" Value = "True"> 
<Setter Property = "Background”" Value = "Yellow"/> 


</Trigger> 
</Style.Triggers> 
</Style> 


测试 该 样式 ， 你 会 发 现在 不 同 的 TextBox 对 象 间 切换 时 ， 当 前 选中 的 TextBox 将 显示 明亮 的 黄色 背 
景 (只 要 没有 将 Style 属 性 设置 为 {x:Nul1} )。 

属性 触发 器 还 很 智能 , 当 触发 器 条 件 不 为 true 时 , 属性 将 自动 接受 默认 的 设置 。 因此 , 只 要 TextBox 
没有 获取 焦点 ， 它 将 自动 显示 默认 的 颜色 。 相 反 ， 事 件 触发 器 〈 在 介绍 WPF 动 画 时 进行 过 讨论 ) 不 会 
自动 恢复 到 以 前 的 状态 。 


30.5.7 ”使 用 多 个 触发 器 定义 样式 


你 还 可 以 这 样 设计 触发 器 ， 即 当 多 个 条 件 为 true 时 (类似 构建 包含 多 个 条 件 的 诗 语句 )， 我 们 定 
义 的 <Setter> 元 素 才 会 被 应 用 。 例 如 , 我 们 需要 在 TextBox 获 得 焦点 并 且 鼠 标 悬 浮 在 其 边框 之 内 时 , 将 
它 的 背景 色 设置 为 黄色 。 我 们 使 用 <MultiTrigger> 元 素来 定义 每 个 条 件 : 


《1-- 所 有 文本 框 的 默认 样式 --> 
<Style TargetType="TextBox"> 
<Setter Property = "FontSize" Value ="14"/> 
<Setter Property = "Width" Value = "100"/> 
<Setter Property = "Height" Value = "30"/> 
<Setter Property = "BorderThickness" Value = "5"/> 
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<Setter Property = "BorderBrush" Value = "Red"/> 
<Setter Property = "FontStyle" Value = "Italic"/> 
<1-- 以 下 的 setter 只 有 在 文本 框 获取 焦点 并 且 和 饼 标 悬 停 在 文本 框 之 上 时 才 会 执行 --> 
<Style.Triggers> 
<MultiTrigger> 
<MultiTrigger.Conditions> 
<Condition Property = "IsFocused" Value = "True"/> 
<Condition Property = "IsMouseOver" Value = "True"/> 
</MultiTrigger.Conditions> 
<Setter Property = "Background" Value = "Yellow"/> 
</MultiTrigger> 
</Style.Triggers> 
</Style> 


1 上 


30.5.8 动画 样式 


样式 还 可 以 合并 启动 动画 序列 的 触发 器 。 例 如 如 下 的 样式 ， 将 其 应 用 于 Button 控 件 ， 当 鼠标 悬 停 
在 按钮 表面 时 ， 按 钮 将 会 改变 大 小 : 


《1-- 放大 的 按钮 样式 --> 
<Style x:Key = "GrowingButtonStyle" TargetType="Button"> 

<Setter Property = "Height" Value = "40"/> 

<Setter Property = "Width" Value = "100"/> 

<Style.Triggers> 

<Trigger Property = "IsMouseOver" Value = "True"> 
<Trigger.EnterActions> 
<BeginStoryboard> 
<Storyboard TargetProperty = "Height"> 
<DoubleAnimation From = "40" To = "200" 
Duration = "0:0:2" AutoReverse="True"/> 


</Storyboard> 
</BeginStoryboard> 
</Trigger.EnterActions> 
</Trigger> 
</Style.Triggers> 
</Style> 


这 里 ， 触 发 器 集合 的 触发 条 件 是 IsMouse0ver 属 性 返回 true。 如 果 条 件 成 立 ， 我们 定义 的 
<Trigger.EnterActions> 元 素 会 执行 简单 的 演示 图 板 , 在 2 秒 之 内 将 按钮 的 Height 值 改 为 200 ( 然后 再 改 
回 40 )。 如 果 你 还 需要 改变 其 他 的 属性 ， 可 以 定义 一 个 <Trigger.ExitActions> 作 用 域 ， 并 在 内 部 放置 
一 些 当 IsMouse0ver 为 false 时 的 自 定 义 行 为 。 


30.5.9 ”以 编程 方式 设置 样式 


应 用 样式 也 可 以 在 运行 时 进行 。 如 果 要 让 最 终 用 户 选 择 UI 的 外 观 ， 或 需要 强制 使 用 安全 设置 ( 例 
如 DisableAllButton 样 式 ) 的 外 观 ， 这 将 非常 有 帮助 。 

在 本 项 目 中 ， 你 已 经 定义 了 很 多 样式 ， 它 们 大 多 数 都 可 以 应 用 于 Button 控 件 。 现 在 ， 我 们 来 重组 
主 窗 体 的 UI， 使 用 户 在 ListBox 中 选择 这 些 样式 。 我 们 将 基于 用 户 的 选择 来 应 用 相应 的 样式 。 以 下 是 
新 的 (也 是 最 终 的 ) <Window> 元 素 的 标记 : 


<Window x:Class="WpfStyles.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
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Height="350" Title="A Window with Style!" 
Width="525" WindowStartupLocation="CenterScreen"> 


<DockPanel > 
<StackPanel Orientation="Horizontal" DockPanel.Dock="Top"> 
<Label Content="Please Pick a Style for this Button" Height="50"/> 
<ListBox x:Name ="lstStyles" Height ="80" Width ="150" Background="LightBlue" 
SelectionChanged ="comboStyles Changed" /> 
</StackPanel> 
<Button x:Name="btnStyle" Height="40" Width="100" Content="OK!"/> 
</DockPanel> 


</Window> 
ListBox 控 件 ( 名 称 为 lststyles ) 将 在 窗 体 的 构造 函数 中 动态 填充 : 


public MainWindow() 
{ 


InitializeComponent(); 


// 用 所 有 的 Button 样 式 填充 下 拉 列 表 
lstStyles.Items.Add("GrowingButtonStyle"); 
lstStyles.Items.Add("TiltButton"); 
lstStyles.Items.Add("BigGreenButton"); 
lstStyles.Items.Add("BasicControlStyle"); 


3 


最 后 我 们 在 相应 的 代码 文件 中 处 理 SelectionChanged 事 件 。 代 码 如 下 ， 注 意 我 们 是 如 何 使 用 继承 


的 TryFindResource() 方 法 通过 名 称 提取 当前 资源 的 : 


private void comboStyles Changed(object sender, SelectionChangedEventArgs e) 


// 在 下 拉 列 表 中 获取 选中 的 样式 名 称 

Style currStyle = (Style) 
TryFindResource(lstStyles.SelectedValue); 

if (currStyle != null) 


// 设置 按钮 类 型 的 样式 


this.btnStyle.Style = currStyle; 
} 


} 
启动 该 应 用 程序 ， 你 可 以 在 运行 时 选择 这 4 种 按钮 样式 之 一 。 图 30-14 显 示 了 完整 的 应 用 程序 。 
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源 代码 ”WpfStyles 项 目的 源 代 码 位 于 Chapter 30 子 目录 下 。 


30.6 ”小 结 


本 章 第 一 部 分 介绍 了 人 WPF 的 资源 管理 系统 。 我 们 首先 介绍 了 如 何 使 用 二 进 制 资源 ， 紧 接着 介绍 了 
对 象 资源 的 作用 。 正如 你 所 学 习 到 的 那样 , 对 象 资源 是 XAML 的 二 进 制 对 象 , 可 以 存储 在 不 同 的 位 置 ， 
以 便 复 用 。 

接 下 来 我 们 学 习 了 WPF 的 动画 框架 。 我 们 分 别 使 用 C# 代 码 和 XAML 创 建 了 一 些 动画 。 如 果 使 用 标 
记 定 义 动 画 ， 需 要 使 用 <storyboard> 元 素 和 触发 器 来 控制 动画 的 执行 。 最 后 我 们 介绍 了 在 图 形 、 对 象 
资源 和 动画 中 大 量 使 用 的 WPF 样 式 机 制 。 





依赖 属性 、 路 电 事件 和 模板 








章 是 介绍 WPF 编 程 模型 的 最 后 一 章 ， 将 介绍 构建 自 定义 控件 的 过 程 。 尽 管内 容 模 型 和 样式 
机 制 可 以 为 标准 的 WPF 控 件 添加 一 些 独特 的 约束 ,但 在 构建 自 定义 模板 和 UserControl 的 过 
程 中 ,我 们 可 以 完全 定义 控件 呈现 输出 结果 、 响 应 状态 转换 、 以 及 融入 WPF API 的 方式 。 
本 章 开始 介绍 了 创建 自 定义 控件 时 两 个 比较 重要 的 话题 ， 依 赖 属性 ( dependency property ) 和 路 
由 事件 ( routed event )。 理 解 了 这 两 个 话题 之 后 ， 将 学 习 上 默认 模板 的 作用 以 及 如 何在 运行 时 以 编程 方 
式 查 看 它们 。 黄 定 了 这 个 基础 之 后 ,本章 的 剩余 部 分 将 介绍 如 何 构建 自 定义 控件 ， 以 及 如 何 使 用 WPF 
触发 器 框架 添加 视觉 线索 。 


说 明 ”构建 产品 级 模板 肯定 需要 使 用 Expression Blend， 因 为 它 内 嵌 了 大 量 模 板 工具 。 在 这 里 我 们 构 
建 一 些 简单 的 可 以 用 Visual Studio 创 建 的 模板 。 再 次 说 明 ， 关 于 Blend IDE 的 详细 内 容 ， 请 参考 
拙 作 Pro Expression Blend ( Apress 2011 )。 


31.1 依赖 属性 的 作用 


与 其 他 .NETAPI 一 样 ，WPF 在 内 部 实现 中 使 用 了 .NET 类 型 系统 中 的 所 有 类 型 ( 类、 结构 、 接 口 、 
委托 、 枚 举 ) 和 所 有 类 型 成 员 ( 属性 、 方 法 、 事 件 、 常 量 、 只 读 字段 等 )。 不 过 ，WPF 还 提供 了 一 个 
其 他 API 里 没有 的 编程 概念 一 一 依赖 属性 。 

与 “普通 ”的 .NET 属 性 (通常 在 WPF 的 文献 中 称 为 CLR 属 性 ) 一 样 ， 依 赖 属性 可 以 通过 XAMIL 或 
C# 代 码 进行 设置 ， 它 们 最 终 都 封装 了 类 的 数据 字段 ， 并 且 可 以 设置 为 只 读 、 只 写 或 可 读 写 。 

更 有 趣 的 是 ， 在 大 多 数 情况 下 你 都 不 会 意识 到 所 设置 (或 访问 ) 的 其 实 是 依赖 属性 ， 而 不 是 CLR 
属性 。 例 如 ，WPF 控 件 从 FrameworkElement 继 承 的 Height 和 Width 属 性 ， 以 及 从 ControlContent 继 承 的 
Content 成 员 ， 实 际 上 都 是 依赖 属性 : 


《!-- 设置 依赖 属性 --> 
<Button x:Name = "btnMyButton" Height = "50" Width = "100”Content = "OK"/> 


既然 如 此 相似 ，WPF 为 什么 还 要 定义 这 样 一 个 新 的 概念 呢 ? 答案 在 于 依赖 属性 在 类 的 内 部 是 如 何 
实现 的 。 稍 后 你 将 看 到 代码 示例 , 而 此 时 , 我 们 从 一 个 更 高 的 层次 来 看 看 依赖 属性 所 遵循 的 创建 方式 。 

口 首先 ， 定 义 依赖 属性 的 类 在 其 继承 链 中 必须 包含 DependencyObject。 

口 一 个 依赖 属性 在 类 中 表示 为 一 个 公共 的 、 静 态 的 、 类 型 为 DependencyProject 的 只 读 字段 。 按 
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照 惯例 ， 该 字段 的 命名 方式 为 CLR 属 性 名 加 上 Property 后 级 ( 参见 最 后 一 条 )。 

口 通过 调用 静态 方法 DependencyProperty.Register() 可 以 注册 DependencyProperty 变 量 ， 这 通常 
发 生 在 静态 构造 也 数 中 或 内 联 于 变量 声明 时 。 

口 最 后 ,将 在 类 中 定义 一 个 XAML 友 好 的 CLR 属 性 ， 它 调用 Dependency0bject 提 供 的 方法 来 获取 
或 设置 值 。 

依赖 属性 的 实现 提供 了 众多 强大 的 特性 ， 可 以 应 用 于 各 种 WPF 技 术 之 中 , 包括 数据 绑 定 、 动 画 服 
务 、 样 式 等 。 简 而 言 之 ， 依 赖 属 性 的 目的 是 提供 一 种 方式 ， 用 来 计算 基于 其 他 输入 值 的 属性 的 值 。 以 
下 是 依赖 属性 的 主要 优点 ， 它 们 的 功能 远 不 止 是 CLR 属 性 对 于 数据 的 简单 封装 。 

口 依赖 属性 可 以 从 XAML 定 义 的 父 元 素 中 继承 值 。 例 如 ， 如 果 在 开放 的 <Window> 标 记 中 定义 了 

FontSize 特 性 的 值 ， 那 么 该 Mindow 中 所 有 的 控件 默认 字体 大 小 都 是 相同 的 。 

口 依赖 属性 允许 由 XAML 作 用 域内 的 元 素来 设置 值 , 例如 Button 可 以 设置 父 元 素 DockPanel 的 Dock 

属性 。( 类 似 第 28 章 中 的 附加 属性 ， 其 实 附加 属性 也 是 依赖 属性 的 一 种 形式 。) 

口 依赖 属性 允许 WPF 通 过 多 个 外 部 的 值 来 计算 属性 值 ， 这 对 于 动画 和 数据 绑 定 服务 是 非常 重 

要 的 。 

口 依赖 属性 提供 了 WPF 触 发 器 的 底层 支持 〈 同样 也 常用 于 动画 和 数据 绑 定 )。 

记 住 ， 在 很 多 情况 下 与 依赖 属性 的 交互 和 与 普通 CLR 属 性 的 交互 是 完全 一 样 的 ( 这 有 赖 于 XAML 
的 封装 )。 但 是 ， 在 介绍 第 28 章 中 的 数据 绑 定 时 ， 我 们 了 解 到 如 果 要 在 代码 中 建立 数据 绑 定 ， 必 须 调 
用 目标 对 象 的 SetBinding() 方 法 ， 并 指定 要 操作 的 依赖 属性 : 

private void SetBindings() 

Binding b = new Binding(); 
b.Converter = new MyDoubleConverter(); 


b.Source = this.mySB; 
b.Path = new PropertyPath("Value"); 


// 指定 依赖 属性 
this.labelSBThumb.SetBinding(Label.ContentProperty, b); 


} 


在 代码 中 启动 动画 的 代码 也 与 之 类 似 ,例如 第 30 章 的 : 


// 指定 依赖 属性 
rt.BeginAnimation(RotateTransform.AngleProperty, dblAnim); 


只 有 在 编写 自 定义 WPF 控 件 时 ,你 才 会 需要 建立 自 定义 依赖 属性 。 例 如 ， 如 果 你 正在 构建 一 个 包 
含 4 个 自 定义 属性 的 UserControl， 并 需要 这 些 属性 能 够 和 WPF API 很 好 地 集成 ， 这 时 就 需要 用 依赖 属 
性 逻辑 来 进行 编码 。 

有 具体 来 说 ， 如 果 自 定义 属性 需要 使 用 数据 绑 定 或 操作 动画 ， 或 者 在 发 生 改 变 时 需要 广播 ， 或 者 必 
须 像 WPF 样 式 中 的 Setter 那 样 工 作 , 或 者 必须 能 够 从 父 元 素 那 里 接收 值 ， 那 么 普通 的 CLR 属 性 将 不 能 
满足 要 求 。 如 果 某 个 程序 员 使 用 了 普通 的 CLR 属 性 ， 那 么 其 他 程序 员 能 够 获取 或 设置 普通 CLR 属 性 的 
值 ; 但 如 果 其 他 程序 员 要 在 WPF 服 务 的 上 下 文中 使 用 这 些 属性 ， 将 不 会 像 期 望 的 那样 。 因 为 那个 程序 
员 永 远 无 法 了 解 其 他 人 希望 如 何 与 自 定 义 UserControl 类 中 的 属性 进行 交互 , 因此 在 构建 自 定 义 控件 时 
最 好 养 成 总 是 定义 依赖 属性 的 习惯 。 
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31.1.1 已 知 的 依赖 属性 


在 学 习 如 何 构建 自 定 义 依赖 属性 之 前 ， 我 们 先 来 看 看 FrameworkElement 类 中 的 Height 属 性 在 内 部 
是 如 何 实现 的 。 相 关 代 码 如 下 所 示 ( 包括 注释 )。 


// FrameworkElement 是 一 个 (is-a) Dependency0bject 
public class FrameworkElement : UIElement, IFrameworkInputElement, 
IInputElement, ISupportInitialize, IHaveResources, IQueryAmbient 


”7/ pependencyproperty 类 型 的 静态 只 读 字段 
public static readonly DependencyProperty HeightProperty; 


// 字段 常常 在 类 的 静态 构造 函数 中 进行 注册 


static FrameworkElement() 


HeightProperty = DependencyProperty.Register( 

"Height", 

typeof(double), 

typeof(FrameworkElement), 

new FrameworkPropertyMetadata( (double) 1.0 / (double) 0.0， 
FrameworkPropertyMetadataOptions.AffectsMeasure, 
new PropertyChangedCallback(FrameworkElement .OnTransformDirty)), 

new ValidateValueCallback(FrameworkElement.IsWidthHeightValid)); 


// CLR 包 装 器 ， 通 过 继承 的 GetValue()/SetValue() 方 法 实现 
public double Height 


get { return (double) base.GetValue(HeightProperty); } 
set { base.SetValue(HeightProperty, value); } 


} 
} 


如 你 所 见 ， 依 赖 属性 比 普通 CLR 属 性 所 需 的 代码 要 多 得 多 ! 而 实际 上 也 可 能 比 这 更 复杂 ( 幸运 的 
是 ,许多 实现 都 要 比 Height 简 单 )。 

首先 , 如 果 一 个 类 要 定义 依赖 属性 , 那么 它 的 继承 链 上 必须 有 Dependency0bject, 该 类 定义 了 CLR 
包装 器 所 需 的 GetValue() 和 SetValue() 方 法 。FrameworkElement 是 一 个 (is-a ) Dependency0bject， 可 以 
满足 该 要 求 。 

其 次 ,保存 实际 属性 值 ( 本 例 中 的 Height 为 double 类 型 ) 的 实体 表示 为 一 个 公共 的 、 静 态 只 读 的 
DependencyProperty 类 型 的 字段 。 按照 惯例 , 该 字段 的 名 称 通常 为 相关 的 CLR 包 装 器 名 称 加 上 Property 
作为 后 级 ， 例 如 : 

public static readonly DependencyProperty HeightProperty; 

由 于 依赖 属性 为 静态 字段 ， 它 们 通常 在 类 的 静态 构造 函数 内 部 创建 ( 和 注册 )。Dependency- 
Property 对 象 由 静态 方法 DependencyProperty.Register() 创 建 。 该 方法 包含 多 个 重 载 。 不 过 对 于 Height 
来 说 ，DependencyProperty.Register() 的 调用 如 下 : 


HeightProperty = DependencyProperty.Register( 
"Height", 
typeof(double), 
typeof (FrameworkElement), 
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new FrameworkPropertyMetadata((double)0.0， 
FrameworkPropertyMetadataOptions.AffectsMeasure, 
new PropertyChangedCallback(FrameworkElement.OnTransformDirty)), 
new ValidateValueCallback(FrameworkElement.IsWidthHeightValid)); 


DependencyProperty.Register() 方 法 的 第 一 个 参数 为 该 类 中 普通 CLR 属 性 的 名 称 ( 本 例 中 为 
Height )。 第 二 个 参数 为 它 封装 的 数据 类 型 的 类 型 信息 ( double )。 第 三 个 参数 指定 了 该 属性 所 属 的 类 
的 类 型 信息 〈 FrameworkElement )。 这 看 起 来 好 像 有 些 多 余 (毕竟 FrameworkElement 类 已 经 定义 了 
HeightProperty 字 段 ), 但 这 正 是 WPF 的 绝妙 之 处 , 你 可 以 在 一 个 类 中 注册 男 一 个 类 的 依赖 属性 ( 即使 
那个 类 是 封闭 的 ! )。 

DependencyProperty.Register() 的 第 四 个 参数 真正 赋予 了 依赖 属性 独 有 的 特色 。Framework- 
PropertyMetadata 对 象 描述 了 各 种 细节 ， 包 括 WPF 如 何 处 理 该 属性 的 回调 通知 ( 如 果 属 性 在 更 改 时 需 
要 进行 通知 )， 以 及 由 FrameworkPropertyMetadata0ptions 枚 举 表示 的 选项 ， 用 来 控制 属性 的 行为 (是 
否 可 以 进行 数据 绑 定 ， 可 和 否 被 继承 ， 等 等 )。FrameworkpPropertyMetadata 可 以 像 下 面 这 样 分 解 : 


new FrameworkPropertyMetadata( 
// 属性 的 默认 值 
(double)0.0， 


// 元 数据 选项 
FrameworkPropertyMetadataOptions.AffectsMeasure, 


// 属性 更 改 时 调用 的 委托 
new PropertyChangedCallback(FrameworkElement.OnTransformDirty) 


) 

FrameworkPropertyMetadata 构 造 函 数 的 最 后 一 个 参数 为 一 个 委托 ， 它 的 构造 函数 的 参数 指向 了 
FrameworkElement 类 中 的 静态 方法 0nTransformDirty()。 我 不 想 列 出 该 方法 的 后 台 代 码 , 但 要 记 住 的 是 
任何 时 候 我 们 要 创建 自 定 义 依赖 属性 , 都 可 以 指定 PropertyChangedCallback 委 托 , 使 其 指向 一 个 方法 ， 
该 方法 会 在 属性 值 发 生 改变 的 时 候 调 用 。 

DependencyProperty.Register() 方 法 的 最 后 一 个 参数 是 一 个 ValidateValueCallback 类 型 的 委托 ， 
它 指 向 了 FrameworkElement 类 中 的 一 个 方法 ， 用 来 确保 为 属性 设置 的 值 是 有 效 的 : 

new ValidateValueCallback(FrameworkElement.IsWidthHeightValid) 
我 们 习惯 将 该 方法 内 的 逻辑 放置 在 属性 的 set 块 中 (详细 内 容 将 在 下 节 介绍 ): 


private static bool IsWidthHeightValid(object value) 


double num = (double) value; 

return ((!DoubleUtil.IsNaN(num) && (num >= 0.0)) 
&& !double.IsPositiveInfinity(num) ) ; 

二 a 


注册 了 pependencyProperty 对 象 之 后 , 剩 下 的 任务 就 是 用 普通 的 CLR 属 性 ( 本 例 中 为 Height ) 封装 
该 字段 。 但 要 注意 的 是 ，get 和 set 作 用 域 并 不 是 简单 地 返回 或 设置 类 级 别 的 double 成 员 变量 ， 而 是 间 
接地 使 用 System.Windows.Dependency0bject 基 类 的 Getvalue() 和 Setvalue() 方 法 : 

double Height 


get { return (double) base.GetValue(HeightProperty); } 
set { base.SetValue(Heightproperty, value); } 
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31.1.2” CLR 属性 包装 器 的 重要 说 阴 


在 XAML 或 代码 中 获取 或 设置 依赖 属性 与 操作 普通 的 属性 没什么 区 别 , 但 是 它们 的 后 台 实 现 却 使 
用 了 更 加 复杂 的 编码 技术 。 记 住 ， 我 们 之 所 以 这 么 做 ， 是 想 构建 一 个 包含 自 定义 属性 的 自 定 义 控件 ， 
该 控件 通过 这 些 自 定义 属性 与 那些 需要 和 依赖 属性 通信 的 WPF 服 务 (如 动画 、 数 据 绑 定 、 样 式 ) 进行 
集成 。 

尽管 定义 CLR 包 装 器 是 依赖 属性 实现 的 一 部 分 ， 但 你 不 能 在 set 块 中 添加 验证 远 辑 。 并 且 ， 依 赖 
属性 的 CLR 包 装 器 除了 调用 GetValue() 和 SetValue() 之 外 也 不 能 做 其 他 任何 事情 。 

这 是 由 WPF 运 行 时 的 构造 方式 决定 的 。 当 你 用 XAML 设 置 属性 时 ， 如 

<Button x:Name="myButton" Height="100" .../> 

运行 时 将 完全 绕 过 Height 属 性 的 set 块 而 直接 调用 SetValue() 方 法 ! 这 么 做 尽管 怪异 , 但 却 可 以 进 
行 简单 的 优化 。 如 果 WPF 运 行 时 直接 访问 Height 属 性 的 set 块 ,需要 执行 运行 时 反射 才能 找到 
DependencyProperty 字 段 ( 由 SetValue() 的 第 一 个 参数 指定 ) 的 位 置 , 然后 在 内 存 中 引用 , 等 等 。 同样 ， 
在 XAML 中 获取 Height 属 性 的 值 ， 也 是 直接 调用 了 GetValue() 方 法 。 

既然 这 样 ， 为 什么 还 要 构建 CLR 包 装 器 呢 ? WPF XAML 不 允许 在 标记 中 调用 函数 ,因此 下 面 的 标 
记 会 报错 : 


<1-- 不 | 不 能 在 WPF XAML 中 调用 方 
<Button x:Name="myButton" this. a 100") . 


om stein ta 实际 上 是 在 告诉 WPF 运 行 时 :“ 嘿 ! 去 调用 
GetValue()/SetValue()， 在 标记 中 不 能 直接 访问 我 !” 那 么 ， 在 代码 中 调用 CLR 包 装 器 的 情况 如 何 呢 : 


Button b = new Button(); 
b.Height = 10; 


在 这 种 情况 下 , 不 再 涉及 WPF XAML 优 化 ,因此 Height 属 性 的 set 块 中 调用 setValue() 方 法 之 外 的 
其 他 代码 也 会 被 执行 。 

需要 记 住 的 一 条 基本 规则 是 ， 由 于 在 注册 依赖 属性 时 ， 使 用 ValidateValueCallback 委 托 指定 了 一 
个 执行 数据 校 验 的 方法 ， 因 此 可 以 确保 行为 的 正确 性 ， 而 不 必 关 心 是 使 用 XAML 还 是 代码 来 获取 或 设 
置 依赖 属性 。 
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如 果 你 对 本 章 以 上 内 容 感到 有 点 头疼 ， 这 完全 是 正常 的 反应 。 你 需要 花 点 时 间 才 能 适应 依赖 属 
性 。 但 是 无 论 如 何 ， 这 是 构建 许多 自 定 义 WPF 控 件 所 必须 了 解 的 部 分 ， 因 此 我 们 来 看 看 如 何 创建 依 
赖 属性 。 

新 建 一 个 WPF 应 用 程序 CustomDepPropApp， 打 开 Project 菜 单 ， 单 击 Add User Control 菜 单 选项 ， 
创建 一 个 名 为 ShowNumberControl.xaml 的 控件 (如 图 31-1 所 示 )。 
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图 31-1 ”添加 新 的 自 定义 UserControl 


说 了 明 ”本章 后 面 将 详细 介绍 WPF UserContr1， 现 在 只 需要 按部就班 地 跟着 做 就 可 以 了 。 


和 窗 体 一 样 ，WPF UserControl 类 型 也 包含 一 个 XAML 文 件 和 一 个 相关 的 代码 文件 。 更 新 控件 的 
XAML， 在 Grid 内 定义 一 个 Label 控 件 : 


<UserControl x:Class="CustomDepPropApp.ShowNumberControl" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="300"> 
<CGrid> 

<Label x:Name="numberDisplay" Height="50" Width="200" Background="LightBlue"/> 

</Grid> 

</UserControl> 


在 该 自 定 义 控件 的 代码 文件 中 创建 一 个 普通 的 NET 属 性 , 该 属性 的 类 型 为 jnt, 并 且 使 用 新 的 值 设 
置 Label 的 Content 属 性 : 


public partial class ShowNumberControl : UserControl 
public ShowNumberControl() 
{ 


InitializeComponent(); 


// 普通 的 .NET 属 性 
private int currNumber = 0; 
public int CurrentNumber 


get { return currNumber; } 
set 
{ 
currNumber = value; 
numberDisplay.Content = CurrentNumber.ToString(); 
} 
小 


31.2 构建 自 定 义 依 赖 属性 


现在 ， 更 新 窗 体 的 XAML 定 义 ， 在 StackPanel 布 局 管理 器 内 声明 自 定义 控件 的 实例 。 由 于 我 们 的 
自 定义 控件 不 属于 核心 WPF 程 序 集 栈 ， 你 需要 自 定义 一 个 XAML 命 名 空间 来 映射 控件 〈 详 见 第 27 章 )。 


标记 如 下 所 示 : 


<Window x:Class="CustomDepPropApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:myCtrls="clr-namespace:CustomDepPropApp" 
Title="Simple Dependency Property App” Height="150" Width="250" 
WindowStartupLocation="CenterScreen"> 


<StackPanel> 
<myCtrls:ShowNumberControl x:Name="myShowNumberCtrl" CurrentNumber="100"/> 
</StackPanel> 
</Window> 


如 你 所 见 ，Visual Studio 设 计 器 可 以 正确 显示 我 们 设置 的 CurrentNumber 属 性 的 值 ( 如 图 31-2 所 示 )。 


MamiWindow.xaml” » Xx ShowNumberControlxami . be 
entre eee 
| 100 
De 下 


100% ~ LX] BL «ge wr ， 
BDesign 村 xsML 国 加 = | 
1 Simpie Dependency Vroperty App” Height= iY Wigths 206 4 
WindowStartupiocation="CenterScreen” > 
三 <StackPpanel> 
= <myCtrls :ShowNumberControl x:Name="myShowNumberCtrl” 
CurrentHumber="198"> 


a <myCtris:ShowNumberControl, Triggers> 


后 “EventTrigaer RoutedEvent = "myCtrls:ShowNumberControl ™ 
100% ~* 振 » 


图 31-2 属性 显示 正常 


但 是 , 如 果 对 CurrentNumber 属 性 执行 一 个 动画 , 使 其 值 在 10 秒 内 从 100 变 为 200 会 如 何 呢 ?” 想 要 在 


标记 中 实现 ， 就 要 像 下 面 这 样 修改 cmyCtrls :ShowNumberControl> 作 用 域 : 


<myCtrls:ShowNumberControl x:Name="myShowNumberCtr1” CurrentNumber="100"> 
<myCtrls: ShowNumberControl].Triggers> 
<EventTrigger RoutedEvent = "myCtrls:ShowNumberControl.Loaded"> 
<EventTrigger.Actions> 
<BeginStoryboard> 
<Storyboard TargetProperty = "CurrentNumber"> 
<Int32Animation From = "100" To = "200" Duration = "0:0:10"/> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger.Actions> 
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</EventTrigger> 
</myCtrls: ShowNumberControl.Triggers> 
</myCtrls:ShowNumberControl> 


运行 应 用 程序 ,动画 对 象 无 法 找到 合适 的 目标 , 因此 将 被 忽略 。 这 是 因为 CurrentNumber 属 性 没有 
被 注册 为 依赖 属性 ! 要 解决 这 个 问题 ， 回 到 自 定义 控件 的 代码 文件 中 ,将 当前 属性 的 逻辑 全 部 注释 掉 
(包括 私有 字段 )。 现 在 ， 将 鼠标 光标 放 到 类 的 作用 域内 ， 输 入 propdp 代 码 段 ( 如 图 31-3 所 示 )。 
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图 31-3 i 步 
输入 propdp 后 ， 连 按 两 次 Tab 键 。 代 码 段 展开 成 依赖 属性 的 基本 架构 ( 如 图 31-4 所 示 )。 
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图 31-4 ”展开 的 代码 段 
最 简单 的 CurrentNumber 属 性 如 下 所 示 : 


public partial class ShowNumberControl : UserControl 





public int CurrentNumber 


get { return (int)GetValue(CurrentNumberProperty); } 
set { SetValue(CurrentNumberProperty, value); } 
} 
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public static readonly DependencyProperty CurrentNumberProperty = 
DependencyProperty.Register("CurrentNumber", 
typeof(int)， 
typeof(ShowNumberControl) ， 
new UIPropertyMetadata(0)); 
i 
这 与 Height 属 性 的 实现 十 分 类 似 ， 只 不 过 代码 段 用 内 联 的 方式 注册 属性 ， 而 不 是 在 静态 构造 函数 
中 (两 种 方法 缘 可 )。 同 时 还 要 注意 这 里 使 用 UIPropertyMetadata 对 象 定义 整 型 的 默认 值 (0 )， 而 不 要 
使 用 复杂 的 FrameworkPropertyMetadata 对 象 。 


31.2.1 添加 数据 验证 例 程 


尽管 现在 已 经 有 了 依赖 属性 CurrentNumber, 但 动画 还 是 无 法 执行 。 接 下 来 要 调整 的 是 指定 一 个 函 
数 来 执行 一 些 数据 验证 逻辑 。 例 如 ， 确 保 CurrentNumber 的 值 介 于 0~500 之 间 。 

我 们 为 DependencyProperty.Register() 方 法 添加 最 后 一 个 参数 ValidatevalueCallback， 将 其 指向 
ValidateCurrentNumber 方 法 。 

ValidatevalueCallback 是 一 个 委托 ， 它 指向 包含 唯一 的 object 类 型 参数 并 返回 boo1 的 方法 。 这 里 
的 object 代 表 设 置 的 新 值 。ValidateCurrentNumber() 方 法 判断 该 值 是 否 在 允许 的 范围 内 ， 并 返回 true 
或 false: 


public static readonly DependencyProperty CurrentNumberProperty = 
DependencyProperty.Register("CurrentNumber", typeof(int), typeof(ShowNumberControl), 
new UIPropertyMetadata(100), 
new ValidateValueCallback(ValidateCurrentNumber)); 


public static bool ValidateCurrentNumber(object value) 


{ 
// 简单 的 业务 逻辑 。value 必 须 介 于 0~500 之 间 
if (Convert.ToInt32(value) >= 0 8& Convert.ToInt32(value) “= 500) 
return true; 
else 
return false; 
} 


31.2.2 ”响应 属性 的 改变 


现在 我 们 验证 了 数字 的 有 效 性 ， 但 还 是 无 法 显示 动画 。 我 们 需要 指定 UIPropertyMetadata 构 造 函 
数 的 第 二 个 参数 PropertyChangedCallback 对 象 。 该 委托 所 指向 的 方法 的 第 一 个 参数 为 Dependency0bject 
类 型 ， 第 二 个 参数 为 DependencyPropertyChangedEventArgs 类 型 。 首 先 ， 将 代码 改 为 如 下 形式 : 


// 注意 UIPTopeTrtyMetadata 构 造 函 数 的 第 二 个 参数 
public static readonly DependencyProperty CurrentNumberProperty = 
DependencyProperty.Register("CurrentNumber", typeof(int), typeof(ShowNumberControl), 
new UIPropertyMetadata(100, 
new PropertyChangedCallback(CurrentNumberChanged) )， 
new ValidateValueCallback(ValidateCurrentNumber)); 


在 CurrentNumberChanged() 方 法 内 ， 我 们 的 最 终 目 标 是 按照 CurrentNumber 属 性 设 定 的 值 修改 Label 
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的 Content。 但 一 个 很 大 的 问题 是 ，CurrentNumberChanged() 方 法 必须 是 静态 的 ， 因 为 它 被 静态 的 
DependencyProperty 对 象 所 使 用 。 那么 如 何 访问 当前 ShowNumberControl 的 实例 呢 ? 答案 是 使 用 第 一 个 
Dependency0bject 类 型 的 参数 ,而 新 的 值 可 以 从 接 下 来 的 事件 参数 中 得 到 。 以 下 是 改变 Label 的 Content 
属性 所 必需 的 代码 : 


private static void CurrentNumberChanged(DependencyObject dep0b]j， 
DependencyPropertyChangedEventArgs args) 


// 将 Dependency0bject 转 换 为 ShhowNumberControl 
ShowNumberControl c = (ShowNumberControl)depObj; 


// 从 ShowNumberControl 中 获取 Label 控 件 
Label theLabel = c.numberDisplay; 


// 用 新 的 值 设置 Label 
theLabel.Content = args.NewValue.ToString(); 


哎呀 ! 仅仅 改变 Label 的 输出 就 要 这 么 麻烦 。 但 这 么 做 的 好 处 是 依赖 属性 CurrentNumber 现 在 可 以 
应 用 WPF 样 式 、 动 画 和 数据 绑 定 操作 ， 等 等 。 如 果 运 行 应 用 程序 ， 你 应 该 能 看 见 值 不 停 地 改变 。) 

这 就 是 关于 WPF 依 赖 属性 的 内 容 。 我 希望 你 对 这 些 结构 的 功能 以 及 如 何 创 建 它 们 能 有 更 好 的 了 
解 ， 但 其 实 还 有 很 多 细节 没有 涵盖 在 内 。 

如 果 你 要 构建 大 量 包含 自 定义 属性 的 自 定义 控件 ， 请 查阅 .NET Framework 4.5 SDK 文 档 中 WPF 
Fundamentals 部 分 的 Properties 话 题 。 该 文档 包含 大 量 示 例 ， 如 构建 依赖 属性 、 附 加 属性 ， 配 置 属性 元 
数据 的 不 同方 式 ， 等 等 。 





源 代 码 CustomDepPropApp 项 目的 源 代 码 位 于 Chapter 31 子 目录 下 。 








31.3 ”路 由 事件 


属性 并 不 是 .NET 编 程 构造 为 了 适应 WPF API 所 进行 的 唯一 调整 。 标 准 的 CLR 事 件 模型 也 做 了 进 一 
步 的 完善 ， 以 确保 事件 的 处 理 方 式 能 够 适应 对 象 树 的 XAML 描 述 。 假设 有 一 个 新 的 WPF 应 用 程序 项 目 
WPFRoutedEvents。 更 新 初始 窗 体 的 XAML 描 述 ， 添 加 如 下 所 示 的 定义 了 一 些 复杂 内 容 的 <Button> 
控件 : 


<Button Name="btnClickMe" Height="75" Width = "250" 
Click ="btnClickMe Clicked"> 
<StackPanel Orientation ="Horizontal”"> 
<Label Height="50" FontSize ="20">Fancy Button!</Label> 
<Canvas Height ="50" Width ="100" > 
<Ellipse Name = "outerEllipse" Fill ="Green" Height ="25" 
Width ="50" Cursor="Hand" Canvas.Left="25" Canvas.Top="12"/> 
<Ellipse Name = "innerEllipse" Fill ="Yellow" Height = "15" Width ="36" 
Canvas.Top="17" Canvas.Left="32"/> 
</Canvas> 
</StackPanel> 
</Button> 
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注意 ， 在 <Button> 的 开放 式 定义 中 我 们 处 理 了 Click 事 件 ， 指 定 了 在 事件 触发 时 调用 的 方法 名 称 。 
Click 事 件 为 RoutedEventHandler 委 托 服 务 ， 它 要 求 事件 处 理 程序 的 第 一 个 参数 为 object， 第 二 个 参数 
为 System.Windows .RoutedEventArgs。 处 理 程序 的 实现 如 下 所 示 

public void btnClickMe Clicked(object sender, RoutedEventArgs e) 


{ 
// 单 击 按 知 时 的 操作 
MessageBox.Show("Clicked the button"); 


运行 应 用 程序 ， 单 击 按 钮 内 容 的 任何 部 位 ( 绿色 的 Ellipse、 黄 色 的 EIlipse 、Label 或 Button 的 表 
面 ) 都 会 显示 该 消息 框 。 这 很 好 。 想 象 一 下 如 果 你 必须 为 每 个 子 元 素 添加 click 事 件 处 理 程序 ， 将 是 
多 么 枯燥 的 事情 。 为 Button 的 各 个 部 分 创建 各 自 的 事件 处 理 程序 不 仅 将 带 来 繁重 的 工作 量 ， 而 且 最 终 
的 代码 也 难以 维护 。 

幸运 的 是 ，WPF 路 由 事件 ( routed event ) 将 确保 单 击 按钮 的 任何 部 分 都 能 自动 调用 唯一 的 Click 
事件 处 理 程序 。 简 而 言 之 ， 路 由 事件 模型 将 在 对 象 树 中 自动 向 上 (或 向 下 ) 传递 事件 ， 来 寻找 适当 的 
处 理 程 序 。 

具体 来 说 ， 一 个 路 由 事件 可 以 使 用 三 种 路 由 策略 ( routing strategy )。 如 果 事 件 在 对 象 树 中 从 初始 
的 位 置 向 上 移动 到 其 他 作用 域 ， 这 种 事件 称 为 冒 泡 事 件 (bubbling event )。 相 反 ， 如 果 事 件 从 最 外 层 
元 素 (如 Window ) 向 下 移动 到 初始 位 置 ， 这 种 事件 称 为 隧道 事件 (tunneling event )。 最 后 ， 如 果 事 件 
仅仅 在 初始 元 素 中 触发 并 处 理 (可 认为 是 普通 的 CLR 事 件 )， 这 种 事件 称 为 直接 事件 ( direct event )。 


31.3.1 路 由 冒 泡 事件 的 作用 


在 本 例 中 , 如 果 用 户 单 击 黄色 椭圆 , click 事 件 冒 泡 到 上 一 层 作 用 域 (Canvas ), 然后 是 StackPanel， 
最 后 到 达 click 事 件 处 理 程序 所 在 的 Button。 同样 ， 如 果 用 户 单 击 Label, 事件 冒 泡 到 stackpanel， 最 后 
到 达 Button 元 素 。 
有 了 这 种 冒 泡 路 由 事件 模式 ， 就 不 需要 为 组 合 控 件 的 所 有 成 员 分 别 注册 具体 的 Click 事 件 处 理 程 
序 。 不 过 ， 如 果 你 希望 对 同一 棵 对 象 树 上 的 多 个 元 素 执行 不 同 的 单 击 逻 辑 ， 也 是 可 以 实现 的 。 
假设 你 需要 对 outerEllipse 控 件 执行 不 同 的 单 击 逻 辑 。 首 先 处 理 该 子 元 素 的 MouseDown 事 件 ( 像 
Ellipse 这 样 的 图 形 呈 现 类 型 不 支持 单 击 事件 ， 但 它们 可 以 通过 MouseDown、MouseUp 等 事件 监控 鼠标 按 
钮 的 活动 ): 
<Button Name="btnClickMe" Height="75" Width = "250" 
Click ="btnClickMe Clicked"> 
<StackPanel Orientation ="Horizontal"> 
<Label Height="50" FontSize ="20">Fancy Button!</Label> 
<Canvas Height ="50" Width ="100" > 
<Ellipse Name = "outerEllipse" Fill ="Green" 
Height ="25" MouseDown ="outerEllipse MouseDown" 
Width ="50" Cursor="Hand" Canvas.Left="25"” Canvas.Top="12"/> 
<Ellipse Name = "innerEllipse" Fill ="Yellow" Height = "15" Width ="36" 
Canvas.Top="17" Canvas.Left="32"/> 
</Canvas> 


</StackPanel> 
</Button> 


然后 实现 一 个 适当 的 事件 处 理 程 序 ， 为 简便 起 见 ， 我 们 只 改变 主 窗 体 的 Title 属 性 : 
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public void outerEllipse MouseDown(object sender, MouseButtonEventArgs e) 


{ 
// 修改 窗 体 的 标题 
this.Title = "You clicked the outer ellipse!"; 


} 
这 样 ， 你 就 可 以 根据 用 户 单 击 的 位 置 〈 外 部 椭圆 或 按钮 的 其 他 范围 ) 而 执行 不 同 的 行为 。 





说 明 冒 冒 泡 路 由 事件 总 是 从 起 始点 移动 到 下 一 个 定义 的 作用 域 。 因此 在 本 例 中 ， OP 
事件 将 冒 泡 到 Canvas， 而 不 是 outerEllipse， 因 为 他 们 是 同 在 Canvas 作 用 域内 的 Ellipse 类 型 。 














31.3.2 ”继续 或 中 止 冒 泡 


现在 ,如 果 用 户 单 击 outerEllipse 对 象 , 将 触发 该 Ellipse 对 象 的 MouseDown 事 件 处 理 程序 ， 而 此 时 
事件 也 会 冒 泡 到 按钮 的 Click 事 件 。 如 果 和 希望 通知 WPF 停 止 在 对 象 树 中 的 冒 泡 ， 可 以 将 EventArgs 人 参数 
的 Handled 属 性 设置 为 true: 

public void outerEllipse MouseDown(object sender, MouseButtonEventArgs e) 


{ 
// 修改 窗 体 标题 
this.Title = "You clicked the outer ellipse!"; 


// 终止 冒 泡 
e.Handled = true; 


} 

这 时 ， 你 会 发 现 窗 体 的 标题 修改 了 ， 但 Button 的 Click 事 件 处 理 程序 显示 的 MessageBox 没 有 弹出 。 
概括 地 说 ， 路 由 冒 泡 事件 可 以 将 一 组 复杂 的 内 容 视 为 一 一 个 单独 的 逻辑 元 素 ( 如 Button ) 或 不 相关 的 项 
( 如 Button 中 的 Ellipse )。 


31.3.3 ”路 由 隧道 事件 的 作用 


严格 地 说 , 路 由 事件 在 本 质 上 既 可 以 冒 泡 ( 如 前 所 述 ) 也 可 以 隧道 传递 。 隧道 事件 ( 全 部 以 Preview 
前 缀 开头 ， 如 PreviewMouseDown ) 从 对 象 树 的 最 外 层 深入 到 内 层 作 用 域 。 一 般 来 说 ，WPF 基 础 类 库 中 
每 个 冒 泡 事件 都 有 一 个 与 之 对 应 并 且 在 其 之 前 触发 的 隧道 事件 。 例 如 ， 在 MouseDown 冒 泡 事件 触发 前 ， 
会 先 触发 PreviewMouseDown 隧 道 事 件 。 

处 理 隧道 事件 看 上 去 与 处 理 其 他 事件 没什么 不 同 。 只 需要 在 XAML 中 设置 事件 处 理 程序 的 名 称 
( 如 果 需 要 的 话 也 可 以 在 代码 文件 中 使 用 相应 的 C4 事件 处 理 语 看 法 )， 然 后 在 代码 文件 中 实现 处 理 程序 。 
为 了 演示 隧道 事件 和 冒 泡 事 件 的 相互 影响 ， 我 们 为 outerE11ipse 对 象 添加 PreviewMouseDown 事 件 : 


<Ellipse Name = "outerEllipse" Fill ="Green" Height ="25" 
MouseDown = "outerEllipse | MouseDown" 
PreviewMouseDown = "outerEllipse_ PreviewMouseDown" 
Width ="50" Cursor="Hand" Canvas.Left="25" Canvas.Top="12"/> 


接 下 来 ， 在 C# 类 中 添加 这 两 个 事件 处 理 程序 ( 为 所 有 对 象 )， 使 用 传人 的 事件 参数 对 象 向 一 个 
string 成 员 变 量 mouseActivity 中 追加 数据 。 这 有 助 于 我 们 观察 后 台 事件 的 触发 顺序 : 
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public partial class MainWindow : Window 


string mouseActivity = string.Empty; 
public MainWindow() 


InitializeComponent(); 


public void btnClickMe Clicked(object sender, RoutedEventArgs e) 


AddEventInfo(sender, e); 
MessageBox.Show(mouseActivity, "Your Event Info"); 


// 为 下 一 轮 次 清空 字符 囊 
mouseActivity = ""; 
private void AddEventInfo(object sender, RoutedEventArgs e) 
mouseActivity += string.Format( 
"{0} sent a {1} event named {2}.\n", sender, 
e.RoutedEvent.RoutingStrategy, 
e.RoutedEvent.Name); 


private void outerEllipse MouseDown(object sender, MouseButtonEventArgs e) 


AddEventInfo(sender, e); 


private void outerEllipse PreviewMouseDown(object sender, MouseButtonEventArgs e) 
AddEventInfo(sender, e); 
} 


注意 ， 这 里 我 们 没有 在 任何 一 个 事件 处 理 程序 中 停止 事件 的 冒 泡 过 程 。 运 行 该 程序 ， 单 击 按钮 上 
不 同 的 位 置 ， 将 显示 不 同 的 消息 框 。 图 31-5 显 示 了 单 击 outerEllipse 对 象 时 的 输出 结果 : 


d System.Windows.Shapes.Ellipse sent a Tunnel event named PreviewMouseDown. 
| System.Windows.Shapes.Ellipse sent a Bubble event named MouseDown. 


System.Windows.Controls.Button sent a Bubble event named Click. 





图 31-5” 先 隧道 ， 再 冒 泡 


那么 为 什么 WPF 事 件 要 成 对 出 现 呢 (一 个 隧道 事件 和 一 个 冒 泡 事件 ) ? 答案 是 通过 前 置 事件 ,你 
可 以 在 相应 的 冒 泡 事件 触发 之 前 执行 任何 特殊 的 逻辑 ( 数据 验证 、 禁 止 冒 泡 行 为 等 )。 假 设 你 有 一 个 
只 允许 输入 数字 的 TextBox， 你 可 以 处 理 PreviewKeyDown 事 件 ， 如 果 发 现 输入 的 数据 不 是 数字 ， 就 可 以 
将 Handled 属 性 设置 为 true 来 取消 冒 泡 事件 。 

正如 你 所 想 的 那样 ， 当 构建 包含 自 定义 事件 的 自 定义 控件 时 ,你 可 以 编写 类 似 的 可 以 在 XAML 树 
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中 冒 泡 (或 隧道 传递 ) 的 事件 。 本 章 将 不 介绍 如 何 构建 自 定义 路 由 事件 ( 其 过 程 与 构建 自 定义 依赖 属 
性 没什么 太 大 区 别 )。 如 果 感 兴趣 ， 可 以 浏览 .NET Framework 4.5 SDK 文 档 中 关于 Routed Events 
Overview 的 主题 ， 你 可 以 找到 大 量 辅助 教程 。 








源 代 码 ”WPFRoutedEvents 项 目的 源 代码 位 于 Chapter 31 子 目录 下 。 








31.4 ”逻辑 树 、 可 视 树 和 默认 模板 


在 开始 学 习 如 何 构 建 自 定义 控件 之 前 , 还 有 一 些 需要 研究 的 话题 。 特 别 是 需要 了 解 远 辑 树 (logical 
tree )、 可 视 树 ( visual tree ) 和 默认 模板 (default template ) 之 间 的 区 别 。 当 你 在 Visual Studio 或 类 似 
kaxaml.exe 这 样 的 工具 中 编写 XAML 时 ， 标 记 就 是 XAML 文 档 的 逻辑 视图 。 同 样 ， 当 你 用 C# 代 码 向 
StackPanel 控 件 中 添加 新 项 时 , 实际 上 是 在 向 逻辑 树 中 添加 新 项 。 从 本 质 上 讲 , 逻辑 视图 表示 主 Window 
(或 其 他 根 元 素 如 Page 、NavigationWindow ) 是 如 何在 不 同 的 布局 管理 器 中 定位 内 容 的 。 

然而 ,在 每 棵 逻辑 树 的 背后 ， 都 有 一 棵 默默 工作 着 的 可 视 树 。 在 后 台 ，WPF 用 更 加 复杂 的 可 视 树 
将 元 素 正 确 呈 现 到 屏幕 上 。 在 每 个 可 视 树 中 ， 都 会 有 更 加 详尽 的 模板 和 样式 用 来 呈现 各 个 对 象 ， 包括 
必要 的 绘图 、 形 状 、 可 视 化 和 动画 。 

了 解 逻 辑 树 和 可 视 树 的 区 别 是 十 分 有 用 的 ， 因 为 当 构 建 自 定 义 控件 模板 时 ， 你 实际 上 是 在 移 除 某 
个 控件 全 部 或 部 分 默认 的 可 视 树 ， 并 添加 你 自己 定义 的 内 容 。 因 此 ， 如 果 需 要 Button 控 件 呈 现 为 星 形 
形状 ， 你 需要 定义 一 个 星 型 模板 并 将 其 插入 到 Button 的 可 视 树 中 。 从 逻辑 角度 来 说 ， 该 Button 仍 然 为 
Button 类 型 ， 并 且 仍旧 支持 按钮 所 有 的 属性 、 方 法 和 事件 。 但 从 视觉 角度 来 说 ， 它 却 呈 现 出 完全 不 同 
的 外 观 。 正 是 该 特性 使 得 WPF 成 为 一 个 非常 有 用 的 API， 因 为 其 他 工具 要 想 制作 一 个 星 形 按钮 都 需要 
构建 一 个 胃 新 的 类 ， 而 用 WPF 则 只 需要 定义 一 个 新 的 标记 。 





说 明 “WPF 控 件 通常 被 描述 为 不 可 见 的 (lookless )。 这 是 因为 WPF 控 件 的 外 观 与 其 行为 是 完全 独立 的 
( 和 可 定制 的 )。 





31.4.1 ”以 编程 方式 查看 逻辑 树 


在 运行 时 分 析 窗 体 的 逻辑 树 并 不 是 一 个 常见 的 WPF 编 程 活动 , 不 过 值得 一 提 的 是 System.Windows 
命名 空间 定义 了 一 个 LogicalTreeHelper 类 ， 可 以 在 运行 时 查看 逻辑 树 的 结构 。 为 了 演示 逻辑 树 、 可 视 
树 和 空间 模板 之 间 的 联系 ， 我 们 创建 一 个 WPF 应 用 程序 TreesAndTemplatesApp。 

更 新 窗 体 的 标记 , 使 其 包含 两 个 Button 控 件 和 一 个 很 大 的 只 读 的 、 含 有 滚动 条 的 TextBox。 使 用 IDE 
为 两 个 按钮 添加 click 事件 处 理 程序 。XAML 如 下 所 示 : 


<Window x:Class="TreesAndTemplatesApp.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Trees and Templates" Height="518" 
Width="836" WindowStartupLocation="CenterScreen"> 
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<DockPanel LastChildFill="True"> 
<Border Height="50" DockPanel.Dock="Top" BorderBrush="Blue"> 
<StackPanel Orientation="Horizontal"> 
<Button x:Name="btnShowLogicalTree" Content="Logical Tree of Window" 
Margin="4" BorderBrush="Blue" Height="40"Click="btnShowLogicalTree Click"/> 
<Button x:Name="btnShowVisualTree" Content="Visual Tree of Window" 
BorderBrush="Blue" Height="40" Click="btnShowVisualTree Click"/> 
</StackPanel> 
</Border> 
<TextBox x:Name="txtDisplayArea" Margin="10" Background="AliceBlue" IsReadOnly="True" 
BorderBrush="Red" VerticalScrollBarVisibility="Auto" 
HorizontalScrollBarVisibility="Auto" /> 
</DockPanel> 


</Window> 

在 C# 代 码 文 件 中 ,定义 一 个 string 类 型 的 成 员 变 量 dataToShow。 在 btnShowLogicalTree 对 象 的 Click 
处 理 程序 中 ,调用 一 个 辅助 的 递归 方法 ， 将 Window 的 逻辑 树 信息 赋值 给 字符 串 变量 。 这 需要 调用 
LogicalTreeHelper 的 静态 方法 GetChildren()。 代 码 如 下 所 示 : 


private void btnShowLogicalTree Click(object sender, RoutedEventArgs e) 


dataToShow = ""; 
BuildLogicalTree(0, this); 
this.txtDisplayArea.Text = dataToShow; 


void BuildLogicalTree(int depth, object obj) 


{ 
// 将 类 型 的 名 称 追 加 到 dataToShow 成 员 变 量 中 
dataToShow += new string(' ', depth) + obj.GetType().Name + "\n"; 


// 如 果 该 项 不 是 Dependency0bject， 则 跳 过 
if (!(obj is Dependency0bject)) 
return; 


// 为 每 个 逻辑 子 元 素 进行 递归 
foreach (object child in LogicalTreeHelper.GetChildren( 
obj as DependencyObject)) 
BuildLogicalTree(depth + 5, child); 


运行 应 用 程序 并 单 击 第 一 个 按钮 ， 你 将 看 到 文本 框 内 打印 了 一 个 树 ， 这 是 初始 XAML 的 完美 重 现 
( 如 图 31-6 所 示 )。 
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图 31-6 ”在 运行 时 查看 逻辑 树 
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31.4.2 ”以 编程 方式 查看 可 视 树 


使 用 System.Windows.Media 命 名 空间 下 的 VisualTreeHelper 类 也 可 以 在 运行 时 查看 Window 的 可 视 
树 。 以 下 是 第 二 个 Button 控 件 (btnShowVisualTree ) 的 Click 实 现 ， 它 执行 类 似 的 递归 逻辑 来 构建 可 视 
树 的 文本 化 描述 : 

private void btnShowVisualTree Click(object sender, RoutedEventArgs e) 


dataToShow = ""; 

BuildVisualTree(0, this); 

this.txtDisplayArea.Text = dataToShow; 
} 


void BuildVisualTree(int depth, DependencyObject obj) 
{ 
// 将 类 型 的 名 称 追 加 到 dataToShow 成 员 变 量 中 
dataToShow += new string(' ', depth) + obj.GetType().Name + "\n"; 
// 为 每 个 可 视 子 节点 进行 递归 
for (int i = 0; i < VisualTreeHelper.GetChildrenCount(obj); i++) 
BuildVisualTree(depth + 1, VisualTreeHelper.GetChild(obj, i)); 


如 图 31-7， 可 视 树 暴 露 了 一 些 低级 别 的 呈现 代理 ， 如 ContentPresenter 、AdornerDecorator 、 
TextBoxLineDrawingVisual， 等 等 。 
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图 31-7 ”在 运行 时 查看 可 视 树 
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31.4.3 ”以 编程 方式 查看 控件 的 默认 模板 


WPF 中 的 可 视 树 可 以 用 来 理解 如 何 呈现 Window 及 其 包含 的 元 素 。 每 一 个 WPF 控 件 都 在 其 默认 模板 
内 保存 了 一 些 呈 现 指 令 。 以 编程 角度 来 说 , 任何 模板 都 可 以 表示 为 一 个 ControlTemplate 类 的 实例 。 同 
样 ， 你 也 可 以 通过 Template 属 性 获取 控件 的 默认 模板 : 


// 获取 Button 的 默认 模板 
Button myBtn = new Button(); 
ControlTemplate template = myBtn.Template; 


同样 ， 你 也 可 以 在 代码 中 创建 新 的 ControlTemplate 对 象 ， 并 将 其 赋值 给 控件 的 Template 属 性 : 


// 为 按钮 添加 一 个 新 的 模板 
Button myBtn = new Button(); 
ControlTemplate customTemplate = new ControlTemplate(); 


// 假设 该 方法 包含 创建 星 型 模板 的 所 有 代码 
MakeStarTemplate(customTemplate); 
myBtn.Template = customTemplate; 


尽管 你 可 以 使 用 代码 创建 新 的 模板 , 但 目前 比较 常见 方法 的 还 是 在 XAML 里 进行 创建 。 不 过 , 在 
开始 构建 你 自己 的 模板 之 前 , 我们 先 来 完成 当前 这 个 示例 ,使 其 能 够 在 运行 时 查看 WPF 控 件 的 默认 模 
板 。 这 样 可 以 了 解 模 板 的 整个 组 成 ， 是 十 分 有 用 的 。 首 先 ， 使 用 新 的 StackPanel 更 新 窗 体 标记 ， 其 父 
元 素 在 上 一 级 DockPanel 中 靠 左 停靠 ， 代码 如 下 : 


<Border DockPanel.Dock="Left" Margin="10" BorderBrush="DarkGreen" 
BorderThickness="4" Width="358"> 
<StackPanel> 
<Label Content="Enter Full Name of WPF Control" Width="340" FontWeight="DemiBold"” /> 
<TextBox x:Name="txtFullName" Width="340" BorderBrush="Green" 
Background="BlanchedAlmond" Height="22" 
Text="System.Windows.Controls.Button" /> 
<Button x:Name="btnTemplate" Content="See Template" BorderBrush="Green" 
Height="40" Width="100" Margin="5" 
Click="btnTemplate Click" HorizontalAlignment="Left" /> 
<Border BorderBrush="DarkGreen" BorderThickness="2" Height="260" 
Width="301" Margin="10" Background="LightGreen" > 
<StackPanel x:Name="stackTemplatePanel" /> 
</Border> 
</StackPanel> 
</Border> 


注意 这 个 空 的 StackPanel 元 素 stackTemplatePanel, 我 们 将 在 代码 中 引用 它 。 现在 窗 体 的 外 观 将 如 
图 31-8 所 示 。 

左上 方 的 文本 区 域 可 以 输入 位 于 PresentationFramework.dll 程 序 集中 的 某 个 WPF 控 件 的 完全 限定 
名 称 。 在 库 加 载 之 后 ， 你 可 以 动态 创建 该 对 象 的 实例 ， 并 在 左下 方 的 大 块 文本 区 域 中 显示 。 最 后 ， 控 
件 的 默认 模板 将 显示 在 右 侧 的 文本 区 域 中 。 首 先 ， 在 C# 类 中 添加 一 个 Control 类 型 的 成 员 变 量 : 

private Control ctrlToExamine = null; 

以 下 是 剩余 的 代码 ， 它 需要 引用 System.Reflection 、System.Xml 和 System.Nindows .Markup 命 名 空间 : 

private void btnTemplate Click(object sender, RoutedEventArgs e) 


dataToShow = ""; 
ShowTemplate(); 
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this.txtDisplayArea.Text = dataToShow; 


private void ShowTemplate() 


// 移 除 在 当前 预览 区 域 中 的 控件 

if (ctrlToExamine != null) 
stackTemplatePanel.Children.Remove(ctrlToExamine) ; 

try 


{ 
// 加 载 PresentationFramework， 创 建 指 定 控件 的 实例 ， 并 为 它 指 定 一 个 尺寸 用 于 显示 ， 


// 然后 添加 到 空 的 StackPanel 中 

Assembly asm = Assembly.Load("PresentationFramework, Version=4.0.0.0," + 
"Culture=neutral, PublicKeyToken=31bf3856ad364e35"); 

ctrlToExamine = (Control)asm.CreateInstance(txtFullName.Text); 

ctrlToExamine.Height = 200; 

ctrlToExamine.Width = 200; 

ctrlToExamine.Margin = new Thickness(5); 

stackTemplatePanel.Children.Add(ctrlToExamine); 


// 定义 一 些 XAML 设 置 ， 以 保持 缩 进 
XmlWriterSettings xmlSettings = new XmlWriterSettings(); 
xmlSettings.Indent = true; 


// 创建 一 个 StringBuilder 来 保存 XAML 
StringBuilder strBuilder = new StringBuilder(); 


// 创建 一 个 基于 设置 的 XmlWriter 
XmlWriter xWriter = XmlWriter.Create(strBuilder, xmlSettings); 


// 将 基于 ControlTemplate 的 XAML 保 存 到 XmlWriter 对 象 
XamlWriter.Save(ctrlToExamine.Template, xWriter); 


// 在 文本 框 中 显示 XAML 
dataToShow = strBuilder.ToString(); 


catch (Exception ex) 


dataToShow = ex.Message; 
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图 31-8 ”更 新 后 的 窗 体 UI 


31.5 使 用 触发 器 框架 构建 自 定 义 控件 模板 1075 


这 段 代 码 的 大 部 分 工作 是 将 已 编译 的 BAML 资 源 映 射 到 XAML 字 符 串 。 图 31-9 演 示 了 应 用 程序 最 


终 的 情形 ， 显 示 了 System.Windows.Controls.DatepPicker 控 件 的 默认 模板 。 
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图 31-9 ee 


希望 你 已 经 对 逻辑 树 、 可 视 树 以 及 控件 模板 如 何 合作 有 了 更 好 的 理解 。 现 在 ， 你 可 以 阅读 本 章 的 
剩余 部 分 ， 学 习 如 何 构 建 自 定义 模板 和 用 户 控件 。 





源 代 码 ”TreesAndTemplatesApp 项 目的 源 代码 位 于 Chapter 31 子 目录 下 。 





31.5 ”使 用 触发 器 框架 构建 自 定义 控件 模板 


仅仅 使 用 C# 代 码 就 可 以 为 控件 创建 自 定义 模板 。 这 时 , 你 需要 为 一 个 ControlTemplate 对 象 添 加 数 
据 ， 然 后 将 其 赋值 给 控件 的 Template 属 性 。 然 而 大 多 数 情况 下 ,我 们 使 用 XAML 定 义 ControlTemplate 
的 外 观 ， 并 添加 少量 代码 ( 也 可 能 是 大 量 代码 ) 来 驱动 运行 时 行为 。 

本 章 剩余 部 分 将 学 习 如 何 使 用 Visual Studio 构 建 自 定义 模板 。 同 时 还 将 学 习 WPF 触 发 器 框架 、 
Visual State Manager( VSM ) 以 及 如 何 使 用 动画 与 最 终 用 户 的 视觉 线索 交互 。 你 将 看 到 , 仅仅 使 用 Visual 
Studio 构 建 复杂 模板 将 需要 大 量 录入 工作 ， 并 显得 有 点 重量 级 。 毫 无 疑问 ， 产 品级 模板 还 是 要 利用 
Expression Blend 的 优势 。 不 过 ， 鉴 于 本 书 这 个 版 本 不 会 涵盖 Blend 的 内 容 ， 现 在 是 时 候 措 袖 子 项 键盘 
写 标记 了 。 


创建 一 个 全 新 的 WPF 应 用 程序 ButtonTemplate。 在 该 项 目 中 ,我 们 专注 于 创建 和 使 用 模板 的 机 制 ， 
因此 主 窗 体 的 标记 十 分 简单 : 


<Window x:Class="ButtonTemplate.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
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xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="Fun with Templates" Height="350" Width="525"> 
<StackPanel> 
<Button x:Name="myButton" Width="100" Height="100" 
Click="myButton Click"/> 
</StackPanel> 
</Window> 


在 Click 事 件 处 理 程序 中 ， 显 示 一 个 简单 的 消息 框 (通过 MessageBox.Show() 方 法 )， 输 出 一 条 确认 
单 击 控件 的 消息 。 记 住 ， 在 构建 自 定义 模板 时 ， 控 件 的 行为 是 不 变 的 ， 外 观 是 可 变 的 。 
这 时 ，Button 使 用 默认 的 模板 进行 呈现 。 如 上 一 个 示例 所 述 ， 默 认 模 板 是 一 个 位 于 WPF 程 序 集中 
的 BAML 资 源 。 在 定义 自己 的 模板 时 , 你 实际 上 是 用 你 创建 的 可 视 树 替换 默认 的 可 视 树 。 更 新 <Button> 
元 素 的 定义 ， 使 用 属性 元 素 语法 指定 新 的 模板 。 该 模板 使 控件 显示 为 圆 形 : 
<Button x:Name="myButton" Width="100" Height="100" 
Click="myButton Click"> 
<Button.Template> 
<ControlTemplate> 
<Grid x:Name="controlLayout"> 
<Ellipse x:Name="buttonSurface" Fill = "LightBlue"/> 
<Label x:Name="buttonCaption" VerticalAlignment = "Center" 
HorizontalAlignment = "Center" 
FontWeight = "Bold" FontSize = "20" Content = "OK!"/> 
</Crid> 
</ControlTemplate> 
</Button.Template> 
</Button> 


我 们 在 这 里 定义 了 一 个 模板 ， 包 含 一 个 命名 的 Grid 控 件 ， 该 6rid 内 部 为 命名 的 Ellipse 和 Label。 
由 于 没有 定义 Grid 的 行 和 列 ， 每 个 子 控件 都 将 以 内 容 为 中 心 堆 释 在 前 一 个 控件 的 上 方 。 现 在 ， 运 行 应 
用 程序 ， 你 会 发 现 只 有 鼠标 在 Ellipse 边 界 内 时 ，Click 事 件 才 会 触发 ( 即 在 圆 形 边缘 ， 正 方形 四 个 角 
的 地 方 不 会 触发 ) 这 是 WPF 模 板 架 构 中 一 个 非常 强大 的 特性 : 你 不 必 重 新 计算 命中 测试 、 边 界 检查 
或 其 他 底层 细节 。 因 此 ， 即 使 你 的 模板 使 用 polygon 对 象 呈现 不 规则 的 几何 图 形 ， 你 也 可 以 完全 放心 ， 
命中 测试 的 细节 是 与 控件 的 形状 相关 的 ， 而 不 是 其 外 围 较 大 的 矩形 边界 。 


31.5.1 模板 资源 


现在 ,模板 内 髋 于 特定 的 Button 控 件 ， 这 限制 了 重用 。 在 理想 情况 下 ， 我 们 应 该 将 模板 放置 于 资 
源 字典 中 , 这 样 就 可 以 在 多 个 项 目 中 使 用 这 个 圆 形 的 按钮 , 或 者 至 少将 它 移动 到 应 用 程序 资源 容器 中 ， 
从 而 在 当前 项 目 内 进行 重用 。 我 们 使 用 Visual Studio 将 本 地 Button 资 源 移动 到 应 用 程序 级 别 。 首先 , 在 
Properties 编 辑 器 中 找到 Button 的 Template 属 性 。 单 击 白色 方形 小 图 标 ， 选 择 Convertto New Resource... 
(如 图 31-10 所 示 )。 

在 弹出 的 对 话 框 中 , 将 新 模板 取 名 为 RoundButtonTemplate, 保存 在 Application 级 别 (也 就 是 保存 
在 App.xaml 中 ， 如 图 31-11 所 示 )。 


31.5 使 用 触发 器 框架 构建 自 定义 控件 模板 
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图 31-10 ”提取 本 地 资源 
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图 31-11 





Window: <no name> 


将 资源 放置 于 App.xaml 


这 时 ， 在 Application 对 象 标记 中 可 以 找到 如 下 数据 ; 


<Application x:Class="ButtonTemplate.App' 


xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 


StartupUri="MainWindow.xaml"> 
<Application.Resources> 
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< ControlTemplate x:Key="RoundButtonTemplate”TargetType="{x:Type Button}> 
<Grid x:Name="controlLayout"> 
<Ellipse x:Name="buttonSurface" Fill = "LightBlue"/> 
<Label x:Name="buttonCaption" VerticalAlignment = "Center" 
HorizontalAlignment = "Center" 
FontWeight = "Bold" FontSize = "20" Content = "OK!"/> 
</Grid> 
</ControlTemplate> 
</Application.Resources> 
</Application> 


现在 ， 由 于 该 资源 可 用 于 整个 应 用 程序 ， 我 们 可 以 用 它 来 定义 任意 多 个 圆 形 按钮 。 为 了 测试 ， 继 
续 创 建 两 个 使 用 该 模板 的 Button 控 件 〈 不必 处 理 它们 的 Click 事 件 )。 


<StackPanel> 
<Button x:Name="myButton" Width="100" Height="100" 
Click="myButton Click" 
Template="{StaticResource RoundButtonTemplate}"></Button> 
<Button x:Name="myButton2" Width="100" Height="100" 
Template="{StaticResource RoundButtonTemplate}"></Button> 
<Button x:Name="myButton3" Width="100" Height="100" 
Template="{StaticResource RoundButtonTemplate}"></Button> 
</StackPanel> 


31.5.2 ”使 用 触发 器 添加 可 视 提 示 


定义 自 定义 模板 时 ， 所 有 默认 模板 的 可 视 提 示 也 随 之 移 除 。 例 如 ， 默 认 的 按钮 模板 包含 一 些 标记 ， 
在 某 个 UI 事件 触发 时 ( 如 获取 焦点 、 鼠 标 单 击 、 激 活 或 禁用 等 )， 这 些 标记 将 通知 控件 显示 什么 样 的 外 
观 。 用 户 早已 习惯 了 这 些 可 视 提 示 ， 因 为 它 使 控件 有 一 种 触觉 响应 的 感觉 。 但 是 ，RoundButtonTemplate 
没有 定义 这 些 标记 ， 因 此 无 论 鼠 标 怎么 移动 ， 控 件 的 外 观 都 不 会 发 生 任何 改变 。 理 想 情 况 下 ， 当 控件 被 
单 击 时 应 该 有 细小 的 差别 ( 如 颜色 变化 或 显示 阴影 )， 以 使 用 户 知 道 控 件 的 可 视 状 态 发 生 了 改变 。 

在 WPF 首 次 发 布 时 ， 添 加 这 种 可 视 提 示 的 方法 是 向 模板 中 添加 一 些 触 发 器 ， 当 触发 器 的 条 件 为 
true 时 ， 将 改变 对 象 属性 的 值 或 开始 一 个 动画 演示 图 板 (或 两 者 同时 )。 用 下 面 的 标记 更 新 
RoundButtonTemplate， 当 鼠标 蕙 浮 在 按钮 表面 时 ， 按 钮 的 背景 色 将 变 为 蓝 色 ， 前 景色 将 变 为 黄色 : 


<ControlTemplate x:Key="RoundButtonTemplate" TargetType="Button" > 
<Grid x:Name="controlLayout"> 
<Ellipse x:Name="buttonSurface" Fill="LightBlue" /> 
<Label x:Name="buttonCaption" Content="OK!" FontSize="20" FontWeight="Bold" 
HorizontalAlignment="Center" VerticalAlignment="Center" /> 
</Grid> 
<ControlTemplate. Triggers> 
<Trigger Property = "IsMouseOver" Value = "True"> 
<Setter TargetName = "buttonSurface" Property = "Fill" Value = "Blue"/> 
<Setter TargetName = "buttonCaption" Property = "Foreground" 
Value = "Yellow"/> 
</Trigger> 
</ControlTemplate. Triggers> 
</ControlTemplate> 


再 次 运行 程序 ， 当 鼠标 进入 或 离开 Ellipse 区 域 时 ,颜色 将 发 生 改变 。 下 面 是 另 一 个 触发 器 , 它 将 
在 鼠标 按 下 时 缩小 Grid ( 及 其 所 有 子 元 素 ) 的 尺寸 。 将 以 下 代码 添加 到 <ControlTemplate.Triggers> 
集合 中 : 
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<Trigger Property = "IsPressed" Value="True"> 
<Setter TargetName="controlLayout" 
Property="RenderTransformOrigin" Value="0.5,0.5"/> 
<Setter TargetName="controlLayout" Property="RenderTransform"> 
<Setter.Value> 
<ScaleTransform ScaleX="0.8" ScaleY="0.8"/> 
</Setter.Value> 
</Setter> 
</Trigger> 


31.5.3 {TemplateBinding} 标 记 扩 展 的 作用 


我 们 的 模板 目前 只 能 用 于 Button 控 件 ， 但 当 你 在 <Button> 元 素 中 添加 一 些 属性 ， 使 模板 能 以 独特 
的 方式 呈现 时 , 按钮 不 会 发 生 任何 变化 。 例如, 现在 Ellipse 的 Fil1l 属 性 硬 编码 为 蓝 色 , Label 的 Content 
永久 设置 为 字符 串 “OK”。 如 果 你 需要 按钮 能 显示 不 同 的 颜色 和 文本 ， 可 以 在 主 窗 体 中 定义 如 下 的 
按钮 : 


<StackPanel> 
<Button x:Name="myButton" Width="100" Height="100" 
Background="Red" Content="Howdy!" 
Click="myButton Click" 
Template="{StaticResource RoundButtonTemplate}" /> 
<Button x:Name="myButton2" Width="100" Height="100" 
Background="LightGreen”" Content="Cancel!" 
Template="{StaticResource RoundButtonTemplate}" /> 
<Button x:Name="myButton3" Width="100" Height="100" 
Background="Yellow" Content="Format" 
Template="{StaticResource RoundButtonTemplate}" /> 
</StackPanel> 


尽管 每 个 Button 都 设置 了 不 同 的 Background 和 Content 值 ， 但 最 后 我 们 得 到 的 仍然 是 3 个 蓝 色 的 显 
示 “OK” 的 按钮 。 原 因 在 于 控件 (Button) 的 属性 并 没有 与 模板 的 项 一 一 对 应 ( 如 Ellipse 的 Fill 属 
性 )。 同样 ， 尽管 Label 包 含 content 属 性 ,但 是 在 <Button> 中 定义 的 值 没有 自动 映射 到 模板 的 内 部 子 元 
素 上 。 

在 构建 模板 时 ， 可 以 使 用 {TemplateBinding} 标 记 扩 展 来 解决 这 个 问题 。 它 可 以 使 用 模板 来 获取 控 
件 定义 的 属性 设置 ， 并 用 这 些 设置 来 为 模板 中 的 相应 属性 赋值 。 以 下 是 重 写 的 RoundButtonTemplate， 
它 使 用 标记 扩展 将 Button 的 Background 属 性 映射 到 Ellipse 的 Fill 属 性 ， 同 时 还 将 Button 的 Content 传 递 
给 Label 的 Content: 


<ControlTemplate x:Key="RoundButtonTemplate" TargetType="Button"> 
<Grid x:Name="controlLayout"> 
<Ellipse x:Name="buttonSurface" Fill="{TemplateBinding Background}"/> 
<Label x:Name="buttonCaption" Content="{TemplateBinding Content}" 
FontSize="20" FontWeight="Bold" 
HorizontalAlignment="Center" VerticalAlignment="Center" /> 
</GCrid> 
<ControlTemplate. Triggers> 


</ControlTemplate.Triggers> 
</ControlTemplate> 


这 样 修改 之 后 就 可 以 创建 不 同 颜色 和 不 同文 本 值 的 按钮 了 ( 如 图 31-12 所 示 )。 
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图 31-12 ”模板 绑 定 可 以 将 值 传递 给 内 部 控件 


31.5.4 ”ContentPresenter 的 作用 


在 设计 模板 时 ， 我 们 使 用 一 个 Label 来 显示 控件 的 文本 值 。 如 前 面 的 Button、Label 为 其 提供 了 
Content 属 性 。 因 此 ， 使 用 {TemplateBinding} 定 义 的 按钮 ， 其 内 容 可 以 比 简单 的 字符 串 要 复杂 得 多 。 
例如 : 


<Button x:Name="myButton4" Width="100" Height="100" Background="Yellow" 
Template="{StaticResource RoundButtonTemplate}"> 
<Button.Content> 
<ListBox Height="50" Width="75"> 
<ListBoxItem>Hello</ListBoxItem> 
<ListBoxItem>Hello</ListBoxItem> 
<ListBoxItem>Hello</ListBoxItem> 
</ListBox> 
</Button.Content> 
</Button> 


对 于 如 此 特殊 的 控件 , 模板 仍 可 以 运行 良好 。 但 是 , 如 果 要 对 一 个 没有 Content 属 性 的 模板 成 员 传 
递 复杂 内 容 时 应 该 怎么 办 呢 ? 这 时 要 在 模板 中 定义 通用 的 内 容 显 示 区 域 ， 可 以 使 用 ContentPresenter 
类 而 不 能 使 用 特定 类 型 的 控件 ( Label 或 TextBlock )。 尽管 在 本 例 中 没有 必要 这 么 做 ,但 我 们 更 新 了 标 
记 ， 用 来 演示 如 何 使 用 contentPresenter 构 建 自 定义 模板 ， 使 那些 应 用 该 模板 的 控件 能 够 显示 其 
Content 属 性 的 值 : 


《1-- 该 按钮 模板 将 显示 所 有 设置 在 笨 主 按钮 Content 上 的 内 容 --> 
<ControlTemplate x:Key="NewRoundButton”TargetType="Button"> 
<Grid> 
<Ellipse Fill="{TemplateBinding Background}"/> 
<ContentPresenter HorizontalAlignment="Center" 
VerticalAlignment="Center"/> 
</Grid> 
</ControlTemplate> 
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31.5.5 “融合 模板 和 样式 


目前 为 止 ， 我 们 的 模板 只 简单 定义 了 Button 控 件 的 基本 外 观 。 建 立 控件 基本 属性 的 过 程 ( 内容 、 
字体 大 小 、 字 体 粗细 等 )， 是 由 Button 本 身 负责 的 : 


《<1-- 需 为 Button 设 置 基本 属性 的 值 ， 而 不 是 模板 --> 
<Button x:Name ="myButton" Foreground ="Black”" FontSize ="20" FontWeight ="Bold" 
Template ="{StaticResource RoundButtonTemplate}" Click ="myButton Click"/> 


如 果 愿 意 ， 你 也 可 以 在 模板 中 建立 这 些 值 。 这 样 就 可 以 有 效 地 创建 一 个 默认 的 外 观 。 你 可 能 已 经 
意识 到 这 应 该 是 WPF 样 式 的 工作 。 在 为 基本 属性 设置 构建 样式 时 ,可 以 在 样式 内 部 定义 模板 。 以 下 是 
App.xaml 中 修改 后 的 应 用 程序 资源 ， 它 的 key 已 经 修改 为 RoundButtonStyle: 


《<1-- 包含 模板 的 样式 --> 
<Style x:Key ="RoundButtonStyle”" TargetType ="Button"> 
<Setter Property ="Foreground" Value ="Black"/> 
<Setter Property ="FontSize" Value ="14"/> 
<Setter Property ="FontWeight" Value ="Bold"/> 
<Setter Property="Width" Value="100"/> 
<Setter Property="Height" Value="100"/> 
《1-- 以 下 是 模板 --> 
<Setter Property ="Template"> 
<Setter.Value> 
<ControlTemplate TargetType ="Button"> 
<Grid x:Name="controlLayout"> 
<Ellipse x:Name="buttonSurface" Fill="{TemplateBinding Background}"/> 
<Label x:Name="buttonCaption" Content ="{TemplateBinding Content}" 
HorizontalAlignment="Center" VerticalAlignment="Center" /> 
</Grid> 
<ControlTemplate.Triggers> 
<Trigger Property = "IsMouseOver" Value = "True"> 
<Setter TargetName = "buttonSurface"” Property = "Fill" Value = "Blue"/> 
<Setter TargetName = "buttonCaption" Property = "Foreground" Value = "Yellow"/> 
</Trigger> 
<Trigger Property = "IsPressed" Value="True"> 
<Setter TargetName="controlLayout" 
Property="RenderTransformOrigin" Value="0.5,0.5"/> 
<Setter TargetName="controlLayout" Property="RenderTransform"> 
<Setter.Value> 
<ScaleTransform ScaleX="0.8" ScaleY="0.8"/> 
“~ </Setter.Value> 
</Setter> 
</Trigger> 
</ControlTemplate. Triggers> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 


这 样 ， 就 可 以 像 下 面 这 样 设置 按钮 控件 的 Style 属 性 : 


<Button x:Name="myButton" Background="Red" Content="Howdy!" 
Click= "myButton_Click” Style="{StaticResource RoundButtonStyle}"/> 


尽管 按钮 的 外 观 和 行为 是 一 样 的 , 但 将 模板 内 艇 到 样式 中 的 好 处 是 , 可 以 为 常用 属性 提供 默认 值 。 
以 上 就 是 如 何 使 用 Visual Studio 和 触发 器 框架 构建 控件 的 自 定 义 模板 。 虽 然 关 于 WPF API 还 有 很 
多 内 容 没 有 介绍 ， 但 我 们 已 经 为 以 后 的 学 习 打 下 了 一 个 良好 的 基础 
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源 代 码 ButtonTemplate 项 目的 源 代码 位 于 Chapter 31 子 目录 下 。 








31.6 ”小 结 


本 章 介绍 了 很 多 WPF 相 关 的 话题 ,都 是 关于 自 定义 用 户 控 件 的 。 我们 先 学 习 了 WPF 是 如 何 使 用 传 
统 的 .NET 编 程 基 元 ( 如 属性 和 事件 ) 来 定义 翻转 的 。 如 你 所 见 ， 依 赖 属性 可 以 用 来 构建 集成 了 WPF 
服务 动画、 数据 绑 定 、 样 式 等 ) 的 属性 。 同 样 ， 路 由 事件 提供 了 一 种 将 事件 在 标记 树 中 向 上 或 向 下 
传递 的 方式 。 

这 之 后 我 们 学 习 了 远 辑 树 和 可 视 树 之 间 的 关系 。 逻 辑 树 基本 上 与 描述 WPF 根 元 素 的 标记 是 一 一 对 
应 的 。 逻 辑 树 的 背后 是 更 深层 次 的 可 视 树 ， 它 包含 详细 的 呈现 指令 。 

接 下 来 解释 了 默认 模板 的 作用 。 我 们 构建 自 定义 模板 时 ， 实 际 上 就 是 用 自 定义 的 实现 来 替换 控件 
全 部 (或 部 分 ) 的 可 视 树 。 
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到 | 目前 为 止 , 本 书 中 所 有 的 例子 都 是 基于 控制 台 和 GUI 的 。 在 本 书 余下 来 的 几 章 中 , 我 们 将 探 
究 .NET 平 台 如 何 助力 ASPNET 技 术 构 建 基于 浏览 器 的 表现 层 。 首 先 ， 我 们 将 快速 浏览 一 下 
许多 以 Web 为 中 心 的 关键 概念 (HTTP、HTML、 客 户 端 脚 本 和 回 送 )、 商 业 Web 服 务 器 〈IIS ) 的 作用 
以 及 ASPNET Development Web Server。 

随 着 以 Web 为 主线 的 铺展 ， 本 章 的 剩余 部 分 将 主要 讨论 ASPNET 表 单 编程 模型 ( 包括 单 页 面 和 代 
码 隐藏 页 面 ) 的 结构 ， 并 且 研 究 Page 基 类 的 功能 。 本 章 还 会 介绍 ASP.NET Web 控 件 的 作用 、ASPNET 
网 站 的 目录 结构 以 及 如 何 通 过 XML 指 令 使 用 web.config 文 件 来 控制 网 站 的 运行 时 操作 。 


说 明 ”如果 和 希望 加 载 本 书 可 下 载 源 代码 里 的 ASPNET 网 站 项 目 , 可 启动 Visual Studio, 选择 File 一 Open 
一 Web Site... 菜 单 选 项 。 在 弹出 的 对 话 框 中 ， 单 击 File System 按钮 (位 于 左 侧 )， 选 择 包含 Web 
项 目 文件 的 文件 夹 。 这 将 在 Visual Studio IDE 中 加 载 当 前 Web 应 用 程序 的 所 有 内 容 。 


.32.1 HTTP 的 作用 


Web 应 用 程序 与 传统 的 桌面 应 用 程序 有 很 多 不 同 。 第 一 个 明显 的 不 同 之 处 ， 就 是 产品 级 的 Web 应 
用 程序 将 总 是 包括 至 少 两 台 联 网 的 机 器 : 一 台 承 载 网 站 ， 另 一 台 在 Web 浏 览 器 中 查看 数据 。 当 然 ， 在 
开发 过 程 中 采用 单独 一 台 机 器 同时 担当 基于 浏览 器 的 客户 端 和 Web 服 务 器 也 是 完全 可 能 的 。 因 此 ， 这 
些 机 器 必须 遵从 一 个 特定 的 联网 协议 以 决定 如 何 发 送 和 接收 数据 。 连 接 计算 机 的 联网 协议 就 是 HTTP 
( 超 文本 传输 协议 )。 


32.1.1 HTTP 请 求 /响应 循环 


当 一 台 客 户 端 计算 机 运行 一 个 Web 浏 览 器 (例如 Google Chrome、Opera、Mozilla Firefox、Apple 
Safari 或 者 微软 Internet Explorer ) 时 ， 就 会 建立 一 个 HTTP 请 求 以 访问 远程 服务 器 上 的 特定 资源 (通常 
是 一 个 网 页 )。HTTP 就 是 一 种 以 文本 为 基础 的 协议 ， 它 建立 在 一 个 标准 的 请 求 /响应 范 型 上 。 例 如 ， 如 
果 你 输入 了 http:/www.facebook.com， 浏 览 器 软件 将 使 用 名 为 DNS ( 域名 服务 ) 的 Web 技 术 ，DNS 将 被 
注册 的 URL 转 换 成 一 个 耳 地址。 此刻， 浏览 器 打开 一 个 套 接 字 连 接 ( 通常 经 由 端口 80， 这 是 不 安全 连 
接 )， 并 且 向 目标 站 点 发 送 HTTP 请 求 。 

Web 服 务 器 收 到 外 来 的 HTTP 请 求 时 ,将 会 解析 任何 客户 端 提 供 的 输入 值 ( 例如 文本 框 中 包含 的 值 、 
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复 选 框 或 列表 框 等 ) 的 逻辑 , 以 格式 化 一 个 正确 的 HTTP 响 应 。Web 程 序 员 可 以 采用 任何 服务 器 端 技术 
(PHP、ASPNET、JSP 等 ) 动态 地 产生 一 些 内 容 以 加 入 到 HTTP 响 应 中 。 此 刻 ， 客 户 端 浏 览 器 呈现 出 从 
Web 服 务 器 发 送 来 的 HTML 页 面 。 图 32-1 阐 明了 基本 的 HTTP 请 求 /响应 循环 。 













Web 服 务 器 









输入 HTTP 请 求 


输出 HITP 响 应 


客户 端 浏览 器 
显示 从 HTTP 响 应 获得 Web 应 用 程序 (许多 服务 
的 HTML 器 端 和 资源 ， 如 *.aspx、 
*.asp 和 和 *.htm 文 件 ) 















图 32-1 HTTP 请 求 /响应 循环 


32.1.2 ”HTTP 是 无 状态 协议 


另 一 个 显著 不 同 于 桌面 程序 的 Web 开 发 就 是 ，HTTP 是 一 种 本 质 上 无 状态 的 联网 协议 。 只 要 Web 
服务 器 提交 给 客户 端 一 个 响应 ， 先 前 的 所 有 交互 都 将 被 遗忘 。 对 于 传统 的 桌面 应 用 程序 来 说 则 不 是 如 
此 ， 执 行 的 结果 通常 会 保留 到 用 户 关 闭 应 用 程序 。 

因此 ， 作 为 一 名 Web 开 发 者 ， 由 你 决定 使 用 具体 步骤 “记录 ”当前 登录 站 点 的 客户 信息 (例如 ， 
在 购物 车 中 的 物品 、 信 用 卡 账号 和 家 庭 住址 等 )。 在 第 34 章 中 将 看 到 ，ASPNET 提 供 了 大 量 处 理 状 态 
的 方法 ， 如 使 用 会 话 变量 、cookie 、 应 用 程序 缓存 等 技术 以 及 ASPNET 配 置 管理 API。 


32.2 ”Web 应 用 程序 和 Web 服务 器 


Web 应 用 程序 可 理解 成 为 各 种 文件 ( *.htm、*.aspx、 图 像 文 件 、 基 于 XML 的 文件 数据 等 ) 和 存储 
在 指定 Web 服 务 器 上 的 一 套 特 定 目录 集 内 的 相关 组 件 (例如 .NET 代 码 库 ) 的 集合 。 正 如 第 34 章 将 介绍 
的 ，ASP.NET Web 应 用 程序 具有 特定 的 生命 周期 ， 并 且 提 供 许 多 事件 〈 例如 初始 化 事件 和 关闭 事件 ) 
以 让 我 们 挂 钧 并 进行 自 定义 的 处 理 。 

Web 服 务 器 就 是 一 个 负责 承载 Web 应 用 程序 的 软件 产品 ,通常 情况 下 , 它 会 提供 许多 相关 的 服务 ， 
例如 集成 安全 、FTP (文件 传输 协议 ) 支持 、 邮 件 交 换 服务 等 。IIS ( Internet 信 息 服务 ) 是 微软 企业 级 
Web 服 务 器 产品 ， 它 提供 了 对 ASPNET Web 应 用 程序 的 内 在 支持 。 

假定 你 已 经 在 工作 站 上 正确 安装 了 HS ， 这 样 就 能 通过 双击 Internet Information Service 从 
Administrative Tools 文 件 夹 ( 位 于 Control Panal 文 件 夹 ) 中 与 JS 进行 交互 。 图 32-2 显 示 了 IIS 中 的 Default 
Web Site 节 点 ， 这 里 可 以 配置 大 多 数 细 节 (如 果 运 行 的 是 较 早 版 本 的 IIS ， 界 面 会 有 所 不 同 )。 


32.2.1 IIS 虚拟 目录 的 作用 
一 个 IIS 安 装 能 承载 许多 Web 应 用 程序 ,每 一 个 虚拟 目录 中 驻 留 一 个 Web 应 用 程序 。 在 本 地 硬盘 中 ， 
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每 一 个 虚拟 目录 都 被 映射 到 一 个 物理 目录 。 例 如 ， 如 果 你 创建 了 一 个 新 的 名 为 CarsAreUs 的 虚拟 目录 ， 
外 部 世界 就 能 够 通过 使 用 一 个 像 http://www.MyDomain.com/CarsAresUs( 假设 站 点 的 IP 地 址 已 经 注册 ) 
这 样 的 URL 映 射 到 这 个 站 点 。 虚 拟 目录 映射 到 一 个 包含 了 CarAreUs Web 应 用 程序 内 容 的 Web 服 务 器 上 
的 物理 根 目 录 。 











~ 


{Stemet ntormation Se , 
oT [3 ANDREWPC » 


Fe Yossie 








名 Default Web Site Home 


训 
= 二 ANDREWPC (AndrewPpO\And 





levels 


NET Trust .NET Users Me tio: 
Se 


Filter: - 钥 50 -六 ShowAl | Groupby; A 
Applicston Pook 2 oe 3 wp by; Ares 是 
Saes ASPNET 
Default Web Se a 加 F 坊 Rs 
aspnet_chent \ 
3 MSMQ NET NET NET Error NET NET Profile ”NET Roles 
HD WCFService thonaat mpiation Pages Globalizaton 
与 [三 涟 三 一 
多 名 8 下 再 


Connection Machine Key 
Stnngs 


Providers Session State SMTP E-mail 


» | SE] Features View |/3 Content View 











Browse Web Site 
图 Biewn -0 





onflqure 


全 
ST 





图 32-2 可 以 使 用 11S 程序 配置 微软 IS 的 运行 时 行为 


在 本 章 后 面 我 们 会 看 到 ， 当 使 用 Visual Studio 创 建 ASPNET Web 应 用 程序 时 ， 可 以 使 用 IDE 来 为 当 
前 的 网 站 自动 生成 新 的 虚拟 目录 。 然 而 如 果 需 要 的 话 , 当然 也 可 以 通过 右 击 IIS 的 Default Web Site 节 点 ， 
然后 从 弹出 的 上 下 文 菜单 中 选择 AddVirtual Directory 来 创建 新 的 虚拟 目录 。 


32.2.2 ASP.NET Development Web Server 


在 早期 的 .NET 版 本 中 , ASP.NET 的 开发 者 需要 在 开发 和 测试 Web 应 用 程序 的 时 候 使 用 IIS 虚 拟 目 录 。 
在 很 多 情况 下 , 这 和 设置 TS 的 团队 有 紧密 的 依赖 性 ,并 带 来 不 必要 的 复杂 性 ， 更 不 要 说 很 多 网 络 管理 
员 不 喜欢 在 每 一 个 开发 者 的 机 器 上 安装 IIS。 

好 在 我 们 现在 可 以 选择 使 用 一 个 叫做 ASPNET Development Web Server 的 轻 量 级 Web 服 务 器 。 这 个 
工具 人 允许 开发 者 在 IIS 的 范围 外 承载 一 个 ASPNET Web 应 用 程序 。 使 用 这 个 工具 , 你 能 从 计算 机 的 任何 
目录 建立 和 测试 网 页 。 这 对 团队 开发 非常 有 帮助 ， 对 于 在 不 支持 HS 安装 的 Windows 版 本 上 建立 
ASPNET Web 应 用 程序 也 是 非常 有 帮助 的 。 

本 书 中 的 大 多 数 示例 都 会 ( 通过 正确 的 Visual Studio 项 目 选项 ) 使 用 ASPNET Development Web 
Server， 而 不 是 在 IIS 虚拟 目 录 下 承载 Web 内 容 。 虽 然 这 个 方式 可 以 简化 Web 应 用 程序 的 开发 ， 但 是 要 
知道 这 个 Web 服 务 器 往往 不 会 承载 产品 级 别 的 Web 应 用 程序 。 这 只 用 于 开发 和 测试 目的 。 在 Web 应 用 
程序 完成 之 后 ， 我 们 的 网 站 还 是 需要 复制 到 IIS 虚 拟 目 录 中 。 


Visual Studio 提 供 了 内 幅 的 工具 ， 可 以 将 本 地 Web 应 用 复制 到 产品 级 的 Web 服 务 器 ， 只 需要 点 
击 一 两 个 按钮 即 可 。 要 开始 这 一 过 程 ， 需 要 在 Visual Studio 的 Solution Explorer 中 选择 Web 项 目 ， 
然后 点 击 Copy Web Site 按 钮 。 这 时 就 可 以 选择 想 要 部 署 的 目标 位 置 了 。 


说 明 
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配置 好 一 个 承载 Web 应 用 程序 的 目录 并 且 已 经 选择 Web 服 务 器 作为 主机 之 后 ， 就 需要 创建 内 容 。 
回想 一 下 ，Web 应 用 程序 只 是 构成 站 点 功能 的 文件 集 。 当 然 ， 这 些 文件 中 的 大 部 分 包含 用 HTML 定 义 
的 符合 语法 的 标记 。HTML 是 一 种 标准 标记 语言 ， 用 来 描述 文本 、 图 像 、 外 部 链接 和 各 种 HTML 控件 
是 如 何 被 客户 端 浏览 器 呈现 的 。 

虽说 现在 的 很 多 IDE ( 包括 Visual Studio ) 和 Web 开 发 平台 ( 例如 ASPNET ) 都 会 自动 生成 大 量 的 
HTML， 但 在 ASPNET 平 台 上 工作 时 ， 拥 有 一 些 HTML 知 识 是 很 有 益 的 。 


说 明 回忆 一 下 第 2 章 ， 微 软 在 Express 产 品 家 族 中 发 布 了 很 多 免费 的 IDE ( 如 Visual C# Express )。 如 
果 你 对 Web 开 发 感 兴趣 的 话 ， 可 以 下 载 Visual Web Developer Express。 这 个 免费 的 IDE 专 门 用 于 
构建 ASPNET Web 应 用 程序 ( 可 使 用 C# 或 VB )。 


虽然 这 部 分 内 容 肯 定 不 会 ( 也 不 可 能 ) 覆盖 HTML 的 所 有 方面 , 但 还 是 让 我 们 来 看 一 下 基本 概念 。 
这 将 有 助 于 你 更 好 地 理解 ASPNET Web 表 单 编程 模型 为 你 生成 的 标记 。 


32.3.1 HTML 文 档 结 构 


HTML 文 件 是 由 描述 网 页 外 观 的 一 组 标签 组 成 的 -HTML 文 档 的 基本 结构 一 般 保持 一 致 ,例如 ， 
*.htm 文 件 (或 者 *.html 文 件 ) 开始 于 <html> 标 签 和 结束 于 </html> 标 签 ， 通 常 定义 <body> 部 分 ， 
等 等 。 

为 说 明 一 些 HTML 基 础 知识 ， 打 开 Visual Studio， 使 用 File 一 New 一 File 菜 单 选项 插入 一 个 空 的 
HTML 页 面 文件 (注意 此 时 并 没有 构建 Web 项 目 ， 而 只 是 创建 了 一 个 用 于 编辑 的 空 的 HTML 文件 )， 然 
后 将 这 个 文件 保存 到 硬盘 中 方便 的 位 置 ， 名 字 为 default.htm。 可 以 看 到 如 下 所 示 的 初始 标记 (具体 的 
HTML 可 能 会 因 Visual Studio 的 配置 不 同 而 不 同 ): 

《!DOCTYPE html> 

<html lang="en" xmlns="http://www.w3.0org/1999/xhtml" > 

<head> 
<meta charset="utf-8" /> 
<title>Untitled Page</title> 


</head> 
<body> 


</body> 
</html> 


首先 ， 注 意 HTML 文 件 一 开始 的 DOCTYPE 处 理 指令 。 它 和 开放 的 <htm]> 标 签 表明 包含 的 HTML 标 签 
应 该 以 HTML 5.0 标 准 进行 验证 。 传 统 的 HTML 在 语法 上 非常 松散 。 除 了 大 小 写 问 题 外 ， 可 以 定义 一 个 
并 没有 对 应 结束 标签 ( 这 里 就 是 </br> ) 的 开始 元 素 ( 如 换行 cbr> ) 等 。HTML 5.0 标 准 是 一 个 W3C 规 
范 ， 它 为 标记 增加 了 很 多 新 的 特性 。 
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说 明 ”在 默认 情况 下 , Visual Studio 按 HTML 5.0 过 渡 性 验证 方案 来 验证 所 有 的 HTML 文 档 。 简 而 言 之 ， 
HTML 5.0 验 证 方案 用 于 确保 标记 和 某 个 标准 同步 。 如 果 你 希望 指定 其 他 验证 方案 的 话 ，( 如 
HTML 4.0 ) 激活 Tools 一 Options 对 话 框 ， 展 开 TextEditor 节 点 ， 在 HTML 下 选择 Validation 节 点 。 
如 果 不 希 望 看 到 验证 错误 ， 只 要 不 选中 Show Errors 复 选 框 即 可 。 


被 定义 的 绝 大 部 分 实际 内 容 都 位 于 <body> 范 围 内 。 为 了 对 页 面 略 做 修饰 ， 按 如 下 代码 所 示 为 页 面 
定义 一 个 标题 : 


<head> 
<title>This is my simple web page</title> 
</head> 


正如 你 所 料 ，<title> 标 签 用 来 指定 文本 字符 串 ， 这 些 文本 字符 串 应 该 放 在 承载 Web 浏 览 句 的 标题 
栏 里 。 


32.3.2 HTML 表单 的 作用 


HTML 表 单 就 是 一 组 命名 了 的 用 于 收集 用 户 输入 信息 的 有 关 UI 元 素 。 不 要 把 HTML 表 单 与 给 定 浏 
览 器 的 完整 显示 区 域 混 请 。 事 实 上 ，HTML 表 单 更 多 的 是 在 <form> 和 </form> 标 签 中 放置 部 件 的 逻辑 分 
组 。 例 如 : 
“1!DOCTYPE HTML> 
<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head> 
<title>This is my simple web page</title> 
</head> 
<body> 
<form id="defaultPage"> 
<!-- 在 此 插入 Web 用 户 界面 内 容 --> 
</form> 


</body> 
</html> 


这 个 表单 指定 了 "defaultpPage" 的 id。 开 始 标签 cform> 提 供 了 一 个 action 特 性 ， 这 个 特性 指定 提交 
表单 数据 的 URL 和 数据 自身 传输 的 方法 ( P0ST 或 GET )。 目 前 ， 看 一 下 能 放 在 HTML 表 单 中 的 项 目 分 类 
(除了 简单 的 文本 以 外 )。 


32.3.3 ”Visual Studio HTML 设 计 器 工具 


Visual Studio 在 工具 箱 上 提供 了 一 个 HTML 选 项 卡 ， 可 选择 一 个 希望 放 在 HTML 设 计 器 中 的 HTML 
控件 ( 如 图 32-3 所 示 )。 


说 明 ”在 使 用 Web 表 单 编程 模型 构建 ASP.NET Web 页 面 时 ， 我 们 通常 不 使 用 这 些 HTML 控件 来 创建 用 
户 界面 。 我 们 使 用 的 是 ASPNET Web 控 件 ， 它 们 可 以 呈现 正确 的 HTML。 本 章 后 面 将 会 学 习 
Web 控 件 的 作用 。 
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图 32-3 工具 箱 的 HTML 选 项 卡 


和 构建 WPF 应 用 程序 的 过 程 相似 ， 这 些 HTML 控 件 可 以 拖 放 到 HTML 设 计 器 界面 或 直接 拖 放 到 
HTML 标 记 上 。 如 果 单 击 HTML 编 辑 器 底部 的 Split 按 钮 ，HTML 编辑 器 底部 会 显示 HTML 可 视 化 布局 ， 
而 上 面 一 部 分 会 显示 相关 的 标记 。 这 个 编辑 器 的 另外 一 个 优势 是 ,在 我 们 选择 标记 或 HTML UI 元 素 的 
时 候 ， 对 应 的 表示 会 突出 显示 。( 如 图 32-4 所 示 )。 








HTMiPagel .html” b X Se 有 
<!DOCTYPE html> 于 
><html lang="en” xmlns="http://wn.w3.org/1999/xhtml"> | 
<meta charset="utf-8" /> Ei 


<title>This is my simple web page</title> 
</head> 
EC <body> 
<form id="defaultPapge"> 
<!l-- Insert web Ui content here -> 


} 

-~ <head> | | 
| 
| 











| 
| G Design [DO Splt | Source [dnemis |[<body>] <formzdefaultpage> 由 
图 32-4 ”Visual Studio HTML 编辑 器 
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Visual Studio 也 允许 使 用 Properties 窗 口 编辑 *.htm 文 件 的 总 体 界面 外 观 或 者 <form> 中 给 定 的 HTML 
控件 。 例 如 ， 如 果 从 Properties 窗 口 的 下 拉 列 表 中 选择 DOCUMENT ， 你 就 能 配置 HTML 页 面 的 各 个 方 
面 ( 如 图 32-5 所 示 )。 





Title This is my simple web page | 


‘Charset 
‘ Character set used to encode the document, 


图 32-5 ”通过 Visual Studio Properties 窗 口 配置 HTML 标 记 
在 使 用 Properties 窗 口 配置 Web 页 面 时 , IDE 将 相应 地 更 新 HTML。 在 阅读 本 书 剩余 章节 的 时 候 , 你 
可 以 随意 使 用 IDE 来 帮助 编辑 HTML 页 面 。 


32.3.4 构建 HTML 表 单 


现在 , 更 新 初始 文件 中 的 <body>, 以 显示 一 些 提示 用 户 输入 信息 的 文本 。 注意 , 可 以 通过 在 HTML 
设计 器 上 直接 输入 或 格式 化 文本 内 容 。 下 面 使 用 ch1> 标 签 设置 标题 宽度 ，<p> 设 置 段 落 块 ，<i> 设 置 余 
体 文本 : 


<htm] xmlns="http://www.w3.0org/1999/xhtml" > 
<head> 
<title>This is my simple web page</title> 
</head> 
<body> 
《1-- 提示 用 户 进行 输入 --> 
<h1i>Simple HTML Page</h1> 
<p> 
<br/> 
<i>Please enter a message</i>. 
</p> 


<form id="defaultPage"> 
</form> 


</body> 
</html> 


现在 来 创建 表单 的 输入 区 域 。 通 常 ， 使 用 id 特性 ( 以 编程 方式 标识 条 目 ) 和 type 特 性 ( 用 于 指定 
将 哪些 感 兴趣 的 输入 控件 放置 在 cform> 声 明 中 ) 来 描述 每 一 个 HTML 控 件 。 依据 所 使 用 的 UI 窗口 部 件 ， 
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将 发 现 针对 特定 条 目的 附加 特性 ， 这 些 条 目 可 以 使 用 Properties 窗 口 来 修改 。 
即将 构建 的 UI 包括 一 个 文本 字段 和 两 个 按钮 类 型 。 第 一 个 按钮 用 来 运行 客户 端 脚本 ， 男 一 个 按钮 
用 来 将 表单 数据 重 置 为 默认 值 。 按 如 下 所 示 更 新 HTML 表 单 : 


《<1-- 建立 一 个 表单 来 获取 用 户 信息 --> 
<form id="defaultPage"> 
<p> 
Your Message: 
<input id="txtUserMessage" type="text"/></p> 
<p> 
<input id="btnShow" type="button" value="Show!"/> 
<input id="btnReset" type="reset" value="Reset"/> 
</p> 
</form> 


注意 ， 你 已 经 给 每 个 控件 ( txtUserMessage 、btnShow 和 btnReset ) 指定 了 相应 的 d， 并 且 注 意 每 
一 个 输入 项 目 都 有 一 个 名 为 type 的 额外 特性 ， 表 示 这 些 输入 控件 是 UI 项 目 , 并 且 能 自动 将 所 有 字段 的 
值 设 为 初始 值 ( type="reset" ), 接收 文本 输入 (type="text" ) 或 与 客户 端 按钮 功能 类 似 但 并 不 向 Web 


服务 器 回 发 数据 ( type="button" )。 
保存 文件 ， 右 击 并 选择 View in Browser 菜 单 选项 。 图 32-6 在 Firefox 浏 览 器 中 显示 了 当前 页 面 。 








5 Simple HTML Page 


> LM Bookmarks Toolbar 
| 4%) Bookmarks Menu 
| > 加 Recently Bookmarked Please enter a message. 
转 ?> BB Recent Tags 
| ee ~ Your Message: 


Lshow| 


Mystuf 





图 32-6 简单 的 HTML 页 面 


说 明 当 对 一 个 HTML 文 件 选择 View in Browser 选 项 时 ，Visual Studio 将 自动 启动 ASPNET 
Development Web Server 来 承载 内 容 。 


32.4 客户 端 脚本 的 作用 


除了 GUIZE 素 外 ， 一 个 给 定 的 *.htm 文 件 可 以 包含 脚本 代码 块 ， 该 代码 块 将 由 请 求 浏览 器 处 理 。 使 
用 客户 端 脚 本 的 两 个 主要 原因 如 下 : 

口 在 回 传 到 Web 服 务 器 之 前 验证 用 户 输入 ; 

口 与 目标 浏览 器 的 DOM ( 文档 对 象 模型 ) 交互 。 
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关于 第 一 点 ， 要 理解 的 是 ，Web 应 用 程序 天 生 的 麻烦 就 是 ， 需 要 经 常 制造 往返 过 程 ( 即 回 传 ) 到 
服务 器 来 更 新 呈现 到 浏览 器 中 的 HTML。 既 然 回 传 不 可 避免 ,在 通信 过 程 中 总 是 要 考虑 使 往返 过 程 最 
小 化 。 节 省 回 传 的 一 项 技术 是 ， 在 向 Web 服 务 器 提交 表单 数据 前 ， 使 用 客户 端 脚本 来 验证 用 户 输入 。 
如 果 发 现 了 错误 〈 例 如 在 必 填 字段 上 没有 指定 数据 )， 就 能 够 提示 用 户 这 个 错误 ， 而 不 至 于 把 错误 值 
回 传 给 Web 服 务 器 。( 毕竟 对 于 用 户 来 讲 , 在 一 个 低速 连接 上 回 传 地址 输入 错误 的 说 明太 令 人 讨厌 了 1! ) 


说 明 要 知道 即使 进行 客户 端 验证 (为 了 提高 响应 时 间 )， 在 Web 服 务 器 还 是 应 该 再 验证 一 次 。 这 将 
确保 数据 在 网 络 上 传递 时 没有 被 自 改 。 在 第 33 章 中 会 介绍 , ASPNET 验 证 控件 会 自动 进行 客户 
端 和 服务 器 端的 验证 。 


客户 端 脚本 也 能 够 用 来 与 浏览 器 自身 的 底层 对 象 模型 ( DOM ) 交互 。 多 数 商业 浏览 器 都 公开 一 组 
能 够 用 来 控制 浏览 器 应 该 怎样 运作 的 对 象 。 

浏览 器 解析 HTML 页 面 时 ， 会 在 内 存 中 建立 一 个 对 象 树 ， 表 示 Web 页 面 中 的 所 有 内 容 ( 窗 体 、 输 
入 控件 等 )。 浏 览 器 提供 了 一 个 叫做 DOM 的 API， 它 公开 了 对 象 树 并 允许 以 编程 方式 修改 其 内 容 。 例 
如 ,你 可 以 编写 在 浏览 器 中 执行 的 JavaScript， 用 来 获取 指定 控件 的 值 、 更 改 控件 的 颜色 、 在 页 面 中 动 
态 添加 控件 等 。 

一 个 主要 的 麻烦 是 ,不同 的 浏览 器 往往 公开 相似 但 却 不 一 致 的 对 象 模型 。 因 此 ,假如 你 写 了 一 段 
与 DOM 交 互 的 客户 端 脚 本 代码 ， 它 却 不 一 定 可 以 在 所 有 的 浏览 器 上 做 相同 的 工作 。 

ASPNET 提 供 了 HttpRequest.Browser 属 性 ， 它 允许 你 在 运行 时 确定 发 送 当前 请 求 的 浏览 器 的 功能 。 
你 可 以 使 用 这 些 信息 来 决定 如 何以 最 优 的 方式 回 发 HTTP 响 应 。 但 除非 实现 自 定 义 控件 ， 和 否则 你 没有 
必要 担心 这 些 , 因为 ASPNET 中 所 有 标准 的 Web 控 件 都 能 自动 根据 浏览 器 类 型 以 适当 的 方式 进行 呈现 。 
这 个 了 不 起 的 功能 称 为 适应 性 呈现 ， 它 为 所 有 标准 的 ASPNET 控 件 而 实现 。 

编写 客户 端 脚本 代码 的 脚本 语言 有 很 多 ， 最 流行 的 当 属 JavaScript。 要 十 分 清楚 的 是 ，JavaScript 
绝 不 是 Java 语 言 的 另 一 种 形式 或 一 个 子 集 。 虽 然 JavaScript 和 Java 有 一 些 相 似 的 语法 ， 但 是 JavaScript 不 
是 一 个 完全 的 面向 对 象 编程 语言 ， 因 此 能 力 远 远 不 及 Java。 好 消息 是 当前 所 有 的 Web 浏 览 器 都 支持 
JavaScript， 使 得 对 于 客户 端 脚本 逻辑 来 说 ，JavaScript 成 了 一 个 自然 而 然 的 选择 。 


客户 端 脚本 示例 


为 了 说 明 客 户 端 脚本 的 作用 ， 让 我 们 先 来 检查 怎样 截获 从 客户 端 HTML GUI 部 件 发 送 的 事件 。 为 
了 捕获 这 个 按钮 的 click 事 件 ， 更 新 btnshow 控 件 的 定义 ， 使 其 支持 onclick 特 性 ， 该 特性 的 值 为 叫做 
btnShow_onclick() 的 JavaScript 方 法 。 


<input id="btnShow" type="button" value="Show!" 
onclick="return btnShow onclick()" /> 


下 面 , 直接 在 <head> 元 素 后 面 添加 如 下 所 示 的 JavaScript 函 数 , 当 用 户 单 击 该 按钮 时 将 调用 该 函数 。 
使 用 alert() 方 法 通过 value 属 性 来 显示 一 个 客户 端 消息 对 话 框 ( 其 中 包括 文本 框 中 的 值 ): 


<script lang="javascript" type="text/javascript"> 
// <![CDATA[ 
function btnShow onclick() { 
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alert(txtUserMessage.value); 
// ]]> 
</ScITipt> 
注意 ， 脚 本 块 已 经 被 包装 在 CDATA 中 。 原 因 很 简单 ， 如 果 你 的 页 面 在 一 个 不 支持 JavaScript 的 浏览 
器 上 显示 , 那么 这 段 代 码 将 被 当做 注释 块 处 理 并 被 忽略 。 当 然 ， 你 的 页 面 就 缺少 这 个 功能 ， 不 过 好 的 
一 面 是 ， 在 被 浏览 器 呈现 时 ， 你 的 页 面 不 会 出 问题 。 再 次 在 浏览 器 中 查看 该 页 面 ， 输 入 一 些 内 容 ， 可 
以 看 到 它 会 在 客户 端 信息 框 中 弹出 ( 如 图 32-7 所 示 )。 












”> DB Recent Tags 


| » | My Shuff 





图 32-7 调用 客户 端 JavaScript 函 数 
同样 ， 单 击 Reset 按 钮 ， 文 本 区 域内 的 所 有 数据 都 被 清空 ， 因 为 该 按钮 在 创建 时 指定 了 


type="reset"。 


32.5 回 发 到 Web 服务 器 


这 个 简单 HTML 页 面 的 所 有 功能 都 在 浏览 器 中 执行 。 而 真正 的 Web 页 面 需要 向 Web 服 务 器 中 的 某 
个 资源 进行 回 发 ， 同 时 传送 所 有 输入 数据 。 服 务 器 资源 接收 这 些 数据 ， 并 用 它们 来 构建 适当 的 动态 生 
成 的 HTTP 响 应 。 

在 开始 标记 xform> 中 ，action 特 性 指定 了 输入 表单 数据 的 接收 者 。 接 收 者 可 能 为 邮件 服务 器 、 
Web 服 务 器 上 的 其 他 HTML 文 件 、 标 准 的 ASP 文 件 、ASPNET Web 页 面 等 。 

除了 action 特 性 ， 你 还 可 能 会 创建 一 个 提交 按钮 ， 该 按钮 在 单 击 时 会 将 表单 数据 通过 HTTP 请 求 
传送 给 Web 应 用 程序 。 我 们 没有 必要 在 本 例 中 这 么 做 ， 但 下 面 这 个 更 新 后 的 defaulthtm 在 开始 标签 
<form> 中 指定 了 以 下 特性 : 


<form id="defaultPage" 
action="http://localhost/Cars/ClassicAspPage.asp" method="GET"> 
<input id="btnpostBack" type="submit" value="Post to Server!"/> 


</form> 
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单 击 该 表单 中 的 提交 按钮 ， 表 单数 据 将 被 发 送 给 URL 所 指定 的 ClassicAspPage.asp。 如 果 将 传送 方 
式 指定 为 method="GET"， 表 单数 据 将 以 8 符号 分 隔 的 名 称 / 值 对 的 形式 附加 到 查询 字符 串 中 。 你 肯定 在 
浏览 器 中 看 到 过 这 种 类 型 的 数据 ， 如 : 


http://www.google.com/search?hl=en&source=hp&q=vikings&cts=1264370773666&aq= 
f&aql=&aqi=g1lg-zig1g-z1ig1g-z1g4&0q= 


将 表单 数据 传送 给 Web 服 务 器 的 男 一 种 方法 是 指定 method="P0ST"， 如 下 所 示 : 


<form id="defaultPage" 
action="http://localhost/Cars/ClassicAspPage.asp" method = "POST"> 


/formy 

在 这 种 情况 下 ， 表 单数 据 不 会 附加 到 查询 字符 串 中 。 使 用 POST 方 式 时 ， 表 单数 据 对 于 外 部 世界 
来 说 不 是 直接 可 见 的 。 更 重要 的 是 ，POST 数 据 没有 字符 长 度 限 制 ， 而 许多 浏览 器 对 于 GET 查 询 是 有 
字符 限制 的 。 


ASPNET 回 发 


在 使 用 Web 表单 构建 基于 ASPNET 的 网 站 时 ， 框 架 将 为 我 们 管理 回 发 机 制 。 用 ASPNET 构 建 网 站 
的 好 处 之 一 是 ， 编 程 模型 在 标准 的 HTTP request/response 协 议 的 上 层 放置 了 一 个 事件 驱动 系统 。 因 此 ， 
你 不 必 手 工 设置 action 特 性 和 定义 HTML 提 交 按 钮 ， 只 需要 简单 地 使 用 标准 的 C# 语 法 处 理 ASPNET 
Web 控 件 的 事件 就 可 以 了 。 

使 用 这 种 事件 驱动 模型 ， 你 可 以 使 用 大 量 控 件 触发 对 Web 服 务 器 的 回 发 。 单 击 单 选 按 钮 、 复 选 框 
中 的 某 项 、 日 历 控件 中 的 某 天 等 ， 都 可 以 向 Web 服 务 器 回 发 数据 。 你 只 需要 简单 地 处 理 正 确 的 事件 ， 
ASPNET 运 行 时 将 自动 回 传 正 确 的 HTML 数 据 。 


源 代码 ”SimpleWebPage 网 站 的 源 代码 位 于 Chapter 32 子 目录 下 。 


32.6 ASPNET API 概览 


至 此 ， 我 们 回顾 了 经 典 的 Web 应 用 程序 开发 ， 你 已 经 准备 好 开始 学 习 ASPNET 了 。 正 如 你 所 预料 
的 那样 ， 每 个 .NET 平 台 的 版 本 都 向 Web 编 程 API 中 添加 了 很 多 功能 ，.NET 4.5 亦 是 如 此 。 不 管 你 面向 的 
是 哪个 NET 版 本 ， 对 于 ASPNET Web 应 用 来 说 下 面 的 特性 都 是 通用 的 。 
口 ASPNET 提 供 了 名 为 代码 隐藏 的 模型 ， 人 允许 将 表现 逻辑 ( HTML ) 从 业务 逻辑 ( C# 代 码 ) 中 分 
离 出 来 。 

口 ASPNET 页 面 使 用 NET 编程 语言 而 不 是 服务 器 端 脚本 语言 编码 。 这 个 代码 文件 可 以 编译 为 有 
效 的 .NET *.dll 程 序 集 ， 可 以 带 来 更 快 的 执行 速度 。 

口 ASPNET Web 控 件 可 用 来 构建 Web UI， 其 模型 与 桌面 窗口 应 用 非常 类 似 。 

口 ASPNET Web 应 用 程序 可 以 使 用 .NET 基 础 类 库 中 的 任何 一 个 程序 集 ， 并 且 用 本 书 介绍 的 面向 
对 象 技术 (类 、 接 口 、 结 构 、 枚 举 和 委托 ) 进行 构建 。 

口 能 使 用 Web 应 用 程序 配置 文件 ( web.config ) 轻松 配置 ASPNET Web 应 用 程序 。 
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这 里 首先 要 阐述 的 是 ，ASP.NET Web 页 面 的 UI 可 使 用 多 个 Web 控 件 构建 。 与 典型 的 HTML 控 件 不 
同 ，Web 控 件 在 Web 服 务 器 上 执行 ， 然 后 将 正确 的 HTML 标 签 回 发 给 HTTP 响 应 。 仅 此 一 点 ， 就 可 以 大 
大 减少 手工 编写 HTML 的 数量 。 来 看 一 个 快速 示例 , 假设 在 ASPNET Web 页 面 中 定义 了 如 下 的 ASPNET 
Web 控 件 : 


<asp:Button ID="btnMyButton" runat="server" Text="Button" BorderColor="Blue" 
BorderStyle="Solid" BorderWidth="5px" /> 


稍 后 我 们 将 学 习 创 建 ASPNET Web 控 件 的 细节 ， 现 在 要 注意 的 是 ，<asp:Button> 控 件 的 很 多 特性 
看 上 去 都 与 WPF 示 例 中 的 属性 十 分 类 似 。 所 有 ASPNET Web 控 件 都 是 如 此 。 这 是 因为 微软 在 构建 这 些 
Web 控 件 工具 包 时 ， 特 意 将 其 外 观 设计 得 很 像 桌 面 框架 中 对 应 的 控件 。 

现在 ， 如 果 浏 览 器 调用 包含 该 控件 的 *.aspx 文 件 ， 控 件 将 被 回 发 的 输出 流 响 应 为 如 下 的 HTML 
声明 : 


<input type="submit”name="btnMyButton”value="Button”id="btnMyButton” 
style="border-color:Blue;border-width:5px;border-style:Solid;" /> 


注意 Web 控 件 可 以 在 任何 浏览 器 中 回 发 标准 的 HTML。 因 此 ，ASPNET Web 控 件 并 不 局 限于 微软 
的 操作 系统 家 族 和 正 。 任 何 操 作 系 统 或 浏览 器 ( 包括 Apple iPhone 或 BlackBerry 这 种 手持 设备 ) 都 可 以 
浏览 ASPNET Web 页 面 。 

注意 前 面 列表 中 提 到 的 一 个 特性 ， 即 ASPNET Web 应 用 程序 将 被 编译 为 .NET 程 序 集 。 因 此 ， 
Web 项 目 与 本 书 中 的 其 他 .NET *.dll 没 有 任何 区 别 。 编 译 的 Web 应 用 程序 由 CIL 代 码 、 程 序 集 清单 和 
类 型 元 数据 组 成 。 这 可 以 带 来 巨大 的 好 处 ， 如 显著 的 性 能 提升 、 强 类 型 和 由 CLR 托 管 的 能 力 ( 如 垃 
圾 回收 )。 

最 后 ，ASP.NET Web 应 用 程序 还 提供 了 一 种 编程 模型 ， 它 使 用 代码 文件 将 页 面 标记 和 相关 的 C# 代 
码 相 分 离 。 使 用 代码 文件 ,你 输入 的 标记 将 映射 到 一 个 完整 的 对 象 模 型 ， 该 对 象 模型 由 多 个 C# 代 码 文 
件 中 声明 的 分 部 类 合并 而 成 。 


32.6.1 ASPNET 2.0 及 其 后 续 版 本 的 主要 特性 


ASPNET 1.0 往 正确 方向 迈 了 一 大 步 ， 而 ASPNET 2.0 提 供 了 许多 额外 的 特性 ， 使 ASPNET 的 定位 
从 构建 动态 网 页 到 构建 功能 丰富 的 网 站 。 主 要 改进 如 下 。 

口 引入 ASPNET Development Web Server ( 也 就 是 说 ， 开 发 人 员 无 须 在 开发 用 的 计算 机 上 安装 

IIS )。 

口 ASPNET2.0 含 有 大 量 处 理 复杂 情况 的 新 Web 控 件 ( 导航 控件 、 安 全 控件 、 新 数据 绑 定 控件 等 )。 

口 ASPNET 2.0 支 持 母 版 页 的 使 用 ， 这 人 允许 给 一 套 相 关 页 面 附加 一 个 公共 的 UI 框架 。 

口 ASPNET 2.0 支 持 主 题 ， 它 提供 了 一 个 可 声明 的 方式 改变 整个 Web 应 用 程序 的 界面 外 观 。 

口 ASPNET 2.0 支 持 Web 部 件 , 允许 终端 用 户 定制 网 页 的 界面 外 观 并 存储 这 些 设置 以 便 以 后 使 用 。 

口 ASPNET 2.0 文 持 基 于 Web 的 配置 文件 和 管理 工具 ， 以 维护 web.config 文 件 。 

除了 ASPNET Development Web 服 务 器 ，ASPNET 2.0 带 来 的 另 一 个 巨大 改变 是 引入 了 母 版 页 。 如 
你 所 知 ， 大 多 数 网 站 的 所 有 页 面 都 有 统一 的 外 观 。 像 www.amazon.com 这 样 的 商务 网 站 ， 每 个 页 面 都 
包含 相同 的 元 素 ， 如 公共 的 头 部 、 底 部 、 导 航 菜 单 等 。 
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使 用 母 版 页 ， 可 以 建立 这 些 公共 的 功能 ， 并 定义 可 容纳 *.aspx 文 件 的 占 位 符 。 这 样 ， 不 需要 更 改 
其 他 *.aspx 文 件 ， 只 需要 更 改 母 版 页 ， 就 可 以 轻松 快速 地 改变 站 点 的 整个 外 观 ( 改变 导航 条 的 位 置 ， 
更 改 头 部 logo 等 )。 








说 明 Visual Studio 2010 广 泛 使 用 了 母 版 页 ， 所 有 的 ASPNET Web 项 目 都 包含 默认 的 母 版 页 。 

ASPNET 2.0 还 引入 了 许多 新 的 混合 Web 控 件 ， 包 括 自 动 合 并 了 公共 安全 特性 的 控件 〈 登 录 控 件 、 
密码 恢复 控件 等 )、 在 一 组 相关 的 *.aspx 文 件 顶 部 放置 导航 结构 的 控件 ， 以 及 更 多 执行 复杂 数据 绑 定 操 
作 的 控件 ， 它 们 可 以 使 用 多 个 ASPNET Web 控 件 生成 必要 的 SQL 查询 。 





32.6.2 ASPNET 3.5〈 和 .NET 3.5 SP1) 的 主要 特性 


.NET 3.5 使 ASP.NET Web 应 用 程序 能 够 使 用 LINQ 编 程 模型 (.NET3.5 引 和 的 )， 并 添加 如 下 Web 相 
关 的 特性 。 
口 支持 对 ADO.NET 实 体 类 的 数据 绑 定 ( 见 第 23 章 )。 
口 支持 ASPNET Dynamic Data。 这 是 一 个 类 似 Ruby on Rails 的 Web 框 架 ， 可 用 来 构建 数据 驱动 的 
Web 应 用 程序 。 它 将 数据 库 中 的 表 编 码 到 ASPNET Web 服 务 的 URI 中 ， 表 中 的 数据 将 自动 呈现 
为 HTML。 
口 集成 了 对 Ajax 风格 开发 的 支持 ， 它 实质 上 支持 部 分 回 发 ， 可 以 快速 刷新 Web 页 面 的 部 分 内 容 。 
.NET 3.5 SP1 中 的 ASPNET Dynamic Data 项 目 模板 提供 了 一 种 新 的 模型 ， 用 于 构建 由 关系 型 数据 
库 驱 动 的 站 点 。 当 然 ， 大 多 数 网 站 都 在 一 定 程度 上 需要 与 数据 库 进 行 通信 ， 但 ASPNET Dynamic Data 
项 目 与 ADO.NET Entity Framework 仅 仅 联系 在 一 起 ， 并 且 专 注 于 数据 驱动 网 站 的 快速 开发 ( 这 与 Ruby 
很 类 似 )。 


32.6.3 ASPNET 4.0 和 4.5 的 主要 特性 


.NET 4.0 和 4.5 为 微软 Web 开 发 平台 增加 了 更 多 的 特性 。 下 面 列 出 了 一 些 关键 的 Web 特 性 。 
口 使 用 GZIP 标 准 压缩 “视图 状态 ”数据 。 
口 更 新 了 浏览 器 的 定义 ， 以 确保 ASPNET 页 面 能 正确 呈现 在 新 的 浏览 器 和 设备 上 ( Google 
Chrome、Apple iPhone、BlackBerry 设 备 等 )。 
口 使 用 CSS 定 制 验证 控件 的 输出 结果 。 
口 新 增 ASPNET Chart 控 件 ， 可 构建 包含 复杂 统计 或 财务 分 析 图 表 的 ASPNET 页 面 。 
口 支持 ASPNET Model View Controller 项 目 模板 ， 它 使 用 MVC 模 式 ， 降 低 了 应 用 程序 层 之 间 的 依 
赖 性 。 这 是 网 站 开发 的 一 种 完全 不 同 的 方式 ， 与 本 书 所 介绍 的 Web 表 单 编程 模型 相似 性 很 小 。 
口 为 支持 HTML 5.0 做 出 了 很 多 更 新 。 
口 集成 了 C# 和 VB 中 新 的 异步 语言 特性 。 
ASPNET 的 这 些 特 性 相当 有 深度 ( 而 且 这 个 API 还 有 很 多 我 没有 列 出 的 特性 )。 说 实话 ， 如 果真 的 
涵盖 ASPNET 的 所 有 特性 ， 本 书 的 厚度 将 增加 一 倍 (也 许 两 倍 )。 因 此 ， 本 书 剩余 部 分 的 目标 是 介绍 
ASPNET 中 那些 经 常 使 用 的 核心 特性 。 对 于 没有 介绍 到 的 特性 , 可 以 参考 NET Framework 4.5 SDK 文 档 。 
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说 明 如 果 你 要 全 面 地 学 习 如 何 使 用 ASPNET 构 建 Web 应 用 程序 ， 建 议 你 买 本 Adam Freeman 和 
Matthew MacDonald 所 著 的 Pro ASPNET 4.5 in C#, Fifih Edition。 





32.7 ”构建 单个 文件 的 ASPNET 网 页 


ASPNET 网 页 能 使 用 两 种 主要 方法 进行 创建 。 第 一 种 方法 创建 一 个 *.aspx 文 件 ， 这 个 *.aspx 文 件 融 
合 了 服务 器 端 代码 和 HTML。 使 用 单 文件 页 面 模型 ， 服 务 器 端 代码 被 放置 在 <script> 作 用 域内 ， 但 是 
代码 本 身 并 不 是 严格 意义 上 的 脚本 代码 ( 例如 VBScript/JavaScript )， 在 <script> 块 内 的 代码 语句 将 使 
用 你 所 选择 的 .NET 语 言 ( C#、Visual Basic 等 )。 

如 果 你 正在 构建 一 个 页 面 , 它 包 含 非常 少 的 代码 (但 确 有 大 量 的 静态 HTML ), 使 用 一 个 单 文件 页 
面 模型 可 以 更 简单 些 ， 因 为 这 样 你 就 可 以 在 一 个 统一 的 *.aspx 文 件 中 看 到 所 有 的 代码 和 标记 。 另 外 ， 
把 过 程式 代码 和 HTML 标 记 放 在 一 个 *.aspx 文 件 中 具有 以 下 几 个 优点 。 

口 部 署 或 发 送 给 另 一 个 开发 者 使 用 单 文件 模型 编写 的 页 面 要 简单 些 。 

口 因为 文件 互相 之 间 不 存在 依赖 ， 所 以 单 文件 页 面 更 易于 重 命名 。 

口 因为 所 有 动作 在 一 个 文件 中 发 生 ， 所 以 在 源 代 码 控制 系统 内 管理 文件 更 容易 。 

但 单 文件 模型 的 缺点 是 ， 它 与 经 典 的 基于 COM 的 ASP 一 样 ， 都 将 导致 过 于 复杂 的 文件 ( 因为 UI 
标记 和 程序 逻辑 被 隔离 在 一 个 地 方 )。 不 过 ,我们 的 ASPNET 之 旅 还 是 将 从 单 文件 页 面 模型 开始 。 

我 们 的 目标 是 建立 一 个 *.aspx 文 件 ， 用 它 来 显示 AutoLot 数 据 库 ( 在 第 21 章 中 创建 的 ) 的 Inventory 
表 (但 可 以 猜 到 , 也 可 以 使 用 断 开 连 接 层 或 Entity 框 架 )。 启动 Visual Studio, 然后 通过 File 一 New 一 File 
菜单 选项 创建 一 个 新 的 Web Form ( 如 图 32-8 所 示 ， 注 意 需 要 在 左 侧 的 树 形 视 图 中 点 击 Web 一 C# 节 点 )。 








We Use Contol 


Pesource File 





图 32-8 ”创建 新 的 单 文件 ASP.NET 页 面 


这 样 做 之 后 ， 将 这 个 文件 保存 为 Default.aspx ， 并 保存 在 硬盘 上 容易 找到 的 新 目录 下 (例如 
C:MyCode\SinglePageModel )。 
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32.7.1 引用 AutoLotDAL.dll 


接着 ,使 用 Windows 资 源 管理 器 在 SinglePageModel 文 件 夹 下 创建 子 目 录 bin。 这 个 特殊 的 bin 子 目 
录 是 ASPNET 运 行 时 引擎 的 注册 名 。 在 网 站 根 目 录 下 的 \bin 文 件 夹 中 , 我 们 可 以 部 署 任何 Web 应 用 程序 
的 私有 程序 集 。 对 于 本 例 ， 把 AutoLotDAL.dll ( 见 第 21 章 ) 的 副本 放 到 C:\MyCode\SinglePageModel\bin 文 
件 夹 中 。 


说 明 ”本章 稍 后 会 介绍 , 如 果 使 用 Visual Studio 创 建 ASPNET Web 项 目 , IDE 会 为 我 们 维护 \bin 文 件 夹 ， 
并 在 默认 情况 下 将 任何 引用 复制 到 私有 程序 集中 。 


32.7.2 设计 UI 


现在 使 用 Visual Studio 工 具 箱 ， 选 择 Standard 选 项 卡 ， 然 后 拖 放 Button、Label 和 GridView 控 件 到 开 
始 元 素 form 和 结束 元 素 form 之 间 的 页 面 设 计 器 上 (Gridview 部 件 能 够 在 工具 箱 的 Data 选 项 卡 找到 )。 随 
意 使 用 Properties 窗 口 来 设置 各 种 各 样 的 可 视 化 属性 ， 然 后 通过 ID 特性 给 每 一 个 Web 部 件 一 个 合适 的 名 
字 。 图 32-9 显 示 了 一 个 可 能 的 设计 。( 我 有 意 保持 外 观 平淡 无 奇 ， 以 减少 生成 控件 标记 的 数量 , 但 你 可 
以 任意 修饰 它 。) 


jg 
Cick on the Button to Fl the Grid 


Colamn0 Column] Columa2 | 
abc abc abc ， 
abc abe ‘abc | 
abc ‘abc ‘abc 上 
abc abc abc ， | 
abc abc abc | 
Fi Grid 





% Design | Split | Source | 





图 32-9 Default.aspx GUI 


现在 ， 找 到 页 面 的 <form> 部 分 。 注 意 每 个 Web 控 件 是 如 何 使 用 casp:> 标 签 定义 的 。 在 这 个 标记 前 
组 之 后 ， 是 ASPNET Web 控 件 的 名 称 (Label 、GridView 和 Button )。 在 给 定 元 素 的 结束 标记 之 前 ， 你 
将 看 到 一 系列 与 Properties 窗 口中 的 设置 相对 应 的 名 称 / 值 对 ， 例 如 : 


<form id="form1" runat="server"> 
<div> 
<asp:Label ID="1lblInfo" runat="server" 
Text="Click on the Button to Fill the Grid"> 
</asp:Label> 
<br /> 
<br /> 
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<asp:GridView ID="carsGridView" runat="server"> 

</asp:GridView> 

<br /> 

<asp:Button ID="btnFillData" runat="server" Text="Fill Grid" /> 
</div> 
</form> 


随后 第 33 章 将 讨论 ASPNET Web 控 件 的 全 部 细节 。 此 前 ， 只 要 理解 Web 控 件 是 在 Web 服 务 器 上 处 
理 的 对 象 ， 并 且 它 们 自动 地 将 HTML 请 求 发 回 到 输出 的 HTTP 响 应 中 。 除 了 这 个 主要 的 好 处 之 外 ， 
ASPNET Web 控 件 模 仿 类 似 桌 面 的 编程 模型 ， 因 为 有 和 Windows Forms/WPF 相 同 的 属性 、 方 法 和 事件 
的 名 称 。 


32.7.3 ”添加 数据 访问 逻辑 


现在 切换 到 定义 者 ， 使 用 Visual Studio Properties 窗 口 (通过 闪电 图 标 ) 来 处 理 Button 类 型 的 click 
事件 ( 就 像 本 章 回顾 HTML 时 所 做 的 一 样 )。 此 后 你 将 发 现 Button 的 定义 已 经 得 到 更 新 ， 为 Click 事 件 
处 理 程序 名 称 分 配 了 onClick 特 性 : 


<asp:Button ID="btnFillData" runat="server" 
Text="Fil] Grid" OnClick="btnFillData Click"/> 


现在 ,在 服务 器 端 *.aspx 的 <script> 块 中 编写 Click 事 件 处 理 程序 。 注 意 传人 参数 必须 与 
System.EventHandler 委 托 的 目标 完全 匹配 ， 这 在 本 书 中 已 经 出 现 多 次 : 


<script runat="server"> 
protected void btnFillData Click(object sender, EventArgs args) 


</script> 
下 一 步 就 是 使 用 AutoLotDAL.dll 程 序 集 的 功能 来 填充 GridView。 我 们 必须 使 用 <%@ Import %> 指 令 
来 指定 我 们 使 用 的 AutoLotConnectedLayer 命 名 空间 。 


说 明 只 有 在 使 用 单 文件 代码 模型 构建 页 面 时 ， 你 才 需 要 使 用 <%@ Import %> 指 令 。 如 果 使 用 默认 的 
代码 文件 方法 ， 那 么 只 需要 简单 地 使 用 C#using 关 键 字 ， 就 可 以 在 代码 文件 中 引用 命名 空间 。 
<%@ Assembly %> 指 令 也 是 如 此 。 


此 外 ,我 们 需要 通过 <%@ Assembly %> 指 令 ( 稍 后 会 介绍 有 关 指 令 的 更 多 细节 ) 通知 ASPNET 运 行 
库 ， 这 个 单 文件 页 面 引 用 了 AutoLotDAL.dll 程 序 集 。 这 里 是 Default.aspx 文 件 的 其 他 相关 页 面 逻 辑 ( 确 
保 按 照 要 求 修改 连接 字符 串 ): 

<%@ Page Language="C#" %> 

<%@ Import Namespace = "AutoLotConnectedLayer"” %> 

<%@ Assembly Name ="AutoLotDAL”%> 

<!DOCTYPE html> 


<script runat="server"> 
protected void btnFillData Click(object sender, EventArgs args) 


InventoryDAL dal = new InventoryDAL(); 


1100 第 32 章 ASPNET Web Form 


dal.0penConnection(@"Data Source=(local)\SQOLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 


carsGridView.DataSource = dal.GetAllInventoryAsList(); 
carsGridView.DataBind(); 
dal.CloseConnection(); 


} 
</script> 
在 深入 探讨 这 个 *.aspx 文 件 幕后 的 细节 之 前 ， 让 我 们 做 一 下 测试 运行 。 首 先 保存 *.aspx 文 件 。 现 
在 右 击 *.aspx 设 计 器 上 的 任何 位 置 ， 选 择 View in Browser 菜 单 选 项 ， 将 启动 ASPNET Development Web 


服务 器 ， 它 将 承载 你 的 页 面 。 
当 这 个 页 面 运 行 时 ， 你 将 最 先 看 到 Label 和 Button 控 件 。 然 而 ， 当 单 击 按钮 控件 时 ， 在 Web 服 务 器 端 


发 生 了 回 传 ，Web 控 件 发 送 回 它们 相应 的 HTML 标 签 。 图 32-10 显 示 了 单 击 Fill Grid 按钮 后 的 输出 结果 。 
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图 32-10 ASP.NET 提 供 了 声明 式 数据 绑 定 模型 
当前 的 界面 很 空 。 要 让 它 更 丰富 一 些 ,， 可 在 Visual Studio 设 计 器 中 选择 GridView 控 件 , 使 用 上 下 文 
菜单 〈 控 件 左上 角 的 小 箭头 )， 选 择 Auto Ront 玫 天 obi 11 所 示 )。 
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图 32-11 配置 ASPNET Gridview 控 件 
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在 弹出 的 对 话 框 中 ， 选 择 一 个 喜欢 的 模板 ( 我 选择 “Slate”)。 单 击 OK 按 钮 ， 查 看 生成 的 控件 定 
义 ， 它 比 之 前 更 丰富 一 些 : 


<asp:GridView ID="carsGridView" runat="server" BackColor="White" 
BorderColor="#E7E7FF" BorderStyle="None”" BorderWidth="1px" CellPpadding="3" 
GridLines="Horizontal"> 
<AlternatingRowStyle BackColor="#F7F7F7" /> 
<FooterStyle BackColor="#B5C7DE" ForeColor="#4A3C8C" /> 
<HeaderStyle BackColor="#4A3C8C" Font-Bold="True" ForeColor="#F7F7F7" /> 
<PagerStyle BackColor="#E7E7FF" ForeColor="#4A3C8C" HorizontalAlign="Right" /> 
<RowStyle BackColor="#E7E7FF" ForeColor="#4A3C8C" /> 
<SelectedRowStyle BackColor="#738A9C" Font-Bold="True" ForeColor="#F7F7F7" /> 
<SortedAscendingCellStyle BackColor="#F4F4FD" /> 
<SortedAscendingHeaderStyle BackColor="#5A4C9D" /> 
<SortedDescendingCellStyle BackColor="#D8D8FO" /> 
<SortedDescendingHeaderStyle BackColor="#3E3277" /> 
</asp:GridView> 


再 次 查看 应 用 程序 并 单 击 按钮 ， 将 看 到 更 有 趣 的 界面 ( 如 图 32-12 所 示 )。 
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图 32-12 ”显示 测试 页 面 的 更 多 内 容 


很 简单 吧 ? 当然 ， 正 像 谚语 说 的 ， 恶 魔 藏 在 细节 里 “， 所 以 让 我 们 更 深入 地 探究 这 个 *.aspx 文 件 的 


构成 。 首 先 研 究 <%@Page...%> 指 令 。 要 注意 ,我 们 介绍 的 这 些 话题 也 可 以 直接 应 用 于 更 受 欢迎 的 代码 


32.7.4 ASP.NET 指 令 的 作用 


通常 每 个 给 定 的 *.aspx 文 件 以 一 组 指令 开始 。ASP.NET 指 令 总 是 使 用 <%@...%> 标 记 表 示 ， 并 且 带 
有 各 种 特性 ， 以 通知 ASPNET 运 行 库 如 何 处 理 特性 。 


人 @D 当 你 要 做 的 事情 的 最 难 部 分 取决 于 很 多 细节 时 ， 你 就 可 以 使 用 这 个 谚语 。 一 一 译 者 注 
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每 个 *.aspx 文 件 至 少 必须 有 一 个 <%@Page%> 指 令 ， 它 用 来 定义 在 页 面 内 使 用 的 托管 语言 (通过 
language 特 性 ), 同时 ,<%@Page%> 指 令 可 以 定义 相关 代码 隐藏 文件 的 名 字 ( 如 果 有 的 话 ), 等 等 。 表 32-1 
给 出 了 一 些 更 有 趣 的 <%@Page%> 相 关 的 特性 。 


表 32-1 <%@Page%> 指 令 的 部 分 特性 





特 性 作 - “时 
CodePage 上 § 定 相关 代码 隐藏 文件 的 名 字 
EnableTheming ea 
EnableViewState 省 定 是 否 在 网 页 请 求 期 间 保 持 视 图 状态 ( 详细 说 明 见 第 33 章 ) 
Inherits 在 代码 隐藏 页 面 中 定义 一 个 派生 出 *.aspx 文 件 的 类 , 这 个 类 可 以 是 从 System.Web.UI.Page 派 生 
出 的 任何 类 
MasterPageFile 设置 与 当前 *.aspx 页 面 一 同 使 用 的 母 版 页 面 
Trace 首 定 是 否 启 用 跟踪 


除 <%@Page%> 指 令 外 ， 给 定 的 *.aspx 文 件 可 以 指定 各 种 <%@Import%> 指 令 ， 以 显 式 地 声明 当前 页 面 
需要 的 命名 空间 ， 还 可 以 指定 <%@Assembly%> 指 令 以 确定 站 点 所 使 用 的 外 部 代码 库 ( 通常 位 于 网 站 的 
\bin 文 件 夹 下 )。 

在 这 个 例子 中 ， 指 定 正在 使 用 AutoLotAL.dll 程 序 集 中 AutoLotConnectedLayer 命 名 空间 内 的 类 型 。 可 
以 料 到 ,如 果 需 要 使 用 更 多 的 .NET 命 名 空间 ,只 要 指定 多 个 <%@Import%> 指 令 或 <%@Assembly%> 指 令 即 可 。 

ASPNET 定 义 了 大 量 的 其 他 指令 ,它们 会 出 现在 一 eR ed 并 位 于 <%@Page%> <%@Import%> 
和 <%@Assembly%> 之 外 ， 然 而 ， 我 暂时 先 不 讲 这 些 。 在 学 习 剩 余 章 节 时 ， 你 将 看 到 其 他 指令 的 例子 。 


32.7.5 脚本 块 


在 单 文件 页 面 模型 下 ， 一 个 *.aspx 文 件 可 能 包含 在 Web 服 务 器 端 执行 的 服务 器 端 逻辑 脚本 。 因 此 
所 有 服务 器 端 代码 块 都 限定 在 服务 器 端 执 行 很 重要 ， 要 使 用 runat="server" 特 性 。 如 果 不 提供 
runat="server" 特 性 , 运行 库 会 假设 你 编写 了 一 个 客户 端 脚本 程序 块 提交 给 传 出 的 HTTP 响 应 并 且 它 会 
抛 出 异常 。 下 面 是 合适 的 服务 器 端 <script> 块 : 


<script runat="server"> 
protected void btnFillData Click(object sender, EventArgs args) 


‘ 
InventoryDAL dal = new InventoryDAL(); 
dal.0penConnection(@"Data Source=(local)\SQOLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 
carsGridView.DataSource = dal.GetAllInventory(); 
carsGridView.DataBind(); 
dal.CloseConnection(); 


pe 
个 辅助 方法 的 签名 你 应 该 相当 熟悉 。 给 定 的 事件 处 理 程序 必须 匹配 由 相关 的 .NET 委 托 定义 的 模 
Re Sadie 它 只 能 调用 以 System.0bject 作 为 第 一 个 参数 ，System.EventArgs 
作为 第 二 个 参数 的 方法 。 
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说 明 所 有 ASPNET Web 控 件 都 需要 在 开放 式 的 声明 中 添加 Tunat="server" 特 性 。 否 则 ，HTML 将 不 
能 呈现 在 输出 的 HTTP 响 应 中 。 


32.7.6 ASPNET 控 件 声明 


最 后 介绍 一 下 Button、Label 和 GridView Web 控 件 的 声明 。 同 传统 的 ASP 和 原始 HTML 类 似 ， 
ASPNET Web 部 件 必须 在 <form> 元 素 范围 内 。 但 这 时 ， 开 始 标 签 <form> 中 包含 rTunat="server" 特 性 ， 
并 且 所 有 的 控件 都 用 asp: 标 签 前 级 进行 限定 。 所 有 使 用 该 前 缀 的 控件 都 属于 ASP.NET 控 件 库 ,并 且 都 
在 .NET 基 础 类 库 的 某 个 命名 空间 中 包含 相应 的 C# 类 。 例 如 : 


<form id="form1" runat="server"> 
<div> 
<asp:Label ID="lblInfo" runat="server" 
Text="Click on the Button to Fill the Grid"> 
</asp:Label> 
<br /> 
<br /> 
<asp:GridView ID="carsGridView" runat="server"> 


</asp:GridView> 


<br /> 
<asp:Button ID="btnFillData" runat="server" Text="Fill Grid" OnClick="btnFillData Click"/> 


</div> 
</form> 


System.Web.dll 程 序 集中 的 System.Web.UI.WebControls 命 名 空间 包含 大 量 ASPNET Web 控 件 。 打开 
Visual Studio 的 Object Browser， 可 以 找到 DataGrid 控 件 ( 如 图 32-13 所 示 )。 


Object Browser + X Defaultaspx 
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图 32-13 ”所 有 的 ASP.NET 控 件 的 声明 都 与 一 个 .NET 类 类 型 相对 应 
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如 你 所 见 , ASPNET Web 控 件 继承 链 的 最 顶端 为 System.0bject。 所 有 ASPNET 控 件 的 共同 父 类 为 
WebControl， 它 定义 了 所 有 公共 的 UI 属性 ( BackColor 、Height 等 )。Control 类 在 框架 中 也 是 很 常见 
的 ， 它 定义 了 与 基础 结构 相关 的 成 员 ( 数据 绑 定 、 视 图 状态 等 )， 而 不 是 子 类 的 图 形 外 观 。 你 将 在 第 
33 章 中 学 习 更 多 关于 这 些 类 的 知识 。 














源 代 码 ”SinglePageModel 页 面 的 源 代码 位 于 Chapter 32 子 目录 下 。 








32.8 ”使 用 代码 文件 构建 ASP.NET Web 页 面 


尽管 单 文件 代码 模型 很 有 帮助 , 但 Visual Studio( 在 新 建 Web 项 目 时 ) 默 认 使 用 的 是 代码 隐藏 技术 ， 
它 允 许 你 将 HTML 表 现 逻 辑 和 服务 器 端 编程 代码 分 别 放 在 两 个 不 同 的 文件 中 。 该 模型 尤其 适用 于 页 面 
包含 大 量 代码 或 多 人 开发 同一 个 网 站 的 情况 。 代 码 隐 藏 模型 还 提供 了 其 他 一 些 好 处 。 

口 代码 隐藏 页 面 完 全 分 离 了 HTML 标 记 和 代码 ， 因 此 可 以 让 设计 师 操 作 标 记 ， 而 让 程序 员 编 写 


C# 代 人 码 。 
口 对 于 页 面 设计 师 或 其 他 只 操作 页 面 标记 的 人 来 说 ， 代 码 是 不 可 见 的 ( 你 知道 ，HTML 人 员 对 C# 
代码 没什么 兴趣 )。 


口 代码 文件 可 用 于 多 个 *.aspx 文 件 。 

不 管 采用 哪 种 方式 ， 性 能 上 都 没有 什么 不 同 。 实 际 上 ， 很 多 ASPNET Web 应 用 程序 都 同时 使 用 了 
这 两 种 方法 。 为 了 说 明代 码 隐藏 页 面 模型 , 我 们 使 用 Visual Studio Web Site 模 板 再 创建 一 次 先前 的 示例 。 
打开 File 一 New 一 Web Site 菜 单项 ， 选 择 ASPNET Empty Web Site 模 板 ， 如 图 32-14 所 示 。 





i 上 
i aspNET Web FormsSte Visual Cs ee | 
| Templates An ervpty Web te 
| Ma nse 声 ASP .NET Web Site (Razor v2) visual 
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§ 
Samples ex | 
| 医 ASP NET Web Site {Racoj Visual C# |: 
ss 


ow 
ASPNET Dynamic Oate Enttier Web She 
ea 
WEF Service 


ASP NET Reports Web Site 


Yalatfom Soah Ed fln progrers\Code. Chapter 32\CodeBenindpageMiode! » { Bre 





图 32-14 ”Empty Web Site 模 板 
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注意 在 图 32-14 中 ， 可 以 选择 新 站 点 的 位 置 。 如 果 选 择 File System， 内 容 文件 将 放置 在 一 个 本 地 目 
录 中 ， 页 面 将 通过 ASPNET Development Web Server 提 交 。 如 果 选 择 FTP 或 者 HTTP， 站 点 将 驻 留 在 一 
个 由 IIS 维 护 的 虚拟 目录 中 。 对 本 例 来 说 ， 你 选择 哪 项 是 没有 差别 的 ， 但 我 建议 你 选择 File System 项 并 
且 指 定 一 个 新 的 文件 夹 C:\CodeBehindPageModel。 


说 明 Empty Web Site 项 目 模板 将 自动 包含 一 个 web.config 文 件 ， 它 与 桌面 程序 中 的 App.config 文 件 类 
似 。 本 章 稍 后 将 介绍 该 文件 的 格式 。 


现在 ， 使 用 Website 一 Add New Item... 菜 单 选 项 ， 搬 入 一 个 新 的 Web Form 项 ， 取 名 为 Default.aspx。 
你 会 发 现 默认 情况 下 ，Place code in separate file 复 选 框 为 选中 状态 ， 这 正 是 我 们 想 要 的 ( 如 图 32-15 





Sesrch Instaited Termpidtes 
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寻 Web API Controller Class 

Web Page (Razor v2} 
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图 32-15 ”添加 一 个 代码 分 离 的 Web Form 

再 次 利用 设计 器 创建 一 个 由 Label 、Button 和 Gridview 组 成 的 UI， 并 使 用 Properties 窗 口 建 立 一 个 
你 喜欢 的 UI。 如 果 愿 意 , 可 以 直接 将 SingleFilePageModel 示 例 中 的 ASPNET 控 件 声明 赋值 到 新 的 *.aspx 
文件 中 。 由 于 是 完全 相同 的 标记 ， 在 此 不 会 赣 述 ( 不 过 要 记得 将 控件 声明 粘贴 到 <form> 和 </form> 标 
签 中 oo 

注意 为 用 于 代码 文件 模型 中 的 <%@ Page%> 指 令 添加 如 下 两 个 新 特性 : 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="Default.aspx.cs" Inherits=" Default" %> 


CodeFile 特 性 用 来 指定 相关 的 、 包 含 这 个 页 面 的 代码 逻辑 的 外 部 文件 。 默 认 情况 下 ， 这 些 代码 隐 
藏 文件 在 *.aspx 名 字 后 面 加 上 .cs 后 级 ( 本 例 中 是 Default.aspx.cs )。 如 果 查 看 Solution Explorer， 通 过 一 
个 在 Web Form 图 标 上 的 子 节点 看 到 这 个 代码 隐藏 文件 是 可 见 的 ( 如 图 32-16 所 示 )。 

打开 代码 隐藏 文件 ， 你 发 现 派生 自 System.Web.UI.Page 的 分 部 类 支持 处 理 Load 事 件 。 注 意 ， 这 个 
类 (_Default ) 的 名 字 同 在 <%@Page%> 指 令 内 的 Inherits 特 性 是 一 样 的 : 
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public partial class Default : System.Web.UI.Page 


protected void Page Load(object sender, EventArgs e) 


} 
} 


= SOLUTION EXPLORER 局 
和 人 各国 总 中 | zj almlole 


| Search Solution Explorer (Ctrl+ 7) 


Solution CodeBehindPageModel (1 project) 
4 图 CodeBehindPageModel 


4 图 Defaultaspx 
ST Defaultaspxcs 
恰 Web.config 





SOLUTION EXPLORER TEAMEXPLORER 
图 32-16 针对 给 定 *.aspx 文件 的 相关 代码 隐藏 文件 


32.8.1 引用 AutoLotDAL.dll 程 序 集 


之 前 提 过 ， 如 果 使 用 Visual Studio 创 建 Web 应 用 程序 项 目 ， 我们 不 需要 手动 构建 \bin 子 文件 夹 并 且 
手动 复制 私有 程序 集 。 对 于 这 个 示例 ， 使 用 Website 菜 单项 激活 Add Reference 对 话 框 并 且 引 用 
AutoLotDAL.dll。 然 后 ， 就 会 在 Solution Explorer 中 看 到 新 的 \bin 文 件 夹 ， 如 图 32-17 所 示 。 


2 SOLUTION EXPLORER :2 voxl 
S68mem|rlQnmPD| 
Search Solution Explorer (Ctrl+;) A 

图 Solution 'CodeBehindPageModel' (1 project) 
“4 @ CodeBehindPageModel 
| 4 调 Bin 


~b [IH]AutoLotDALdl 
by 和 维 Default.aspx 
Web,config 





SOLUTION EXPLORER TEAM EXPLORER 


图 32-17 ” Visual Studio Web 项 目 使 用 特殊 的 ASP.NET 文 件 夹 
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32.8.2 ”更 新 代码 文件 


通过 双击 设计 器 上 的 Button 为 Button 类 型 处 理 cClick 事 件 。 像 以 前 一 样 ，Button 定 义 被 0nClick 特 性 
更 新 了 。 然 而 ， 服 务 絮 端 事件 处 理 程序 不 再 放置 在 *.aspx 文 件 的 <script> 作 用 域内 ， 而 是 作为 一 种 
_Default 类 类 型 的 方法 。 

为 了 完成 这 个 例子 , 在 代码 隐藏 文件 内 为 AutoLotConnectedLayer 添 加 一 个 using 语 句 , 并 使 用 先前 
的 逻辑 实现 处 理 程序 ( 同样 ， 请 更 新 连接 字符 串 ): 

using AutoLotConnectedLayer; 

public partial class Default : System.Web.UI.Page 


protected void Page Load(object sender, EventArgs e) 


} 
protected void btnFillData Click(object sender, EventArgs e) 


InventoryDAL dal = new InventoryDAL(); 
dal.OpenConnection(@"Data Source=(local)\SQOLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 
carsGridView.DataSource = dal.GetAllInventoryAsList(); 
carsGridView.DataBind(); 

dal.CloseConnection(); 


} 
} 


现在 ， 按 下 Ctrl+F5 组 合 键 运行 网 站 。ASPNET Development Web 服 务 器 将 再 次 启动 ， 将 页 面 显示 
在 承载 的 浏览 器 中 。 


32.8.3 调试 并 跟踪 ASPINET 页 面 


当 构建 ASPNET Web 项 目 时 , 你 能 如 愿 地 使 用 Visual Studio 项 目 类 型 中 任何 种 类 的 调试 技术 。 这 样 ， 
就 能 在 代码 隐藏 文件 中 设置 断 点 ( 以 及 在 *.aspx 文 件 中 获 和 人 “脚本 ” 块 ), 启动 调试 会 话 ( 默认 用 F5 键 )， 
单 步调 试 代码 。 

然而 ， 为 调试 ASPNET Web 应 用 程序 ， 站 点 必须 包括 一 个 正确 配置 的 web.config 文 件 。 默 认 情 况 
下 ,所 有 Visual Studio Web 项 目 都 会 自动 具备 一 个 web.config 文 件 。 然 而 , 调试 支持 一 开始 就 是 禁用 的 。 
如 果 开 始 一 个 调试 会 话 , IDE 会 提示 我 们 是 否 修改 web.config 以 启用 调试 。 如 果 确 认 启 用 , 在 web.config 
中 会 按 如 下 所 示 更 新 一 个 <compilation> 元 素 : 

<compilation debug="true" targetFramework="4.5"/> 

我 们 还 可 以 通过 将 <%@Page%> 指 令 中 的 Trace 特 性 设置 为 true 来 启用 *.aspx 文 件 的 跟踪 支持 ( 还 可 以 
通过 修改 web.config 文 件 来 为 整个 网 站 启用 跟踪 ): 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="Default.aspx.cs" Inherits=" Default" Trace="true" %> 


一 旦 这 样 设置 了 ,已 提交 的 HTML 就 会 包含 很 多 关于 先前 HTTP 请 求 /响应 的 细节 ( 服务 器 变量 、 
会 话 和 应 用 程序 变量 请求/ 响应， 等 等 )。 
可 以 使 用 System.Web.UI.Page 类 型 的 Trace 属性 把 你 自己 的 跟踪 消息 插入 其 中 。 任 何 时 候 想 记 录 自 
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定义 消息 日 志 (从 一 个 脚本 块 或 C# 源 代码 文件 ) 的 话 ， 只 需 调用 Trace.Write() 方 法 即 可 。 其 第 一 个 参 
数 表示 自 定义 类 别 的 名 称 ， 第 二 个 参数 指定 了 跟踪 消息 。 为 了 演示 这 一 点 , 使 用 如 下 的 代码 语句 更 新 
Button 的 Click 处 理 程序 : 

protected void btnFillData Click(object sender, EventArgs e) 


Trace.Write("CodeFileTraceInfo!", "Filling the grid!"); 


i 
如 果 再 一 次 运行 项 目 并 且 单 击 该 按钮 ， 将 呈现 并 解释 自 定义 种 类 和 自 定义 消息 。 如 图 32-18 所 示 ， 
注意 突出 显示 的 消息 ， 它 呈现 的 是 跟踪 信息 。 
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Def eTrac. 时 
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EE aspx.page End LoadComplete 0.002060 0.000014 
| ;My st aspx.page Begin PreRender 0.002072 0.000013 
| ns ovand Berlriiins aspx.page End PreRender 0.002095 0.000023 
aspx.page Begin PreRenderCompiete 0.002109 0.000014 
aspx,page End PreRenderComplete 0.002122 0.000012 
全 aspx.page Begin SavaState 0.003022 0.000901 


机 





图 32-18 ”记录 自 定义 的 跟踪 信息 


至 此 ， 我 们 已 经 学 习 了 如 何 使 用 单 文 件 和 代码 文件 构建 ASPNET Web 页 面 。 本 章 剩 余部 分 将 深入 
人 研究 ASPNET Web 项 目的 构成 .与 HTTP 请 求 / 响应 交互 的 方式 以 及 Page 派 生 类 的 生命 周期 ,在 此 之 前 ， 
我 需要 阐述 一 下 ASP.NET Web Site 和 ASPNET Web Application 的 区 别 。 


源 代码 ”CodeBehindPageModel 网 站 的 源 代码 位 于 Chapter 32 子 目录 下 。 


32.9 ASP.NET Web Site 和 ASP.NET Web Application 


在 构建 ASPNET Web 项 目 时 ， 你 需要 在 两 种 项 目 格式 之 间作 出 选择 ， 它 们 是 ASPNET Web Site 和 
ASPNET Web Application。Visual Studio 组 织 和 处 理 Web 应 用 程序 启动 文件 的 方式 、 所 创建 的 初始 项 目 
文件 的 类 型 以 及 对 编译 的 .NET 程 序 集 组 成 部 分 的 控制 程度 ， 都 取决 于 你 的 选择 。 

当 ASPNET 随 .NET 1.0 发 布 伊 始 , 我 们 唯一 的 选择 是 Web Application。 在 这 种 模型 下 ,可 以 直接 控 
制 编译 输出 的 程序 集 的 名 称 和 位 置 。 

在 将 旧 的 .NET 1.1 网 站 向 .NET 2.0 或 更 高 的 版 本 迁移 时 ，Web Application 十 分 有 用 。 如 果 和 希望 构建 
一 个 包含 多 个 项 目的 Visual Studio Solution ( 如 包含 一 个 Web Application 和 3 个 相关 的 .NET 代 码 库 )， 它 
也 十 分 有 帮助 。 要 构建 ASPNET Web Application， 可 以 激活 File 一 New Project... 菜 单项 , 在 Web 分 类 里 
选择 模板 ( 如 图 32-19 所 示 )。 
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图 32-19 ”Visual Studio Web Application 模 板 


而 现在 没有 必要 这 么 做 了 。 假设 你 新 建 了 一 个 ASPNET Web Application 项 目 ， 会 发 现 大 量 的 启动 
文件 ( 在 后 面 的 章节 中 将 会 介绍 ), 但 重要 的 是 要 注意 每 个 ASPNET Web 页 面 都 由 3 个 文件 组 成 , *.aspx 
文件 (标记 )、*.designer.cs 文 件 (设计 器 生成 的 C# 代 码 ) 和 主 C# 代 码 文件 (事件 处 理 程序 和 自 定义 方 
法 等 )， 如 图 32-20 所 示 。 
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图 32-20 在 Web Application 模 型 下 ， 每 个 Web 页 面 由 3 个 文件 组 成 


说 明 由 于 Visual Studio 的 ASPNET 项 目 模板 生成 了 大 量 的 启动 代码 ( 母 版 页 、 内 容 页 、 脚 本 库 、 页 
面 日 志 等 )， 本 书 将 使 用 Blank Web Site 模 板 。 但 是 ， 学 习 完 本 书 的 ASPNET 内 容 之 后 ， 你 应 该 
创建 一 个 ASPNET Web Site 项 目 ， 并 在 第 一 时 间 研 究 这 些 启动 代码 。 
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与 之 形成 鲜明 对 比 的 是 , Visual Studio 中 的 ASPNET Web Site 项 目 模 板 ( 打开 File 一 New Web Site..…. 
菜单 选项 可 以 找到 ) 隐藏 了 *.designer.cs 文 件 ， 以 支持 内 存 分 部 类 。 此 外 ，ASP.NET Web Site 项 目 还 支 
持 很 多 特殊 名 称 的 文件 来， 如 App_Code。 在 该 文件 夹 中 ， 可 以 放置 那些 不 与 Web 页 面 直接 映射 的 C# 
(或 VB ) 代码 文件 ， 运行 时 编译 器 将 在 需要 时 动态 编译 。 这 比 单独 构建 ,NET 代码 库 并 在 新 项 目 中 引用 
这 种 常见 的 做 法 要 简单 得 多 。 

此 外 ，Web Site 项 目 可 以 按 原样 发 布 ， 而 ASPNET Web Application 需 要 对 网 站 进行 预 编译 。 

我 在 本 书 中 将 使 用 ASPNET Web Site 项 目 类 型 ， 因 为 它 确 实 简 化 了 在 .NET 平 台 下 构建 Web 应 用 程 
序 的 过 程 。 不 过 ， 不 管 使 用 哪 种 方法 ， 都 将 访问 同样 的 编程 模型 。 


32.10 ASPNET 网 站 目录 结构 


当 创 建 一 个 新 的 ASP.NET 网 站 项 目 时 ， 你 的 项 目 可 能 包括 许多 特定 名 字 的 子 目录 ， 其 中 的 每 一 个 
对 于 ASP.NET 运 行 库 来 说 都 有 一 个 特定 的 含义 。 表 32-2 列 出 了 这 些 特殊 的 子 目录 。 


表 32-2 ”特殊 的 ASP.NET 子 目录 





子 目录 作 用 
App_Browsers 浏览 器 定义 文件 的 文件 夹 ， 这 些 文件 用 于 识别 各 个 浏览 器 并 确定 其 性 能 
App_Code 组 件 或 类 的 源 代码 的 文件 来， 这些 组 件 或 类 是 要 编译 成 为 应 用 程序 的 一 部 分 。 当 要 请 求 
页 面 时 ，ASP.NET 编 译 该 文件 夹 里 的 代码 。App_Code 文 件 夹 里 的 代码 对 应 用 程序 是 自动 
可 访问 的 
App_Data 用 于 存储 Access 的 *.mdb 文 件 、SQL Express 的 *.mdf 文 件 、XML 文 件 或 其 他 数据 存储 的 文 
件 夹 


App_ClobalResources 用 于 存储 *.resx 文 件 的 文件 夹 ， 这 些 文件 可 以 通过 编程 从 应 用 程序 代码 访问 
App_LocalResources 用 于 存储 *.resx 文 件 的 文件 夹 ， 这 些 文件 与 特定 的 网 页 相 绑 定 


App_Themes 包含 用 来 定义 ASP.NET 网 页 和 控件 外 观 的 文件 集合 的 文件 夹 
App_WebReferences 用 于 存储 代理 类 、 架 构 和 与 在 应 用 程序 里 使 用 Web 服 务 相关 的 其 他 文件 的 文件 来 
Bin 用 于 存储 经 过 编译 的 私有 程序 集 (*.dl 文 件 ) 的 文件 夹 。 存 放 在 Bin 文 件 夹 里 的 程序 集 被 


应 用 程序 自动 引用 


如 果 你 想 把 这 些 子 文件 夹 添加 到 你 当前 的 web 应 用 程序 里 ， 可 以 显 式 地 使 用 Website 一 Add 
ASPNET Folder 菜 单项 。 然 而 ， 在 许多 时 候 ， 当 你 向 站 点 “自然 地 ”添加 相关 文件 时 ，IDE 会 自动 做 
这 些 事情 。 例如， 当 你 增加 一 个 新 的 C# 文 件 时 ，IDE 将 自动 向 目录 结构 添加 一 个 App_Code 文 件 夹 ， 如 
果 该 文件 夹 不 存在 的 话 。 


32.10.1 引用 程序 集 


虽然 Web Site 模板 生 成 一 个 *.sln 文 件 , 将 *.aspx 文 件 加 载 到 IDE 里 , 但 是 不 再 有 相关 的 *.csproj 文 件 。 
你 可 能 知道 ，ASP.NET Web Application 项 目 在 *.csproj 里 记录 了 所 有 的 外 部 程序 集 。 这 个 事实 带 来 了 明 
显 的 问题 ， 在 ASP.NET 下 外 部 程序 集 记录 到 哪儿 去 了 ? 

当 引 用 一 个 私有 程序 集 时 ，Visual Studio 将 自动 在 目录 结构 中 创建 一 个 \bin 目 录 以 存储 一 个 二 进 制 
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的 本 地 副本 。 当 你 的 代码 利用 了 这 些 代码 库 中 的 类 型 时 ， 它 们 会 按 需 自动 加 载 。 

如 果 在 GAC 中 引用 一 个 共享 程序 集 ，Visual Studio 会 自动 向 当前 的 Web 解 决 方案 中 插入 一 个 
web.config 文 件 ( 如 果 没 有 这 个 文件 )， 并 且 在 cassemblies> 元 素 内 记录 这 个 外 部 引用 。 例 如 ， 如 果 你 
再 打开 Web Site 一 Add Reference 菜 单项 ， 这 次 选择 一 个 共享 程序 集 ( 例如 System.Security.dll )， 你 将 发 现 
web.config 文 件 被 更 新 了 ， 如 下 所 示 : 


<assemblies> 
<add assembly="System.Security, Version=4.0.0.0, 
Culture=neutral, PublicKeyToken=BO3F5F7F11D50A3A"/> 
</assemblies> 


正如 所 见 ， 描 述 每 个 程序 集 所 用 的 信息 ， 与 通过 Assembly.Load() 方 法 来 动态 加 载 ( 参见 第 15 章 ) 
所 需 的 信息 是 一 样 的 。 


32.10.2 App_Code 文 件 夹 的 作用 


App_Code 文 件 夹 用 来 放置 源 代 码 文件 , 这 些 文件 不 直接 绑 定 到 一 个 特定 的 网 页 ( 例如 一 个 代码 隐 
藏 文件 )， 但 会 被 编译 以 备 网 站 使 用 。App_Code 文 件 夹 内 的 代码 将 会 在 需要 的 时 候 被 自动 编译 。 在 这 
之 后 , 程序 集 就 可 以 被 网 站 内 的 任何 其 他 代码 访问 了 。 因 此 , 除了 能 在 App_Code 文 件 夹 中 存储 源 代码 
而 不 是 编译 后 的 代码 外 , 它 更 像 Bin 文 件 夹 。 这 种 方法 的 主要 优点 是 , 使 得 为 Web 应 用 程序 定义 自 定义 
类 型 而 不 必 对 它们 进行 独立 编译 成 为 可 能 。 

一 个 App_Code 文 件 夹 能 包括 多 种 语言 的 代码 文件 。 在 运行 时 ， 适 当 的 编译 器 会 被 载 入 以 生成 相应 的 
程序 集 。 但 是 , 如 果 你 愿意 分 割 代码 , 就 能 定义 多 个 子 目 录用 于 保存 许多 被 托管 代码 文件 ( *.vb、*.cs 等 )。 

例如 , 假设 你 已 经 在 一 个 网 站 应 用 程序 的 根 目录 下 添加 了 App_Code 文 件 夹 , 它 包括 两 个 子 文件 夹 
( MyCSharpCode 和 MyVbNetCode ), 分 别 包含 特定 语言 的 文件 。 一旦 添加 了 文件 夹 , 你 就 能 够 编辑 web. 
config 文 件 , 在 文件 中 使 用 骨 套 在 <configuration> 元 素 内 的 <codeSubDirectories> 元 素 指定 这 些 子 目 录 ， 
如 下 所 示 : 


<compilation debug="true" strict="false" explicit="true"> 
<codeSubDirectories> 
<add directoryName="MyCSharpCode" /> 
<add directoryName="MyVbNetCode" /> 
</codeSubDirectories> 
</compilation> 


OOO OO 


说 明 App _ Code 目录 也 将 用 于 包括 非 语言 文件 的 、 但 很 有 用 的 文件 (*.xsd 文 件 、*.wsdl 文 件 等 )。 











除了 Bin 和 App_Code 以 外 ,App_Data 和 App_Themes 文 件 夹 也 是 我 们 需要 熟悉 的 另外 两 个 特殊 子 文 
件 夹 ， 之 后 几 童 中 我 们 会 详细 介绍 。 同 样 ， 如 果 需 要 知道 更 多 有 关 其 余 ASP.NET 子 目录 的 细节 ， 请 参 
考 .NET Framework 4.5 SDK 文 档 。 


32.11 页 面 类 型 的 继承 链 
所 有 .NET 网 页 最 终 派 生 自 System.Web.UI.Page。 像 任何 基 类 一 样 ， 这 个 类 型 提供 了 一 个 对 所 有 派 
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生 类 型 的 多 态 接口 。 然 而 ,Page 类 型 不 是 继承 层次 结构 的 唯一 成 员 。 如 果 要 使 用 Visual Studio 对 象 浏览 
器 找到 System.Web.UI.Page 类 (在 System.Web.dll 程 序 集 中 )， 你 将 发 现 Page “is-a”TemplateControl， 
TemplateControl “is-a” Control1，Control “is-a”0bject( 如 图 32-21 所 示 )。 


Web.c 
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图 32-21 页 面 的 继承 链 


这 些 基 类 的 每 一 个 都 给 每 个 *.aspx 文 件 提供 了 大 量 的 功能 。 对 于 大 部 分 项 目 ， 可 以 利用 Page 和 
Control 父 类 中 定义 的 成 员 。 大 体 上 来 讲 ， 如 果 你 正在 创建 自 定义 Web Form 控 件 或 正在 与 呈现 进程 交 

， 你 将 对 从 System.Web.UI.TemplateControl 类 中 获得 的 功能 感 兴趣 。 

第 一 个 介绍 的 父 类 是 Page 自 身 。 这 里 有 许多 属性 ， 用 于 与 各 种 基本 的 Web 对 象 ( 例如 应 用 程序 变 
量 和 会 话 变量 、HTTP 请 求 /响应 、 主 题 支持 等 ) 进行 交互 。 表 32-3 描 述 了 一 些 (但 不 是 全 部 ) 核心 
属性 。 


表 32-3 ”Page 类 型 的 属性 
属 性 作 用 
Application 允许 在 整个 站 点 内 与 可 以 访问 的 数据 进行 交互 
Cache 允许 针对 当前 站 点 与 高 速 缓存 对 象 进行 交互 
ClientTarget 人 允许 指定 该 页 面 应 当 如 何 根据 发 出 请 求 的 浏览 器 来 呈现 自身 
IsPostBack 获取 一 个 值 ， 这 个 值 指示 正在 加 载 的 页 面 是 否 响应 了 客户 端 回 传 ， 或 该 页 面 是 否 是 首次 被 
加 载 和 访问 
MasterPageFile 为 当前 页 面 使 用 母 版 页 
Request 允许 访问 当前 HTTP 请 求 
Response 允许 与 发 出 的 HTTP 响 应 进行 交互 
Server 允许 访问 HttpServerUtility 对 象 ， 该 对 象 包含 了 各 种 服务 器 端的 帮助 功能 
Session 允许 针对 当前 调用 者 与 会 话 数据 进行 交互 
Theme 获取 或 设置 用 于 当前 页 面 的 主题 名 称 
Trace 人 允许 访问 TraceContext 对 象 ，TraceContext 对 象 允许 在 调试 会 话 期 间 记 录 自 定义 的 信息 
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32.12 与 传 入 的 HTTP 请 求 交 互 


在 本 章 的 前 文中 已 经 看 到 ，Web 应 用 程序 的 基本 流程 开始 于 客户 登录 到 网 页 ， 填 写 用 户 信息 ， 然 
后 单 击 Submit 按 钮 以 向 给 定 的 网 页 回 传 HTML 表 单数 据 进行 处 理 。 大 多 数 情 况 下 ，form 语 句 的 开始 标 
签 指定 一 个 action 特 性 和 一 个 method 特 性 , 这 两 个 特性 分 别 指定 各 种 HTML 部 件 中 数据 要 发 送 到 的 Web 
服务 器 上 的 文件 ， 以 及 发 送 这 个 数据 ( GET 或 POST ) 的 方法 : 


<form name="defaultPage" id="defaultPage" 
action="http://localhost/Cars/ClassicAspPage.asp" method = "GET"> 


</form> 


所 有 的 ASP.NET 页 面 都 支持 System.Web.UI.Page.Request 属 性 ， 它 允许 访问 一 个 HttpRequest 类 类 
型 实例 ( 参见 表 32-4， 其 中 列 出 了 一 些 核心 成 员 )。 


成 员 
ApplicationPath 
Browser 
Cookies 
Filepath 
Form 
Headers 
HttpMethod 
IsSecureConnection 
QueryString 
RawUrl 
RequestType 
ServerVariables 
UserHostAddress 


UserHostName 


表 32-4 HttpRequest 类 的 成 员 


作 用 
获取 ASP.NET 应 用 程序 的 虚拟 应 用 程序 在 服务 器 上 的 根 路 径 
提供 关于 客户 端 浏 览 器 的 功能 的 信息 
获取 由 客户 端 浏览 器 发 送 的 cookie 的 集合 
指示 当前 请 求 的 虚拟 路 径 
获取 HTTP 表 单 变量 的 集合 
获取 HTTP 首 部 的 集合 
指明 由 客户 端 使 用 的 HTTP 数 据 传 输 的 方法 ( GET、 POST ) 
指明 HTTP 连 接 是 否 安 全 ( 即 HTTPS ) 
获取 HTTP 查 询 字 符 串 变量 的 集合 
获取 当前 请 求 的 原始 URL 
指明 由 客户 端 使 用 的 HTTP 数 据 传输 的 方法 (GET、 POST ) 
获取 Web 服 务 器 变量 的 集合 
获取 远程 客户 端的 IP 地 址 
获取 远程 客户 端的 DNS 名 


除了 这 些 属性 外 ，HttpRequest 类 型 还 有 大 量 有 用 的 方法 ， 如 下 所 示 。 

口 MapPath(): 针对 当前 请 求 ， 将 被 请 求 URL 中 的 虚拟 路 径 映 射 到 服务 器 上 的 一 个 物理 路 径 。 

口 saveAs(): 将 当前 HTTP 请 求 的 细节 保存 到 一 个 Web 服 务 器 上 的 文件 ( 对 于 调试 是 有 帮助 的 )。 

口 ValidateInput(): 如 果 通 过 页 面 指令 的 Validate 特 性 激活 了 验证 功能 , 可 以 调用 这 个 方法 , 根 
据 预 定义 的 危险 输入 数据 列表 来 检查 所 有 的 用 户 输入 数据 ( 包括 cookie 数 据 )。 


32.12.1 获得 浏览 器 统计 数据 
HttpRequest 类 型 的 第 一 个 有 趣 的 方面 是 Browser 属 性 ， 它 提供 了 对 底层 HttpBrowserCapabilities 
对 象 的 访问 。HttpBrowserCapabilities 则 公开 了 大 量 的 成 员 ， 人 允许 你 通过 编程 检查 发 送 传人 HTTP 请 


求 的 浏览 器 的 统计 数据 。 
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使 用 File 一 New Website 菜 单 选项 ， 并 选中 使 用 File System 选项 创建 一 个 新 的 ASPNET 站 点 ， 命 名 
为 FunWithPageMembers。 接 下 来 ， 使 用 Website 一 Add New Item 菜 单 选项 插入 一 个 新 的 Web Form 文 件 。 

我 们 的 第 一 个 任务 是 建立 一 个 UI 允许 用 户 单 击 Button Web 控 件 btnGetBrowserStars 以 浏览 发 
送 命 令 的 浏览 器 的 统计 数据 。 这 些 统计 数据 将 动态 生成 并 附加 在 一 个 Label 类 型 ( 名 为 lbl0utput ) 
上 。 可 以 在 Web 页 设计 器 的 任意 位 置 添 加 两 个 控件 。 然 后 处 理 Click 事 件 ， 该 处 理 程序 的 一 种 实现 
如 下 所 示 : 


protected void btnGetBrowserStats Click(object sender, EventArgs e) 
string theInfo = ""; 
theInfo += string.Format("<li>Is the client AOL? {0}</1i>", 
Request.Browser.A0L); 
theInfo += String.Format("<1i>Does the client support ActiveX? {0}</li>", 
Request.Browser.ActiveXControls); 
theInfo += string.Format("<li>Is the client a Beta? {0}</1i>", 
Request .Browser. Beta); 
theInfo += string.Format("<li>Does the client support Java Applets? {0}</1i>", 
Request.Browser.JavaApplets); 
theInfo += string.Format("<li>Does the client support Cookies? {0}</1i>", 
Request.Browser.Cookies); 
theInfo += string.Format("<li>Does the client support VBScript? {0}</1i>", 
Request.Browser.VBScript); 
lblOutput. Text = theInfo; 
} 


这 是 在 测试 大 量 的 浏览 器 功能 。 发 现 一 个 浏览 器 对 ActiveX 控 件 、Java applet 和 客户 端 VBScript 代 
码 的 支持 是 非常 有 帮助 的 。 如 果 发 起 调用 的 浏览 器 不 支持 给 定 的 Web 技 术 ，*#.aspx 页 面 将 可 以 采取 另 
二 个 动作 


32.12.2 访问 传 入 的 表单 数据 


HttpRequest 类 型 还 有 Form 和 Querystring 属 性 。 这 两 个 属性 允许 使 用 名 称 / 值 对 方式 检查 传人 的 表 
单数 据 。 虽 然 你 还 是 可 以 利用 HttpRequest.Form 和 HttpRequest.QueryString 属 性 访问 Web 服 务 器 上 由 客 
户 端 支持 的 表单 数据 , 但 是 ASPNET 提 供 更 优雅 的 面向 对 象 方法 。 假 设 ASPNET 支 持 使 用 服务 器 端 Web 
控件 , 则 可 以 像 对 待 对 象 一 样 对 待 HTML UI 元 素 。 因 此 , 不 是 按 如 下 代码 所 示 在 一 个 文本 框 里 获得 值 : 


protected void btnGetFormData Click(object sender, System.EventArgs e) 


// 使 用 ID txtFirstName 为 部 件 获 取 值 
string firstName = Request.Form("txtFirstName"); 


aod 

而 只 需 通过 Text 属 性 直接 地 请 求 一 个 服务 器 端 部 件 : 

protected void btnGetFormData Click(object sender, System.EventArgs e) 
{ 


// 使 用 ID txtFirstName 为 部 件 获取 值 
string firstName = txtFirstName.Text; 


ee Ck 
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这 个 方法 不 仅 是 纯粹 的 OO ( 面向 对 象 ) 原理 ， 而 且 不 需要 你 考虑 在 获得 值 之 前 表单 数据 是 如 何 
提交 的 (GET 或 poST )。 此 外 ， 直 接 使 用 窗口 部 件 工 作 更 是 类 型 安全 的 ， 因 为 键入 的 错误 是 在 编译 时 而 
不 是 在 运行 时 发 现 的 。 当 然 ， 这 不 是 说 你 永远 不 需要 在 ASPNET 中 使 用 Form 或 Querystring 属 性 ,确切 
地 说 是 ， 这 么 做 的 必要 性 已 经 减少 了 很 多 。 


32.12.3 ” IsPostBack 属性 


Page 的 另 一 个 非常 重要 的 成 员 是 IsPostBack 属 性 。 回 想 一 下 ,“ 回 传 ” 是 指 页 面 回 传 到 Web 服 务 器 
上 相同 的 URL。 有 了 这 个 定义 后 ， 进 而 理解 ， 如 果 当 前 的 HTTP 请 求 被 一 个 当前 的 登录 用 户 发 送 ， 则 
IsPostBack 属 性 将 返回 true; 如 果 这 是 用 户 与 页 面 的 第 一 次 交互 ， 则 IsPostBack 属 性 将 返回 false。 

通常 情况 下 ， 仅 当 用 户 首次 访问 一 个 给 定 的 页 面 ， 而 你 需要 执行 代码 块 时 ， 决 定 当前 HTTP 请 求 
是 否 是 回 传 才 更 有 帮助 。 例 如 ， 当 用 户 首次 访问 *.aspx 文 件 时 ， 你 可 能 希望 填充 ADO.NET DataSet， 
同时 缓存 对 象 以 备 下 次 使 用 。 当 调用 者 返回 到 页 面 时 , 你 能 避免 不 必要 的 对 数据 库 的 过 度 访问 ( 当然 ， 
一 些 页 面 可 能 要 求 DataSet 对 于 每 个 请 求 总 是 更 新 的 ， 但 那 是 另 一 个 问题 )。 假 设 *.aspx 文 件 已 经 处 理 
了 页 面 的 Load 事 件 ( 本 章 后 面 会 详细 介绍 )， 可 以 通过 编程 测试 回 传 条 件 ， 如 下 所 示 : 


protected void Page Load(object sender, EventArgs e) 


// 只 在 用 户 初次 访问 页 面 时 填充 DataSet 
if (!IsPostBack) 


{ 
y // 填充 DataSet 并 且 缓 存 它 
// 使 用 缓存 的 DataSet 

} 
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现在 你 已 经 较 好 地 理解 了 Page 类 型 如 何 允 许 与 传人 HTTP 请 求 交 互 ， 下 一 步 是 看 一 看 如 何 与 输出 
HTTP 响 应 交互 。 在 ASPNET 中 ，pPage 类 的 Response 属 性 提供 了 对 HttpResponse 类 型 的 实例 的 访问 。 这 个 
类 型 定义 了 大 量 的 属性 ,它们 人 允许 格式 化 发 送 回 客户 端 浏览 器 的 HTTP 响 应 。 表 32-5 列 举 了 一 些 核 心 属性 。 


表 32-5 ”HttpResponse 类 型 的 属性 


属 性 作 用 
Cache 返回 网 页 的 高 速 缓存 语义 ( 见 第 34 章 ) 
ContentEncoding 获取 或 者 设置 输出 流 的 HTTP 字 符 集 
ContentType 获取 或 者 设置 输出 流 的 HTTP MIME 类 型 
Cookies 获取 将 返回 到 浏览 器 的 HttpCookie 集 合 
Output 对 输出 HTTP 内 容 主 体 启用 文本 输出 
OutputStream 对 输出 HTTP 内 容 主 体 启用 二 进 制 输出 
StatusCode 获取 或 者 设置 返回 客户 端的 、 关 于 输出 的 HTTP 状 态 代 码 
StatusDescription 获取 或 者 设置 返回 客户 端的 、 关 于 输出 的 HTTP 状 态 字 符 串 


SuppressContent 获取 或 者 设置 指明 HTTP 内 容 不 会 送 回 客户 端的 值 
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同样 ， 考 虑 一 下 表 32-6 中 描述 的 HttpResponse 类 型 支持 的 部 分 方法 。 
表 32-6 ”HttpResponse 类 型 的 方法 


方 法 作 用 

Clear() 从 缓冲 流 里 清除 所 有 首部 和 内 容 输出 

End() 对 客户 端 发 送 所 有 当前 经 过 缓冲 的 输出 ， 并 且 在 这 之 后 关闭 套 接 字 连 接 
Flush() 对 客户 端 发 送 所 有 当前 经 过 缓冲 的 输出 

Redirect() 把 客户 端 重 定向 到 新 的 URL 

write() 向 HTTP 输 出 内 容 流 写 入 值 

WriteFile() 向 HTTP 内 容 输出 流 直接 写 人 一 个 文件 


32.13.1 提交 HTML 内 容 


可 能 HttpResponse 类 型 最 著名 的 一 点 就 是 ， 能 直接 向 HTTP 输 出 流 中 写 内 容 。 通 过 HttpResponse. 
Write() 方 法 ,可 以 传送 任何 HTML 标 签 或 文本 。HttpResponse.WriteFile() 方 法 使 这 个 功能 更 进一步 ， 
用 这 个 方法 你 能 指定 Web 服 务 器 上 物理 文件 的 名 字 ， 这 个 文件 的 内 容 会 呈现 给 输出 流 ( 这 对 于 快速 提 
交 一 个 现 有 的 *.htm 文 件 的 内 容 是 非常 有 帮助 的 )。 

举 个 例子 ， 假 设 你 已 经 添加 了 另 一 个 Button 类 型 到 当前 的 *.aspx 文 件 中 ， 这 个 文件 实现 了 服务 器 
端的 Click 事 件 处 理 程序 ， 如 下 所 示 : 


protected void btnHttpResponse Click(object sender, EventArgs e) 


Response.Write("<b>My name is:</b><br>"); 
Response.Write(this.ToString()); 

Response.Write("<br><br>¢b>Here was your last request:</b><br>"); 
Response.WriteFile("MyHTMLPage.htm"); 


这 个 辅助 函数 的 作用 (你 可 以 假设 它 被 某 些 服务 器 端 事件 处 理 程序 调用 ) 非常 简单 。 唯 一 需要 关 
注 的 是 ，HttpResponse.WriteFile() 方 法 现在 正在 提交 网 站 根 目录 里 的 服务 器 端 *.htm 文 件 的 内 容 。 

再 次 强调 ， 尽 管 总 能 够 使 用 这 个 老 方 法 ， 用 Write() 方 法 呈现 HTML 标 签 和 内 容 ， 但 这 个 方法 
在 ASPNET 下 远 不 及 在 传统 ASP 下 普遍 。 理 由 (再 次 ) 应 归于 出 现 了 服务 器 端 Web 控 件 。 这 样 ， 如 
果 和 希望 向 浏览 器 呈现 一 个 文本 数据 块 ， 你 的 任务 就 像 为 Labe1 部 件 的 Text 属 性 赋 一 个 字符 串 那 么 
简单 。 


32.13.2” 重 定向 用 户 
HttpResponse 类 型 的 男 一 个 方面 就 是 重 定向 用 户 到 一 个 新 URL 的 功能 : 


protected void btnWasteTime Click(object sender, EventArgs e) 


Response.Redirect("http://www.facebook.com"); 


如 果 这 个 事件 处 理 程序 通过 客户 端 回 传 被 调用 ， 用 户 将 自动 地 被 重 定向 到 指定 的 URL。 
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说 明 ”HttpResponse.Redirect() 方 法 将 总 是 涉及 客户 端 浏览 器 的 回 传 。 如 果 你 只 是 希望 在 同一 个 虚拟 
目录 里 将 控件 传 到 一 个 *.aspx 文 件 ， 那 么 HttpServerUtility.Transfer() 方 法 (通过 继承 的 
Server 属 性 访问 ) 将 更 有 效 。 


对 System.Web.UI.Page 功 能 的 研究 到 此 为 止 。 在 下 一 章 中 ， 我 们 将 学 习 System.Web.UI.Control 基 
类 的 作用 。 先 来 研究 Page 派 生 的 对 象 的 生命 周期 和 次 数 。 


源 代 码 ”FunWithPageMembers 文 件 的 源 代码 位 于 Chapter 32 子 目录 下 。 


32.14 ASP.NET 网 页 的 生命 周期 


每 个 ASPNET 网 页 都 有 一 个 固定 的 生命 周期 。 当 ASPNET 运 行 库 收 到 一 个 给 定 *.aspx 文 件 的 传人 
请 求 时 ， 将 使 用 类 型 的 默认 构造 函数 把 相关 的 派生 自 Ssystem.Web.UI.pPage 的 类 型 分 配 到 内 存 中 。 在 这 
之 后 ， 框 架 将 自动 触发 一 系列 事件 。 默 认 情况 下 ， 会 自动 出 现 Load 事 件 ， 我 们 可 以 直接 增加 自己 的 自 
定义 代码 : 
public partial class Default : System.Web.UI.Page 
protected void Page Load(object sender, EventArgs e) 


Response.Write("Load event fired!"); 


} 
除了 Load 事 件 , 给 定 的 Page 能 截取 表 32-7 中 任何 核心 事件 , 这 些 事 件 按照 被 截取 的 次 序列 在 表 32-7 
中 ( .NET Framework 4.5 SDK 文 档 详细 介绍 了 页 面 生 命 周期 内 可 能 触发 的 所 有 事件 )。 


表 32-7 Page 类 型 的 部 分 事件 


事 件 作 用 
PreInit 框架 使 用 该 事件 来 分 配 Web 控 件 ， 应 用 主题 ， 确 立 母 版 页 ， 并 设置 用 户 个 性 化 配置 。 你 可 以 
截取 该 事件 来 定制 进程 
Init 框架 使 用 该 事件 通过 回 传 或 查看 状态 数据 把 Web 控 件 的 属性 设置 为 它们 先前 的 值 
Load 当 该 事件 触发 时 ， 页 面 与 其 控件 被 完全 初始 化 ， 并 且 它 们 先前 的 值得 以 恢复 。 此 刻 ， 与 各 个 
Web 窗 口 部 件 进行 交互 都 是 安全 的 


引发 回 传 的 事件 当然 不 存在 具有 这 个 名 字 的 事件 。 该 “事件 ”仅仅 是 指 任何 导致 浏览 器 对 Web 服 务 器 发 出 回 
传 的 事件 ( 例如 单 击 按钮 ) 


PreRender 所 有 控件 数据 绑 定 和 UI 配置 已 经 发 生 ， 并 且 控 件 已 经 准备 好 用 于 将 它们 的 数据 呈现 到 将 要 发 
出 的 HTTP 响 应 里 
Unload 页 面 与 其 控件 已 经 完成 了 呈现 过 程 ,并 且 页 面 对 象 将 被 销毁 。 此刻, 与 输出 HTTP 响 应 进行 交 


互 会 出 现 运 行 时 错误 。 然 而 你 可 以 捕捉 该 事件 来 执行 任何 页 面 层 的 清除 ( 关闭 文件 或 数据 库 
连接 ， 执 行 任何 形式 的 记录 活动 ， 处 置 对 象 ， 等 等 ) 
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如 果 需 要 处 理 除 了 Load 之 外 的 事件 ， 你 会 发 现 要 实现 这 个 是 没有 IDE 支 持 的 ! 我 们 必须 在 代码 文 
件 中 手动 编写 方法 ， 名 字 为 “Page 事件 名 ”。 例 如 ， 我 们 是 这 样 处 理 Unload 事 件 的 : 
public partial class Default : System.Web.UI.Page 
protected void Page Load(object sender, EventArgs e) 


Response.Write("Load event fired!"); 


protected void Page Unload(object sender, EventArgs e) 


// 不 能 再 向 HTTP 响 应 输出 数据 ， 因 为 我 们 会 写 入 本 地 文件 
System.10.File.WriteAllText(@"C:\MyLog.txt", "Page unloading!"); 


} 


说 明 Page 类 型 的 每 一 个 事件 都 和 System.EventHandler 委 托 一 起 使 用 。 因 此, 处 理 这 些 事件 的 子 程序 
总 是 接受 0bject 作 为 第 一 个 参数 ， 接 受 EventArgs 作 为 第 二 个 参数 。 


32.14.1 AutoEventWireUp 特 性 的 作用 
当 你 希望 为 页 面 处 理事 件 时 ， 需 要 使 用 一 个 适当 的 事件 处 理 程序 更 新 <script> 块 或 者 代码 隐藏 文 
件 。 然 而 ， 如 果 检 查 <%@Page%> 指 令 ， 就 会 注意 到 AutoEventWireUp 特 性 在 默认 情况 下 设置 为 true: 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="Default.aspx.cs" Inherits=" Default" %> 


有 了 这 个 默认 的 行为 ， 如 果 我 们 输入 正确 命名 的 方法 ， 页 面 级 别 的 事件 处 理 程序 会 被 自动 处 理 。 
然而 ， 如 果 通 过 将 这 个 特性 设置 为 false 来 禁用 AutoPageWireUp 的 话 : 


<%@ Page Language="C#" AutoEventWireup="false" 
CodeFile="Default.aspx.cs" Inherits=" Default" %> 


页 面 级 别 的 事件 不 再 会 被 捕获 。 正 如 其 名 ， 这 个 特性 ( 如 果 启 用 ) 会 在 自动 生成 的 分 部 类 ( 本 章 
前 面 提 到 过 ) 中 生成 必要 的 事件 绑 定 。 即 使 禁用 AutoEventWireUp ,我 们 仍然 可 以 通过 使 用 C# 的 事件 处 
理 逻 辑 来 处 理 页 面 级 别 的 事件 ， 例 如 : 

public Default() 

// 显 式 挂 接 Load 和 Unload 事 件 


this.Load += Page Load; 
this.Unload += Page Unload; 


在 大 多 数 情况 下 ， 我 们 只 需要 保持 AutoEventWireUp 为 可 用 状态 。 


32.14.2 Error 事件 


另 一 个 可 能 在 页 面 生命 周期 中 发 生 的 事件 是 Error。 如 果 一 个 派生 自 Page 的 类 型 上 的 方法 触发 了 
一 个 不 能 被 明确 处 理 的 异常 ， 这 个 事件 将 被 触发 。 假 设 你 已 经 为 一 个 页 面 上 给 定 Button 处 理 了 Click 
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事件 ， 并 且 在 事件 处 理 程序 (我 称 之 为 btnGetFile_ Click ) 中 ， 你 试图 向 HTTP 响 应 写 人 一 个 本 地 文 
件 的 内 容 。 

同样 假设 你 无 法 通过 标准 结构 异常 处 理 进行 该 文件 的 存在 性 测试 。 如 果 你 已 经 加 载 了 默认 构造 也 
数 中 页 面 的 Error 事 件 ， 你 还 有 最 后 一 个 机 会 在 用 户 发 现 难看 的 错误 前 处 理 问 题 。 思 考 下 面 的 代码 : 


public partial class Default : System.Web.UI.Page 
void Page Error(object sender, EventArgs e) 
Response.Clear(); 
Response.Write("I am sorTy...I can't find a required file.<br>"); 
Response.Write(string.Format("The error was: <b>{0}</b>", 


Server.GetLastError().Message)); 
Server.ClearError(); 


protected void Page Load(object sender, EventArgs e) 


Response.Write("Load event fired!"); 


protected void Page Unload(object sender, EventArgs e) 


{ 
// 不 能 再 向 HTTP 响 应 输出 数据 ， 因 为 我 们 会 写 入 本 地 文件 
System.10.File.WriteAllText(@"C:\MyLog.txt", "Page unloading!"); 


protected void btnPostback Click(object sender, EventArgs e) 

人 

protected void btnTriggerError Click(object sender, EventArgs e) 
System.10.File.ReadAllText(@"C:\IDontExist.txt"); 


} 

注意 , Error 事 件 处 理 程序 开始 清除 HTTP 响 应 中 的 任何 当前 内 容 , 并 且 发 送 一 个 普通 的 错误 消息 。 
如 果 你 希望 访问 指定 的 System.Exception 对 象 ， 可 以 使 用 由 继承 的 Server 属 性 公开 的 HttpServer- 
Utility.GetLastError() 方 法 : 

Exception e = Server.GetLastError(); 

最 后 注意 ， 在 退出 这 个 普通 的 错误 处 理 程序 之 前 ， 要 通过 Server 属 性 显 式 地 调用 HttpServer 
Utility.ClearError() 方 法 。 这 是 必需 的 ， 因 为 它 通知 运行 库 你 已 经 处 理 了 遇 到 的 问题 并 且 不 需要 再 
处 理 了 。 如 果 忘 记 了 这 么 做 ， 呈 现在 终端 用 户 面前 的 就 是 一 个 运行 时 错误 的 页 面 。 

至 此 ， 你 应 该 非常 了 解 ASPNET 的 page 类 型 的 构成 了 。 现 在 ， 你 已 经 具备 了 这 样 一 个 基础 ， 可 以 
把 注意 力 放 到 ASPNET Web 控 件 、 主 题 和 母 版 页 ( 后面 的 章节 将 介绍 它们 ) 的 作用 上 了 。 在 本 章 结 束 
前 ， 介 绍 一 下 web.config 文 件 的 作用 。 


源 代 码 ”PageLifeCycle 文 件 的 源 代码 位 于 Chapter 32 子 目录 下 。 
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32.15 ”web.config 文件 的 作用 


默认 情况 下 , 所 有 使 用 Visual Studio 创 建 的 C#ASPNETWeb 应 用 程序 都 会 自动 具有 web.config 文 件 。 
然而 ， 如 果 你 希望 为 网 站 手动 插入 web.config 文 件 的 话 〈 例 如， 如果 我 们 使 用 单 页 面 模型 并 且 还 没有 
创建 Web 解 决 方案 )， 就 可 以 使 用 Website 一 Add New Item 菜 单项 来 完成 。 不 管 怎么 样 ， 在 web.config 文 
件 中 我 们 都 可 以 增加 设置 来 控制 Web 应 用 程序 在 运行 时 的 工作 方式 。 

回忆 一 下 ,在 研究 ,NET 程序 集 的 时 候 ( 在 第 14 章 )， 我 们 知道 客户 端 应 用 程序 可 以 利用 基于 XML 
的 配置 文件 来 指导 CLR 处 理 绑 定 请 求 、 程 序 集 探查 以 及 其 他 运行 时 细节 。 对 于 ASPNET Web 应 用 程序 
来 说 也 是 一 样 ， 只 是 Web 相 关 的 配置 文件 总 是 叫 web.config ( 和 #.exe 配 置 文件 不 同 ， 它 会 根据 相关 客 
户 端 可 执行 文件 来 命名 )。 

web.config 文 件 的 整体 结构 相当 烦 珊 。 表 32-8 列 出 了 可 以 在 web.config 文 件 中 找到 的 一 些 更 有 趣 的 
子 元 素 。 


表 32-8 ”web.config 文 件 的 部 分 元 素 


元 “ 素 作 用 

<appSettings> 这 个 元 素 用 于 构建 自 定 义 名 称 / 值 对 ， 它 可 以 使 用 ConfigurationManager 类 型 以 编程 
方式 读 入 内 存 使 用 

<authentication> 这 个 安全 相关 的 元 素 用 于 定义 Web 应 用 程序 的 验证 模式 

<authorization> 这 是 另外 一 个 安全 相关 的 元 素 , 它 用 于 定义 哪些 用 户 可 以 访问 Web 服 务 器 上 的 哪些 
资源 

<connectionstrings> 这 个 元 素 用 于 保存 网 站 中 外 部 的 连接 字符 串 

<customErrors> 这 个 元 素 用 于 告诉 运行 库 如 何 显示 在 Web 应 用 程序 工作 时 候 发 生 的 异常 

<globalization> 这 个 元 素 用 于 为 Web 应 用 程序 配置 全 球 化 设置 

<namespaces> 如 果 我 们 的 应 用 程序 使 用 新 的 aspnet_compiler.exe 命 令 行 工 具 预 编译 的 话 ， 这 个 元 
素 列举 了 所 有 需要 包含 的 命名 空间 

<sessionState> 这 个 元 素 用 于 控制 会 话 状 态 数 据 如 何以 及 在 何 地 被 .NET 运 行 库 存储 

‘trace> 这 个 元 素 用 于 为 Web 应 用 程序 启用 (或 禁用 ) 跟踪 支持 


除了 表 32-8 列 出 的 其 他 子 元 素 以 外 , web.config 文 件 可 能 会 包含 其 他 子 元 素 。 表 中 大 部 分 都 是 安全 
相关 的 ， 其 余 的 项 只 是 在 创建 诸如 自 定义 HTTP 头 或 自 定义 HTTP 模 块 等 高 级 ASPNET 应 用 的 时 候 才 有 
用 (这 里 不 会 介绍 这 些 主题 )。 


ASP.NET 网 站 管理 工具 


尽管 我 们 完全 可 以 直接 使 用 Visual Studio 来 修改 web.config 文 件 的 内 容 , 但 ASPNET Web 项 目 可 以 使 
用 方便 的 编辑 器 以 图 形 方式 编辑 web.config 文 件 的 许多 元 素 和 特性 。 只 需要 激活 Website 一 ASPNET 
Configuration 菜 单项 ， 就 可 以 启用 这 个 工具 。 

单 击 页 面 顶部 的 标签 页 ， 就 可 以 发 现 这 个 工具 的 大 部 分 功能 都 是 用 于 为 我 们 的 网 站 创建 安全 设置 
的 。 不过, 这 个 工具 还 能 为 cappSettings> 元 素 增加 配置 , 定义 调试 和 跟踪 设置 以 及 创建 默认 错误 页 面 。 
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必要 时 ， 你 可 以 在 实战 中 使 用 这 个 工具 ， 然 而 ， 要 知道 这 个 工具 不 能 帮 有 我 们 向 web.config 文 件 增 
加 所 有 可 能 的 设置 。 这 个 时 候 你 可 以 选择 喜欢 的 文本 编辑 器 来 手动 更 新 这 个 文件 。 
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构建 Web 应 用 程序 需要 和 过 去 构建 传统 的 桌面 应 用 程序 不 同 的 思路 。 在 本 章 中 ， 我 们 首先 快速 轻 
松 地 学 习 了 一 些 核心 的 Web 主题 ,包括 HTML、HTTP、 客 户 端 脚本 的 作用 以 及 使 用 传统 ASP 的 服务 器 
端 脚本 。 本 章 大 部 分 内 容 都 在 介绍 ASPNET 页 面 的 架构 。 我 们 看 到 了 ， 项 目 中 每 一 个 *.aspx 文 件 都 关 
联 了 一 个 从 System.Web.UI.Page 派 生 的 类 。 使 用 这 种 面向 对 象 的 方式 ， 我 们 可 以 构建 重用 性 更 强 、 更 
面向 对 象 的 系统 。 

在 研究 了 页 面 继承 链 的 一 些 核心 功能 之 后 , 本 章 讨论 了 页 面 最 后 如 何 完整 编译 为 有 效 的 .NET 程 序 
集 。 我 们 最 后 研究 了 web.config 文 件 ， 并 且 回 顾 了 ASPNET 网 站 管理 工具 。 





ASP.NET Wet 控件 < 


母 版 页 和 主题 ， 














代 人 32 章 讨论 了 ASPNET Web 页 面 的 一 般 构成 和 Page 类 的 行为 , 而 本 章 会 深入 介绍 构成 页 面 用 户 
界面 的 Web 控 件 的 细节 。 在 研究 了 ASPNET Web 控 件 的 总 体 特性 之 后 , 我 们 会 理解 如 何 使 用 

包括 验证 控件 和 各 种 数据 绑 定 技术 在 内 的 几 个 UI 元 素 。 

本 章 大 部 分 内 容 会 研究 母 版 页 的 作用 , 并 且 演 示 它 们 如 何 提供 简单 的 形式 来 建立 会 在 网 站 多 个 页 
面 公用 的 UI 骨 架 。 与 母 版 页 密切 相关 的 话题 是 站 点 导航 控件 ( 及 相关 的 *.sitemap 文 件 )， 它 可 以 通过 
服务 器 端的 XML 文件 为 多 页 面 站 点 定义 导航 结构 。 

最 后 ， 你 将 学 习 ASP.NET 主 题 的 作用 。 从 概念 上 讲 ， 主 题 与 CSS 的 目的 相同 。 但 ASP.NET 主 题 是 
在 Web 服 务 器 端 使 用 而 不 是 客户 端 浏览 器 )， 并 因此 可 以 访问 服务 器 端 资源 。 


33.1 Web 控件 的 本 质 


可 能 ASPNET 的 主要 优点 是 使 用 定义 在 System.Web.UI.WebControls 命 名 空间 里 的 类 型 装配 页 面 UI 的 能 
力 。 你 已 经 看 到 ， 这 些 控件 ( 以 服务 器 控件 、Web 控 件 或 者 Web 窗 体 控件 命名 ) 是 非常 有 帮助 的 ， 它 们 为 
发 出 请 求 的 浏览 器 自动 生成 必需 的 HTML， 并 公开 一 套 可 在 Web 服 务 器 上 处 理 的 事件 。 而 且 ， 因 为 每 一 个 
ASPNET 控 件 在 System.Web.UI.WebControls 命 名 空间 里 都 有 一 个 相应 的 类 ， 它 能 够 以 O00 方式 操作 。 

可 见 ， 当 使 用 Visual StudioProperties 窗 口 为 Web 控 件 配置 属性 时 , 你 的 编辑 工作 会 以 一 系列 的 名 称 
/ 值 对 记录 在 *.aspx 文 件 中 一 个 给 定 元 素 的 公开 控件 标记 中 。 因 此 ， 如 果 为 给 定 *.aspx 文 件 的 设计 器 添 
加 一 个 新 的 TextBox ， 并 且 改 变 ID 、Borderstyle 、BorderWidth 、BackColor 和 Text 属 性 ， 公 开 的 
<asp:TextBox> 标 签 就 会 被 修改 成 这 样 ( 注意 Text 值 成 了 TextBox 的 内 部 文本 ): 


<asp:TextBox ID="txtNameTextBox" runat="server" BackColor="#COFFCO" 
BorderStyle="Dotted" BorderWidth="3px">Enter Your Name</asp:TextBox> 


由 于 Web 控 件 的 声明 最 后 变 成 来 自 System.Web.UI.WebControls 命 名 空间 的 成 员 变 量 ( 通过 动态 编 

译 周期 , 第 32 章 介绍 过 ), 你 就 能 与 在 服务 器 端 <script> 块 内 这 个 类 型 的 成 员 或 通过 更 常用 的 页 面 代码 

了 天 文件 进 和 安 五 。 例 如 ， 如 果 向 *.aspx 文 件 添 加 一 个 新 的 Button 按 钮 ， 就 可 以 处 理 Click 事 件 ， 并 且 
可 以 编写 服务 器 端 处 理 程序 改变 TextBox 的 背景 颜色 ， 如 下 所 示 : 


partial class Default : System.Web.UI.Page 


protected void btnChangeTextBoxColor Click(object sender, EventArgs e) 
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// 改变 文本 框 对 象 的 颜色 
this .txtNameTextBox.BackColor = System.Drawing.Color.DarkBlue; 
} 

所 有 的 ASPNET Web 控 件 最 终 派生 自 一 个 公共 的 名 为 System.Web.UI.WebControls.WebControl 的 基 类 。 
WebControl 派 生 自 System.Web.UI.Control ( 它 又 继承 自 System.0bject )。Control 和 WebControl 都 定义 
了 大 量 的 所 有 服务 器 端 控件 公共 的 属性 。 在 学 习 继承 功能 之 前 ， 正 式 说 明 一 下 处 理 服务 器 端 事件 意味 
着 什么 。 


33.1.1 服务 器 端 事件 处 理 


考虑 到 当前 的 万 维 网 状态 , 我 们 不 可 能 避免 浏览 器 /Web 服 务 器 的 交互 。 无 论 何 时 这 两 个 实体 进行 
通信 ， 总 是 有 一 个 底层 的 、 无 状态 的 HTTP 请 求 - 响 应 循环 。 尽 管 ASP.NET 服 务 器 控件 做 了 大 量 工作 以 
避免 用 户 处 理 原始 HTTP 协 议 的 细节 ， 但 一 定 要 牢记 一 点 ， 把 Web 当 做 事件 驱动 的 实体 来 看 待 仅仅 
是 .NET 平 台 提供 的 一 个 华丽 的 表象 , 而 且 它 与 基于 Windows 的 桌面 GUI 框架 ( 如 WPF ) 并 不 完全 一 样 。 

因此 ， 虽 然 WPF 的 System.Windows.Controls 和 ASPNET 的 System.Web.UI.WebControls 命 名 空间 都 使 用 同 
样 简单 的 名 字 ( Button、TextBox、Label 等 ) 定义 了 类 ， 但 它们 提供 的 属性 、 方 法 和 事件 集 不 同 。 例 
如 ， 当 用 户 在 一 个 Web 窗 体 的 Button 控 件 上 移动 光标 时 ， 绝 不 可 能 处 理 一 个 服务 器 端 MouseMove 事 件 。 

底线 是 给 定 的 ASPNET Web 控 件 将 公开 一 个 有 限 的 事件 集 ， 所 有 这 些 事件 最 终 都 将 产生 到 Web 服 
务 器 的 回 传 。 任 何必 需 的 客户 端 事件 处 理 都 需要 你 对 客户 端 JavaScripVVBScript 脚 本 代码 有 所 了 解 , 这 
些 代码 将 由 发 出 请 求 的 浏览 器 的 脚本 引擎 处 理 。 因 为 ASPNET 主 要 是 服务 器 技术 ， 所 以 在 本 书 中 我 们 
不 讨论 编写 客户 端 脚本 方面 的 内 容 。 


说 明 使 用 Visual Studio 为 某 个 Web 控 件 处 理事 件 和 为 Windows GUI 控件 处 理 时 做 法 相似 。 只 需要 从 
设计 器 选择 控件 并 且 在 Properties 窗 口中 单 击 “闪电 ”图 标 。 


33.1.2 ”AutoPostBack 属 性 


同样 值得 指出 的 是 ，ASP.NET 的 许多 Web 控 件 都 支持 名 为 AutoPostBack 的 属性 ( 最 主要 的 是 
CheckBox 、RadioButton 和 TextBox 控 件 ， 还 有 派生 自 抽象 的 Listcontrol 类 型 的 部 件 )。 默 认 情 况 下 ， 这 
个 属性 设置 为 false， 它 使 服务 器 端的 事件 不 能 自动 记录 ( 即使 你 确实 已 经 在 代码 隐藏 文件 中 装载 了 
事件 )。 在 许多 情况 下 ， 这 正 是 你 需要 的 行为 ， 因 为 诸如 复 选 框 的 UI 元 素 通常 不 需要 回 发 功能 。 也 就 是 
说 ， 你 并 不 需要 在 用 户 选 中 或 取消 选中 复 选 框 后 立即 向 服务 器 回 发 ， 因 为 页 面 对 象 可 以 在 Button 的 
click 事件 处 理 程序 中 获取 部 件 的 状态 。 

然而 ， 如 果 你 布 望 这 些 部 件 中 的 任何 一 个 回 传 到 服务 器 端 事件 处 理 程序 ， 只 需 设置 AutoPostBack 
的 值 为 true。 如 果 你 希望 一 个 部 件 的 状态 自动 填充 同一 页 面 上 另 一 个 部 件 的 值 ， 这 个 技术 可 能 是 有 帮 
助 的 。 例 如 ， 创 建 一 个 包含 TextBox ( 名 为 txtAutoPostback ) 和 ListBox 控 件 ( 名 为 1stTextBoxData ) 
的 网 页 。 下 面 是 相关 标记 : 
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<form id="form1" runat="server"> 
<asp:TextBox ID="txtAutopostback" runat="server"></asp:TextBox> 
<br/> 
<asp:ListBox ID="lstTextBoxData" runat="server"></asp:ListBox> 
</form> 


现在 ， 处 理 TextBox 的 TextChanged 事 件 ， 并 在 服务 器 端 事件 处 理 程序 中 使 用 TextBox 中 的 当前 值 填 
充 ListBox， 如 下 所 示 : 
partial class Default : System.Web.UI.Page 


protected void txtAutopostback_TextChanged(object sender, EventArgs e) 
lstTextBoxData.Items.Add(txtAutoPpostback. Text); 


} 

如 果 运 行 这 个 应 用 程序 ， 你 将 发 现 ， 同 在 TextBox 中 输入 的 一 样 ， 什么 都 没有 发 生 。 此 外 ， 如 果 你 
在 TextBox 中 输入 并 转 到 下 一 个 控件 , 同样 什么 都 不 会 发 生 。 原 因 是 TextBox 的 AutoPostBack 属 性 默认 设 
置 为 了 false。 然 而 ， 如 果 设 置 这 个 属性 为 true， 如 下 所 示 : 


<asp:TextBox ID="txtAutoPostback"runat="server" 
AutopostBack="true"” ... > 
</asp:TextBox> 


你 将 发 现 ， 当 离开 TextBox ( 或 按 Enter 键 ) 时 ，ListBox 会 被 TextBox 中 的 当前 值 自动 填充 。 要 记 住 ， 
除了 从 一 个 部 件 获 取 值 填充 到 另 一 个 部 件 中 ， 通 常 不 需要 改变 部 件 的 AutoPostBack 属 性 的 状态 (有 时 
可 完全 用 客户 端 脚本 完成 ， 而 不 需要 与 服务 器 交互 )。 


33.2 ”Control 和 WebControl 基 类 


System.Web.UI.Control 基 类 定义 了 各 种 属性 、 方 法 和 人 允许 与 Web 控 件 的 核心 (通常 是 非 GUI 的 ) 
方面 进行 交互 的 事件 。 表 33-1 列 出 了 一 些 成 员 ， 但 不 是 全 部 。 


表 33-1 System.Web.UI.Control 的 部 分 成 员 





成 员 作 用 
Controls 该 属性 获取 一 个 ControlCollection 对 象 ， 该 对 象 表 示 当 前 控件 内 的 各 个 子 控件 
DataBind() 该 方法 将 一 个 数据 源 绑 定 到 被 调用 的 服务 器 控件 及 其 所 有 子 控件 


EnableTheming 。 ”该 属性 确定 控件 是 否 支持 主题 功能 ( 默认 为 true ) 
HasControls() ”该 方法 确定 服务 器 控件 是 否 含有 任何 子 控件 


ID 该 属性 获取 或 者 设置 分 配给 服务 器 控件 的 程序 标识 符 

Page 该 属性 获取 对 含有 服务 器 控件 的 Page 实 例 的 引用 

Parent 该 属性 获取 对 网 页 控件 层次 中 服务 器 控件 的 父 控件 的 引用 

SkinID 该 属性 获取 或 者 设置 “皮肤 ”以 应 用 于 控件 。 它 通过 服务 器 端 资源 迅速 建立 一 个 控件 的 总 体 
外 观 


Visible 该 属性 获取 或 者 设置 一 个 值 ， 指 明 服务 器 控件 是 否 以 UI 元 素 的 形式 呈现 在 网 页 上 
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33.2.1 枚 举 所 包含 的 控件 


我 们 将 要 考查 的 System.Web.UI.Control 的 第 一 个 方面 是 ， 所 有 Web 控 件 (包括 Page 自 身 ) 继承 一 
个 自 定义 控件 集合 (通过 Controls 属 性 访问 ), 与 在 一 个 WindowsForms 应 用 程序 中 非常 类 似 , Controls 
属性 提供 了 访问 WebControl 派 生 类 型 的 强 类 型 集合 的 方法 。 同 所 有 .NET 集 合 一 样 ， 你 可 以 在 运行 时 动 
态 添加 、 插 入 和 删除 项 。 

尽管 直接 将 Web 控 件 添加 到 一 个 派生 自 Page 的 类 型 在 技术 上 是 可 行 的 , 但 使 用 Panel 控 件 要 容易 得 
多 ( 更 健壮 ),Panel 类 描述 了 一 个 部 件 的 容器 , 它 对 于 终端 用 户 可 以 可 见 , 也 可 以 不 可 见 ( 取决 于 Visible 
和 Borderstype 属 性 的 值 )。 

为 举例 说 明 ， 创建 一 个 新 的 名 为 DynamicCtrls 的 站 点 并 向 该 项 目 中 添加 一 个 新 Web Form。 使 用 
Visual Studio 页 面 设 计 器 ， 添 加 一 个 Panel 控 件 ( 名 为 myPanel )， 它 包含 TextBox 、Button 和 HyperLink 部 
件 , 名 字 随 你 选择 ( 注意 , 设计 器 需要 你 在 Panel 类 型 的 UI 中 拖 动 内 部 项 ), 接着 将 Label 部 件 放 在 Panel 
( 名 为 lblControlInfo ) 的 作用 域 之 外 以 保存 呈现 的 输出 。 下 面 是 可 能 的 HTML 描 述 : 


<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head runat="server"> 
<title>Dynamic Control Test</title> 
</head> 
<body> 
<form id="form1i" runat="server"> 
<div> 
<hr /> 
<h1>Dynamic Controls</h1> 
<asp:Label ID="lblTextBoxText" runat="server"></asp:Label> 
<hr /> 
</div> 


<1--Panel 有 3 个 包含 控件 --> 
<asp:Panel ID="myPanel”" runat="server" Width="200px" 
BorderColor="Black" BorderStyle="Solid" > 
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox><br/> 
<asp:Button ID="Button1" runat="server" Text="Button"/><br/> 
<asp:HyperLink ID="HyperLink1" runat="server">HyperLink 
</asp:HyperLink> 
</asp:Panel> 
<br /> 
<br /> 
<asp:Label ID="lblControlInfo" runat="server"></asp:Label> 
</form> 
</body> 
</html> 


使 用 这 个 标记 ， 页 面 设计 器 看 起 来 如 图 33-1 所 示 。 
假设 在 Page_Load() 事 件 中 ， 你 希望 获取 一 个 包括 在 Panel 内 的 所 有 控件 的 列表 ， 并 且 把 结果 赋值 
给 Label 控 件 ( 名 为 lblControlInfo )。 考 虑 下 面 的 C# 人 代码: 


public partial class Default : System.Web.UI.Page 
{ 





private void ListControlsInPanel() 


string theInfo = ""; 
theInfo = string.Format("<b>Does the panel have controls? {0} </b><br/>"， 
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myPanel.HasControls()); 


// 获取 面板 中 的 所 有 控件 


foreach (Control c in myPanel.Controls) 


if (lobject.ReferenceEquals(c.GetType(), 
typeof(System.Web.UI.LiteralControl))) 


theInfO 十 = "六 米 米 六 六 六 冰冰 六 六 六 六 六 六 六 六 六 冰冰 六 闵 冰 站 冰冰 < 了 /> ; 


theInfo += string.Format("Control Name? {0} ¢br/>", c.ToString()); 
theInfo += string.Format("ID? {0} <br>", c.ID); 
theInfo += string.Format("Control Visible? {0} ¢br/>", c.Visible); 
theInfo += string.Format("ViewState? {0} <br/>", c.EnableViewState); 
} 
} 
lblControlInfo.Text = theInfo; 
} 
protected void Page Load(object sender, System.EventArgs e) 
{ 
ListControlsInPanel(); 
} 
} 


Defauit.aspx 二 X 


Dynamic Controls 
fiblTextBoxText] 


ET Ps ER 








<asp'TextBoxsTextBox} > 





图 33-1 Dynamic Controls 网 页 的 UI 


这 里 迭代 了 Panel 上 的 每 个 WebControl 并 且 检 查 了 当前 的 类 型 是 否 是 System.Web.UI.Literal 
Control1。 这 个 类 型 用 于 描述 字面 量 HTML 标 签 和 内 容 ( 例如 <br>、 文 本 字面 量 等 )。 如 果 不 做 这 个 全 
面 检查 ， 你 可 能 会 对 在 Panel ( 假设 *.aspx 声 明 预 先 可 见 ) 的 作用 域内 发 现 更 多 类 型 感到 惊讶 。 假 设 这 
个 类 型 不 是 字面 量 HTML 内 容 ， 需 要 用 户 打印 出 关于 部 件 的 各 类 统计 。 图 33-2 显 示 了 输出 结果 。 
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Search: » 
用 Bookmarks Toolbar 
‘4; Bookmarks Menu 
| Recently Bookmarked 
$ 8) Recent Tags 





My Stuff 
和 ; Unsorted Bookmarks 





Does the panel have controls? True 

兴 刘 束 褒 难 儿 这 家 束 藉 床 兴 来 章 实 训 光束 宁 农家 长 家 兴 

Control Name? System Web.UI WebControls. TextBox 
ID? TextBoxl 

Control Visible? True 

ViewState? True 

闻 交 次 本 本 才 放 亲 泰 玫 家 密 市 闪 守 闪 家 家 束 永 兴 认 农家 相 还 

Control Name? System Web UI WebControls.Button 
ID? Button1 

Control Visible? True 

ViewState? True 

壮 奢 联 芝 章帝 闪闪 六 洲 兴 沸 兴 闪 容 于 入 短 间 认 春 大 办 生 基 兴 订 

Control Name? System. Web.UI. WebControls. HyperLink 
ID? HyperLinkl 

Control Visible? True 

ViewState? True 








图 33-2 ”在 运行 时 枚 举 控 件 


33.2.2 ”动态 添加 和 删除 控件 


现在 假如 希望 在 运行 时 改变 Panel 的 内 容 ， 该 怎么 处 理 呢 ? 更 新 当前 的 页 面 以 支持 另外 一 个 Button 
( 名 为 btnAddWidgets )， 这 个 按钮 动态 地 向 Panel 上 添加 3 个 新 的 TextBox 类 型 ， 另 一 个 Button ( 名 为 
btnClearPanel ) 清除 所 有 控件 的 Panel 部 件 。 每 个 部 件 的 Click 事 件 处 理 程序 如 下 所 示 : 


protected void btnClearPanel Click(object sender, System.EventArgs e) 


{ 
// 清除 面板 中 的 所 有 内 容 ， 然 后 重新 列 出 所 有 项 
myPanel .Controls.Clear(); 
ListControlsInPanel(); 


protected void btnAddwidgets_Click(object sender, System.EventArgs e) 
for (int i = 0; i < 3; i++) 


// 分 配 一 个 名 字 ， 这 样 随后 我 们 就 能 够 使 用 传 入 的 表单 数据 获得 文本 值 
TextBox t = new TextBox(); 

t.ID = string.Format("newTextBox{0}", i); 
myPanel.Controls.Add(t); 

ListControlsInPanel(); 
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注意 ， 为 每 个 TextBox ( 例如，newTextBox0、newTextBox1 等 ) 分 配 个 唯 的 ID。 如 果 运 行 方面 ， 
应 该 能 向 Panel 控 件 添加 新 项 并 且 清 除 所 有 内 容 的 Panel。 


33.2.3 与 动态 创建 的 控件 交互 


现在 , 如 果 想 获取 这 些 动态 生成 的 TextBox 中 的 值 , 可 以 用 多 种 方法 来 实现 。 首先 , 用 另外 的 Button 
( 名 为 btnGetTextData ) 和 最 后 的 Label 控 件 ( 名 为 LblTextBoxData ) 更 新 U1， 并 且 处 理 Button 的 Click 
事件 。 

为 了 访问 动态 生成 的 文本 框 中 的 数据 ， 可 以 有 几 种 方法 。 一 种 方法 是 循环 遍历 包含 在 传人 HTML 
表单 数据 内 的 每 一 项 ( 通过 HttpRequest.Form 访 问 ), 并 且 拼 接 文本 信息 到 一 个 本 地 作用 域 system. string。 
遍历 整个 集合 之 后 ， 立 即将 这 个 字符 串 分 配 到 新 Label 控 件 的 Text 属 性 ， 如 下 所 示 : 

protected void btnGetTextData Click(object sender, System.EventArgs e) 


string textBoxValues = ""; 
for (int i = 0; i «< Request.Form.Count; i++) 


textBoxValues += string.Format("<li>{0}¢</li><br/>", Request.Form[i]); 


} 
lblTextBoxData.Text = textBoxValues; 


当 运 行 这 个 应 用 程序 时 ， 你 将 发 现 你 能 查看 每 一 个 文本 框 的 内 容 ， 包 括 一 个 相当 长 的 ( 难 读 的 ) 
字符 串 。 这 个 字符 串 包括 页 面 上 每 个 窗口 部 件 的 视图 状态 。 在 第 34 章 中 我 们 将 学 习 视 图 状态 的 作用 。 

为 了 使 输出 结果 变 得 整洁 ， 可 以 提取 各 个 命名 项 ( newTextBox0、newTextBox1 和 newTextBox2 ) 
的 文本 数据 。 考 虑 如 下 的 更 新 : 


protected void btnGetTextData Click(object sender, System.EventArgs e) 


// 通过 名 称 获取 各 文本 框 

string lableData = string.Format("<li>{0}</li><br/>", 
Request.Form.Get("newTextBox0")); 

lableData += string.Format("<li>{0}</1i><br/>", 
Request.Form.Get("newTextBox1")); 

lableData += string.Format("<li>{0}</1i><br/>", 
Request.Form.Get("newTextBox2")); 

lblTextBoxData.Text = lableData; 


此 外 ,注意 , 一 旦 执行 了 请 求 ， 文 本 框 就 要 消失 ,这 是 由 于 HTTP 无 状态 的 特征 。 如 果 你 希望 动 
态 地 保持 这 些 被 创建 于 回 传 期 间 的 TextBox， 就 需要 使 用 ASP.NET 的 状态 编程 技术 ( 也 将 在 第 34 章 中 


介绍 ) 


o 








源 代码 ”DynamicCtrls 网 站 的 源 代码 位 于 Chapter 33 子 目录 下 。 





33.2.4 ”WebControl 基 类 的 功能 
如 你 所 知 ，Control 类 型 提供 了 大 量 与 非 GUI 相 关 的 行为 ( 如 控件 集合 、 自 动 回 传 支 持 等 )。 另 一 
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方面 ，WebControl 基 类 提供 了 一 个 到 所 有 Web 部 件 的 图 形 多 态 接口 ， 如 表 33-2 所 示 。 
表 33-2 ” ”WebControl 基 类 的 部 分 属性 


属 性 作 用 
BackColor 获取 或 者 设置 Web 控 件 的 背景 颜色 
BorderColor 获取 或 者 设置 Web 控 件 的 边框 颜色 
BorderStyle 获取 或 者 设置 Web 控 件 的 边框 样式 
BorderWidth 获取 或 者 设置 Web 控 件 的 边框 宽度 
Enabled 获取 或 者 设置 用 来 指示 Web 控 件 是 否 启用 的 值 
CssClass 允许 把 一 个 类 分 配给 一 个 Web 部 件 ， 这 个 类 是 在 CSS 内 定义 的 
Font 获取 Web 控 件 的 字体 信息 
ForeColor 获取 或 者 设置 Web 控 件 的 前 景色 (通常 情况 下 为 文本 的 颜色 ) 
Height 和 Width 获取 或 者 设置 Web 控 件 的 高 度 和 宽度 
TabIndex 获取 或 者 设置 Web 控 件 的 选项 卡 索 引 
ToolTip 获取 或 者 设置 当 光 标 位 于 Web 控 件 之 上 时 ， 用 以 显示 说 明 该 Web 控 件 的 工具 提示 





我 认为 ， 这 些 属性 中 的 大 部 分 是 无 需 解释 的 ， 所 以 不 要 钻研 所 有 这 些 属 性 的 使 用 。 做 一 下 调整 : 
在 实际 应 用 中 学 习 大 量 的 ASPNET Web 窗 体 控件 。 
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ASP.NET Web 控 件 库 可 以 细 分 为 几 大 类 , 可 以 在 Visual Studio Toolbox 中 查看 这 几 大 类 ( 需要 打开 
*.aspx 页 面 的 设计 视图 ) ， 如 图 33-3 所 示 。 


<: TOOLBOX =: 
Search Toolbox 
Standard 

> Data 

bP Validation 

b Navigation 

bP Reporting 

b Login 

b WebParts 

b AIAX Extensions 
b Dynamic Data 
b HTML 

4 General 


There are no usable controls in this 
group. Drag an item onto this te to 
add it to the tooibox. 


图 33-3 ”ASP.NET Web 控 件 的 种 类 
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在 Toolbox 的 Standard 节 点 下 ， 包 含 最 常用 的 控件 ， 如 Button 、Label 、TextBox 和 ListBox。 除 了 这 
些 简 单 的 UI 元 素 ，Standard 节 点 还 列 出 了 更 加 复杂 的 Web 控 件 ， 如 Calendar 、Nizard 和 AdRotator ( 如 
图 33-4 所 示 ) 。 





[= TOOLBOX := 
Search Toolbox 
| 4 Standard 
| Pointer 
AdRotator | 
BulletedList | Es 
Button | 
Calendar 
CheckBox 
CheckBoxtist 
DropDowntist 
FileUpioad 
HiddenField 
HyperLink 
Image 






ImageButton 
jmageMap 
Label 





Ii>O> S00iaeris” 


图 33-4 ”标准 的 ASP.NET Web 控 件 


Data 节 点 下 为 一 组 用 于 数据 绑 定 操作 的 控件 ， 包 括 最 新 的 ASP.NET Chart 控 件 ， 它 将 图 形 图 表 数 
据 ( 饼 图 、 折 线 图 ) 作为 数据 绑 定 操作 的 结果 进行 呈现 (如 图 33-5 所 示 ) 。 











Search Toctipex 


b Standard 
4Bata 






KR Pointer 
Chart 
全 Datalist 
BDatapager | 
的 DetailsView 1 
+ 网 EntityDataSource 
名 FormView 
GridView 
人 LingDataSource 
3 ListView 
* 风 ObjectDataSource 
池 ”QueryExdtender 
MH Repeater 
SiteMapDataSource 
SqiDataSource 
‘; XmiDataSource 
Lb Validation, i 


图 33-5 ”数据 相关 的 ASP.NET Web 控 件 
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位 于 Validation 节 点 下 的 ASP.NET 验 证 控件 可 以 配置 客户 端 JavaScript 块 ， 以 验证 输入 字段 中 的 数 
据 是 否 有 效 。 如 果 发 生 验 证 错误 ， 用 户 将 看 到 错误 消息 ,并且 在 错误 更 正之 前 不 会 对 Web 服 务 器 进行 
回 发 。 

Toolbox 的 Navigation 节 点 下 是 少量 与 *.sitemap 文 件 协同 工作 的 控件 ( Menu 、SiteMapPath 和 
TreeView )。 本 章 前 面 简要 介绍 过 ， 这 些 导 航 控件 允许 使 用 XML 来 描述 多 页 面 站 点 的 结构 。 

最 神奇 的 ASP.NET Web 控 件 位 于 Login 节 点 下 ( 如 图 33-6 所 示 ) 。 


Ci TOOLBOX tt rt 

Search Toolbox 

b Standard 

b Data 

b> Validation 

> Navigation 

b Reporting 

4 Login 

RPointer 

Changepassword 
CreateUserWizard 


Login 


LoginStatus 


LoginView 


如 
过 
盐 
罚 ”toginName 
Ee 
加 
加 


PasswordRecovery 
b WebParts 





图 33-6 ”完全 相关 的 ASP.NET Web 控 件 


这 些 控件 从 根本 上 简化 了 如 何 将 基本 的 安全 特性 ( 密码 恢复 、 登 录 界 面 等 ) 添加 到 Web 应 用 程序 
中 。 这 些 控件 实际 上 非常 强大 ， 如 果 你 还 没有 指定 安全 数据 库 ， 它 们 甚至 可 以 动态 创建 一 个 专用 的 数 
据 库 来 存储 赁 证 〈 保存 在 网 站 的 App_Data 文 件 夹 下 ) 。 


说 明 Visual Studio Toolbox 中 其 他 类 别 的 Web 控 件 ( 如 WebParts、AJAX Extensions 和 Dynamic Data ) 
可 以 满足 更 特殊 的 编程 需要 ， 这 里 不 作 介绍 。 


33.3.1 关于 System.Web.UI.HtmlControls 的 简短 说 阴 


实际 上 ，ASPNET 中 有 两 个 明显 不 同 的 Web 控 件 工 具 包 。 除 了 ASPNET Web 控 件 (在 System.Web. 
UI.WebControls 命 名 空间 中 ) 外 ， 基 础 类 库 也 提供 System.Web.UI.HtmlControls 控 件 库 。 

HTML 控 件 是 一 个 类 型 的 集合 ， 它 允许 在 Web Form 页 面 上 使 用 传统 的 HTML 控 件 。 然 而 ， 与 原始 
的 HTML 标 签 不 同 ,， HTML 控 件 是 OO 实体 ,能够 被 配置 并 在 服务 器 上 运行 ， 因而 支持 服务 器 端 事件 处 
理 , 与 ASP.NET Web 控 件 不 同 ,HTML 控 件 实际 上 是 相当 简单 的 ,并 且 除 了 标准 HTML 标 签 ( HtmlButton、 
HtmlInputControl、HtmlTable 等 ) 之 外 几乎 没什么 功能 。 
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如 果 我 们 的 团队 对 于 构建 HTML UI 和 .NET 开 发 分 工 明确 的 话 ，HTML 控 件 就 很 有 用 。HTML 的 构 
建 者 可 以 通过 他 们 熟悉 的 标记 标签 来 使 用 他 们 的 Web 编 辑 器 并 且 把 HTML 文 件 传 给 开发 组 。 然 后 ， 开 
发 人 员 就 可 以 配置 这 些 HTML 控 件 来 作为 服务 器 控件 运行 ( 通过 在 Visual Studio 中 右 击 HTML 组 件 )。 
这 就 允许 开发 人 员 来 处 理 服务 器 端 事件 以 及 以 编程 方式 使 用 HTML 控 件 。 

HTML 控 件 提 供 了 一 个 模仿 标准 HTML 特 性 的 公共 接口 。 例 如 ， 为 了 获得 输入 区 域 的 信息 ， 你 利 
用 Value 属性 ， 而 不 是 以 Web 控 件 为 中 心 的 Text 属 性 。 由 于 HTML 控 件 不 像 ASPNET Web 控 件 那样 功能 
丰富 ， 后 文中 将 不 会 进一步 介绍 。 


33.3.2 ”Web 控件 的 文档 


在 本 书 剩 余部 分 中 ， 你 将 有 机 会 使 用 多 个 ASPNET Web 控 件 。 但 你 应 该 花 点 时 间 在 .NET 
Framework 4.5 SDK 文 档 中 搜索 System.Web.UI.WebControls 命 名 空间 。 你 可 以 找到 该 命名 空间 下 各 个 
成 员 的 说 明和 代码 示例 ( 如 图 33-7 所 示 )。 


System,Web,ULYWebControls.,, Xx WM Manage Content 


~ 
Class Description 次 
We AccessDataSource Represents a Microsoft Access database for use with data-bound 计 
ontrols. 
Se AccessDataSourceView Supports the AccessDataSource control and provides an interface for 


data-bound controls to perform data retrieval Using Structured Query 
Language (SQL against a Microsoft Access database. 


AdC reatedEy entargs Prevides data for the AdiCreatad event of the AdRotator control. his 
3 y 
cass cannot be inherited. 


We AdRotator Displays an advertisement banner on a Web page, 


Re AssocatedControlConverter Provides a type converter that retrieves a list of WebConirol controls 
in the current container, 


a AuthenticatefyentArgs Provides data for the Authenticate event. 


We | AutorfieldsGererator Represents 3 base ciass for classes that automaticafly generate fields 
for data-bound tontrols that use ASP,NET Dynamic Data features, 


We AuUtoQeneratedtield Represents an automatically generated field in a data-bound controt. 
This class cannot be inherited. 


Re AutoGeneratedFieldProperties Represents the properties of an AutcGeneratedField object, This dass 
cannct be inherited, 


图 33-7 .NET Framework 4.5 SDK 文 档 中 列 出 了 所 有 ASP.NET Web 控 件 
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由 于 很 多 “简单 ”控件 的 外 观 和 它们 的 Windows GUI 版 本 很 一 致 ， 所 以 我 不 会 再 花 时 间 来 枚 举 基 
本 组 件 的 细节 ( Button、Label、TextBox 等 )， 而 是 构建 一 个 新 网 站 来 演示 使 用 几 个 更 有 趣 的 控件 、 
ASPNET 母 版 页 模型 和 数据 绑 定 引擎 。 具 体 而 言 ， 下 一 个 示例 会 说 明 如 下 技术 

口 使 用 母 版 页 工作 ; 

口 使 用 站 点 地 图 导航 ; 


33.4 构建 ASPNET 汽 车 网 站 1133 


口 使 用 Gridview 控 件 工作 ; 

口 使 用 Wizard 控 件 工作 。 

首先 , 创建 一 个 名 为 AspNetCarsSite 的 Empty Web Site 项 目 。 注意 ,我 们 没有 创建 新 的 ASP.NET 
Web Site 项 目 ， 因 为 这 会 添加 很 多 我 们 还 没 介绍 的 启动 文件 。 在 本 项 目 中 ， 我们 将 手动 添加 所 需要 


的 东西 。 


33.4.1 使 用 ASP.NET 母 版 页 工作 


许多 网 站 的 多 个 页 面 都 有 一 致 的 外 观 (一 个 公共 菜单 导航 系统 、 通 用 的 标题 和 页 脚 内 容 、 公 司 标 
志 等 )。 母 版 页 不 只 是 使 用 *.master 文 件 扩展 的 ASPNET 页 面 。 母 版 页 对 于 客户 端 浏 览 器 不 是 可 见 的 ( 事 
实 上 ，ASPNET 运 行 时 将 不 服务 于 这 类 Web 内 容 )。 母 版 页 在 站 点 内 定义 一 个 通用 的 、 共 享 于 所 有 页 面 
的 UI 布 局 〈 或 者 页 面 的 子 集 )。 

同样 ，*.master 页 面 会 定义 各 种 内 容 占 位 符 区 域 来 创建 一 块 能 让 其 他 *.aspx 文 件 插入 的 区 域 。 我 们 
会 看 到 ,将 内 容 插 入 到 母 版 页 面 的 *.aspx 文 件 的 外 观 和 我 们 现在 研究 的 *.aspx 文 件 不 同 。 准 确 地 说 ,这 
种 形式 的 *.aspx 文 件 叫 做 内 容 页 面 。 内 容 页 面 是 没有 定义 HTML <form> 元 素 的 *.aspx 文 件 ( 这 是 母 版 页 
面 的 事情 )。 

然而 ， 就 最 终 用 户 而 言 ， 请 求 指 向 给 定 的 *.aspx 文 件 。 在 Web 服 务 器 端 ， 相 关 的 *.master 文 件 和 相 
关 的 *.aspx 内 容 页 面 会 合并 为 一 个 统一 的 HTML 页 面 声明 。 

为 了 演示 母 版 页 面 和 内 容 页 面 的 使 用 , 首先 通过 Website 一 Add New Item 菜 单项 将 一 个 新 的 母 版 页 
面 插入 到 我 们 的 网 站 (图 33-8 显 示 了 结果 对 话 框 )。 





es 2 ME 
Sotbyr [Defeutt 0] 党 Search totailled Templates 
Web Page {Razor v2) Visual C# Type: Visual C# 
A Master Page tor Web Applications 


Viswal:G 
| Master Page | 
门 Web User Control * 2 


:ADONETEntityData Model VisualC# 


Ei: ADONET EntityObject GeneratorVisual Cs 


Ei: ADO.NET EntityObject Generat... Yisual C# 


;ADONET Self-Tracking Entity.. Visual C# 


电 4 in 
I Place codein separate file 


图 33-8 ”插入 新 的 *.master 文 件 


MasterPage.master 文 件 的 最 初 标记 差不多 如 下 : 


<%@ Master Language="C#" AutoEventWireup="true" 
CodeFile="Masterpage.master.cs" Inherits="MasterPage" %> 


<!DOCTYPE html> 
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<html xmlns="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<title> </title> 
<asp:ContentPlaceHolder id="head" runat="server"> 
</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="form1i" runat="server"> 
<div> 
<asp:ContentPlaceHolder id="ContentPlaceHolder1" runat="server"> 
</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
</html> 


需要 关注 的 第 一 点 是 新 的 <%@Master%> 指 令 。 通 常 ， 这 个 指令 和 第 32 章 讲述 的 <%@Page%> 支 持 同样 
的 特性 。 同 Page 类 型 相似 ， 母 版 页 继承 自 一 个 特定 的 基 类 ， 在 这 个 例子 中 是 MasterPage。 如 果 要 打开 
相关 的 代码 文件 ， 将 会 看 到 下 面 的 类 定义 : 

public partial class MasterPage : System.Web.UI.MasterPage 


protected void Page Load(object sender, EventArgs e) 


} 
} 

男 一 个 关注 点 是 casp:ContentPlaceHolder> 类 型 。 这 个 母 版 页 的 区 域 描绘 了 相关 *.aspx 文 件 的 UI 和 窗 
口 控件 ， 而 不 是 母 版 页 自己 的 内 容 。 

如 果 你 确实 想 要 将 一 个 *.aspx 文 件 插入 到 这 个 区 域 中 ，<asp:ContentPlaceHolder> 和 </asp:Content- 
PlaceHolder> 标 签 内 的 作用 域 将 被 清空 。 然 而 ， 如 果 你 这 样 选择 了 ， 就 能 用 各 种 Web 控 件 填 充 这 个 区 域 ， 
这 些 Web 控 件 作 为 默认 的 UI 使 得 在 站 点 中 的 给 定 *.aspx 文 件 不 支持 特定 内 容 。 在 本 例 中 , 假设 每 一 个 在 站 
点 中 的 *.aspx 页 面 都 支持 自 定义 内 容 ， 那 么 casp:ContentPlaceHolder> 元 素 将 会 为 空 。 








说 明 *.master 页 面 可 以 根据 需要 定义 任意 多 的 内 容 占 位 符 。 同 时 , 单独 的 #.master 页 面 可 以 说 入 更 多 
的 *.master 页 面 。 





你 能 使 用 创建 *.aspx 文 件 时 所 用 的 Visual Studio 设 计 器 创建 *.master 文 件 的 公共 UI。 为 你 的 站 点 添加 
一 个 描述 性 的 Label ( 作为 一 个 通用 欢迎 消息 )、 一 个 AdRotator 控 件 〈 它 将 随机 显示 两 个 图 片 文件 中 的 
一 个 ) 和 一 个 TreeView 控 件 ( 允许 用 户 导 航 到 站 点 的 其 他 区 域 )。 下 面 是 用 IDE 设 计 完 母 版 页 后 的 标记 : 


<html xmlns="http://www.w3 .org/1999/xhtm1"> 
<head runat="server"> 
<title> </title> 
<asp:ContentPlaceHolder id="head" runat="server"> 
</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<hr /> 
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<asp:Label ID="Label1" runat="server”Font-Size="XX-Large” 
Text="Welcome to the ASP.NET Cars Super Site!"></asp:Label> 
<asp:AdRotator ID="myAdRotator" runat="server"/> 
&nbsp;<br /> 
<br /> 
<asp:TreeView ID="navigationTree" runat="server"> 
</asp:TreeView> 
<hr /> 
</div> 
<div> 
<asp:ContentPlaceHolder id="ContentPlaceHolder1" runat="server"> 
</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
</html> 


图 33-9 显 示 了 当前 母 版 页 面 的 设计 时 视图 ( 注意 此 时 AdRotator 的 显示 区 域 是 空 的 )。 
MasterPage.master.cs MasterPage.master” 二 X 





Welcome to the ASP.NET Cars Super Site!- | | 
国 | 


S Root 

3 Parent 1 | | 
Leaf 1 引 
Leaf2 和 
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Leaf 1 
Leaf 2 
[ContentPlaceHolder!;— nc 7 | 









[& Design | Spit | 四 Source 
图 33-9 ”*.master 文 件 共 享 的 UI 


你 可 以 使 用 控件 内 谋 的 编辑 器 并 选择 Auto Format... 链 接 来 强化 TreeView 控 件 的 外 观 。 同 样 ， 也 可 
以 使 用 Properties 编 辑 器 美化 其 他 控件 。 在 你 满意 之 后 再 阅读 下 面 的 内 容 。 

1. 使 用 TreeView 控 件 站 点 导航 逻辑 

ASPNET 附 带 了 几 个 能 让 我 们 处 理 站 点 导航 的 Web 控 件 : SiteMapPath、TreeView 和 Menu。 就 像 我 
们 期 望 的 那样 ， 这 些 Web 组 件 可 以 以 多 种 方式 进行 配置 。 例 如 ， 每 一 个 控件 都 可 以 通过 外 部 XML 文件 
(或 基于 XML 的 *.sitemap 文 件 )、 在 代码 中 以 编程 方式 或 通过 Visual Studio 的 设计 器 标记 动态 生成 其 
节 煤 。 

我 们 的 导航 系统 可 以 使 用 *.sitemap 文 件 动态 填充 。 这 个 方式 的 优势 是 我 们 可 以 在 外 部 文件 中 定义 
网 站 的 整体 结构 ， 并 且 可 以 直接 把 它 绑 定 到 TreeVview (或 Menu ) 组 件 。 这 样 ， 如 果 网 站 的 导航 结构 改 
变 了 ,我 们 只 需要 改变 *.sitemap 文 件 并 且 重 新 加 载 页 面 即 可 。 首 先 ， 使 用 Website 一 Add New Item 菜 单 
项 打开 图 33-10 所 示 的 对 话 框 ,插入 一 个 新 的 Web.sitemap 文 件 到 项 目 中 。 
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图 33-10 ”插入 新 的 Web.sitemap 文 件 
我 们 可 以 看 到 ， 最 初 的 Web.sitemap 文 件 定义 的 最 顶层 的 项 具有 两 个 子 节点 ， 如 下 所 示 : 


<?xml] version="1.0" encoding="utf-8" ?> 
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" > 
<siteMapNode url="" title="" description=""> 
<siteMapNode url="" title="" description="" /> 
<siteMapNode url="" title="" description="" /> 
</siteMapNode> 
</siteMap> 


如 果 把 这 个 结构 绑 定 到 Menu 控 件 的 话 , 我 们 就 会 发 现 最 顶层 的 项 有 两 个 子 项 。 因 此， 如 果 我 们 希 
望 定 义 子 项 , 就 只 需要 在 既 有 的 <siteMapNode> 区 域 中 定义 新 的 <siteMapNode> 元 素 。 不 管 怎 么 样 ,目标 
是 在 Web.sitemap 文 件 中 使 用 各 种 <siteMapNode> 元 素 定义 网 站 的 整体 结构 ,每 一 个 元 素 都 可 以 定义 一 个 
标题 和 URL 特 性 。URL 特 性 表示 用 户 单 击 某 个 菜单 项 (或 TreeView 节 点 ) 时 应 该 导航 到 哪个 *.aspx 文 件 。 
我 们 的 网 站 包含 3 个 站 点 地 图 节点 ( 在 最 顶层 的 站 点 地 图 节点 下 ), 设置 如 下 : 

口 主页 面 Default.aspx; 

口 构建 汽车 BuildCar.aspx; 

口 查看 库存 Inventory.aspx。 

我 们 稍 后 将 在 项 目 中 添加 这 三 个 新 的 ASP.NET 网 页 。 现 在 ， 先 来 简单 地 配置 站 点 地 图 文件 。 

我 们 的 导航 有 一 个 最 顶层 的 Welcome 项 和 3 个 子 元 素 。 因此 , 我 们 可 以 按 如 下 所 示 更 新 Web.sitemap 
文件 。 要 知道 ， 每 一 个 url 值 必须 是 唯一 的 ( 否则 ， 就 会 收 到 运行 时 错误 ): 


<?xm] version="1.0" encoding="utf-8" ?> 
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" > 
<siteMapNode url="" title="Welcome!" description=""> 
<siteMapNode url="~/Default.aspx" title="Home" 
description="The Home Page"” /> 
<siteMapNode url="~/BuildCar.aspx" title="Build a car" 
description="Create your dream car" /> 
<siteMapNode url="~/Inventory.aspx" title="View Inventory" 
description="See what is in stock" /> 
</siteMapNode> 
</siteMap> 
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说 明 _ url 特性 中 每 一 个 页 面 之 前 的 -/ 前 组 表示 网 站 的 根 。 


现在 ， 尽 管 我 们 没有 使 用 给 定 属性 来 把 Web.sitemap 文 件 直接 关联 到 Menu 或 TreeView 控 件 上 包含 要 
显示 Web.sitemap 的 UI 组 件 的 *.master 或 *.aspx 页 面 必须 包含 siteMapDataSource 组 件 。 这 个 组 件 会 在 请 求 
页 面 的 时 候 把 Web.sitemap 文 件 自动 加 载 到 其 对 象 模型 中 。 然 后 设置 Menu 和 TreeView 类 型 的 DataSourceID 
属性 来 指向 SiteMapDataSource 实 例 。 

如 果 要 新 增 一 个 SiteMapDataSource 到 *.master 文 件 , 然后 自动 设置 DatasourceID 属 性 , 我 们 可 以 使 
用 Visual Studio 设 计 器 。 激 活 TreeView 控 件 的 内 联 编辑 器 〈 即 单 击 TreeView 右 上 和 角 的 小 箭头 )， 展 开 
Choose Data Source 下 拉 列 表 ， 然 后 选择 New Data Source， 如 图 33-11 所 示 。 
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图 33-11 新 增 SiteMapDataSource 


从 结果 对 话 框 中 选择 SiteMap 图 标 。 这 会 设置 Menu 或 TreeView 控 件 的 DataSsourceID 属 性 ， 并 且 向 我 
们 的 页 面 新 增 一 个 SiteMapDataSource 组 件 。 这 就 是 配置 TreeView 控 件 来 导航 到 网 站 其 他 页 面 需 要 做 的 
所 有 事情 。 如 果 和 希望 在 用 户 选择 某 个 菜单 项 的 时 候 进 行 其 他 处 理 ， 可 以 通过 处 理 TreeView 控 件 的 
SelectedNodeChanged 事 件 来 实现 。 对 于 本 例 ， 不 需要 这 么 做 , 但 是 要 知道 ， 你 可 以 使 用 传人 的 事件 参 
数 来 检测 哪个 菜单 项 被 单 击 了 。 

2. 使 用 SiteMapPath 类 型 创建 浏览 路 径 

在 转移 到 AdRotator 组 件 之 前 ， 向 *.master 文 件 的 内 容 占 位 符 元 素 下 增加 一 个 SiteMapPath 类 型 ( 位 于 
Toolbox 中 Navigation 标 签 页 下 )。 这 个 组 件 会 根据 菜单 系统 的 当前 选择 自动 调整 其 内 容 。 你 可 能 知道 ， 
这 为 终端 用 户 提供 了 有 用 的 可 视 化 提示 ( 正式 地 说 ， 这 个 UI 技术 称 为 浏览 路 径 )。 在 完成 了 这 个 示例 
之 后 ， 如 果 选 择 Welcome 一 Build a Car 菜 单项 ，SiteMapPath 组 件 也 就 自动 进行 了 相应 的 更 新 。 

3. 配置 AdRotator 控 件 

ASPNET AdRotator 部 件 的 作用 是 在 浏览 器 的 某 个 位 置 随机 显示 一 个 特定 的 图 片 。 这 时 , AdRotator 
展示 为 一 个 空 的 占 位 符 。 从 功能 上 讲 ， 这 个 控件 不 能 发 挥 它 的 作用 ， 除 非 设置 AdvertisementFile 属 性 
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指向 描述 每 个 图 片 的 源 文件 。 对 于 这 个 例子 来 说 ， 数 据 源 将 是 一 个 名 为 Ads.xml 的 简单 的 XML 文件 。 
要 在 网 站 中 添加 了 这 个 XML 文件 需 打 开 Website 一 Add New Item 菜 单项 并 选择 XML 文件 。 将 该 文 
件 命 名 为 Ads.xml 并 为 每 个 希望 显示 的 图 片 指定 唯一 的 <Ad> 元 素 。 至少, 每 个 cAd> 元 素 指定 要 显示 的 图 
片 (ImageUrl )、 要 导航 的 URL[ 如 果 这 个 图 片 被 选择 了 ( TargetUrl ) ]、 鼠 标 置 于 其 上 时 显示 的 文本 内 
容 (AlternateText )、 广 告 出 现 频率 权 数 ( Impressions ): 
<Advertisements> 
<Ad> 
<ImageUrl>SlugBug.jpg</ImageUrl> 
<TargetUrl>http://www.Cars.com</TargetUrl> 
<AlternateText>Your new Car?</AlternateText> 
<Impressions>80</Impressions> 
</Ad> 
<Ad> 
<ImageUrl>car.gif</ImageUrl> 
<TargetUrl>http://www.CarSuperSite.com</TargetUrl> 
<AlternateText>Like this Car?</AlternateText> 
<Impressions>80</Impressions> 


</Ad> 
</Advertisements> 


在 这 里 ， 我 们 指定 了 两 个 图 片 文件 (slugbug.jpg 和 car.gif )。 因 此 ， 我 们 需要 确保 这 些 文件 在 网 站 
的 根 目录 中 (这 些 文件 可 以 从 本 书 的 代码 下 载 中 找到 )。 要 把 它们 加 入 当前 项 目 ， 只 需要 选择 WebSite 
一 Add Existing 菜 单项 。 此 刻 ， 可 以 通过 AdvertisementFile 属 性 ( 在 Properties 窗 口中 ) 将 XML 文件 与 
AdRotator 控 件 关联 起 来 ， 如 下 所 示 : 


<asp:AdRotator ID="myAdRotator" runat="server" 
AdvertisementFile="~/Ads.xml"/> 


稍 后 运行 这 个 应 用 程序 并 且 回 传 到 页 面 时 ， 将 随机 展示 两 个 图 片 文 件 中 的 一 个 。 


33.4.2 ”定义 默认 的 内 容 页 面 


现在 你 已 拥有 一 个 创建 好 了 的 母 版 页 ， 可 以 开始 设计 单独 的 *.aspx 页 面 了 ， 这 些 页 面 将 定义 合并 
在 母 版 页 的 <asp:ContentPlaceHolder> 标 签 内 的 UI 内 容 。 被 合并 到 母 版 页 的 *.aspx 文 件 称 为 内 容 页 面 ， 
它 与 独立 的 ASP.NET Web 页 面 有 一 些 关 键 的 不 同 之 处 。 
简 言 之 ，*.master 文 件 定义 了 最 后 的 HTML 页 面 的 <form> 片 段 。 因 此 ，*.aspx 文 件 内 现 有 的 <form> 
区 域 将 需要 由 <asp:Content> 作 用 域 代 蔡 。 你 可 以 手动 更 新 初始 *.aspx 文 件 的 标记 ， 然 后 将 一 个 新 的 内 
容 页 面 自动 插入 到 项 目 中 ， 不 过 只 需要 右 击 *.master 文 件 设计 器 界面 中 的 任意 地 方 ， 然 后 选择 Add 
Content Page 菜 单项 就 可 以 了 ( 如 图 33-12 所 示 )。 
这 就 会 生成 一 个 具有 下 面 初始 标记 的 新 *.aspx 文 件 : 
<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" 
AutoEventWireup="true" CodeFile="Default.aspx.cs" 
Inherits=" Default" Title=" " %> 
<asp:Content ID="Content1" 
ContentPlaceHolderID="head" Runat="Server"> 
</asp:Content> 
<asp:Content ID="Content2" 


ContentPplaceHolderID="ContentPlaceHolder1" Runat="Server"> 
</asp:Content> 
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图 33-12 在 母 版 页 中 添加 一 个 新 的 内 容 页 


首先 ， 注 意 使 用 了 一 个 新 的 被 赋值 指向 *.master 文 件 的 MasterPageFile 特 性 ， 更 新 了 <%@Page%> 指 
令 。 同 时 注意 有 一 个 <asp:Content> 作 用 域 ( 而 非 cformv 元 素 )， 目 前 为 空 ， 它 设置 的 ContentPlaceHolderID 值 
与 母 版 文件 内 的 casp:ContentPlaceHolder> 部 件 是 一 样 的。 

虽然 在 内 容 页 面 上 母 版 的 内 容 以 只 读 形式 进行 显示 ,但 是 有 了 这 样 的 关联 ， 内 容 页 面 就 知道 要 在 哪里 
插 和 人 其 内 容 。 不 需要 为 Default.aspx 内 容 区 域 构建 复杂 的 UI， 因 此 对 于 本 例 ， 只 需要 增加 一 些 文本 来 提 
供 一 些 基本 的 站 点 指令 , 如 图 33-13 所 示 ( 还 要 注意 设计 器 中 内 容 页 面 的 右上 部 分 有 一 个 链接 可 以 切换 
到 关联 的 母 版 文件 )。 
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图 33-13 ”创建 第 一 个 内 容 页 面 
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现在 ， 如 果 运 行 该 项 目 ， 你 将 发 现 *.master 和 Default.aspx 文 件 的 UI 内 容 已 经 合并 成 一 个 简单 的 
HTML 流 ,如 在 图 33-14 所 看 见 的 ,终端 用 户 无 法 察觉 母 版 页 的 存在 ( 浏览 器 只 是 简单 地 展示 Default.aspx 
中 的 HTML )。 按 F5 键 刷新 页 面 ，AaRotator 将 会 随机 显示 两 个 图 片 中 的 一 
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图 33-14 ”在 运行 时 ， 母 版 页 面 和 内 容 页 面 形成 了 一 个 表单 


33.4.3 ”设计 Inventory 内 容 页 面 


为 了 向 当前 项 目 中 插入 Inventory.aspx 内 容 页 面 ， 在 IDE 中 打开 *.master 页 面 ， 然 后 选择 Website 一 
Add Content Page 并 用 Solution Explorer 将 文件 重 命名 为 Inventory.aspx。Inventory 内 容 页 面 的 作用 是 在 一 
个 Gridview 控 件 内 显示 AutoLot 数 据 库 的 Inventory 表 的 内 容 。 不 过 与 上 一 章 不 同 的 是 ，Gridview 将 使 用 

内 秽 的 数据 绑 定 支持 ， 配 置 为 与 AutoLot 数 据 库 交 互 。 

ASPNET Gridview 控 件 以 标记 形式 表示 连接 字符 串 数据 和 SQL 的 Select、Insert 、Update 和 Delete 
语句 (或 者 存储 过 程 )。 因 此 ， 我们 可 以 使 用 sqlDataSource 类 生成 标记 而 无 需 手 动 编写 所 有 必要 的 
ADO.NET 代 码 。 使 用 可 视 化 设计 器 , 我 们 可 以 把 GridView 的 DataSourceID 属 性 赋 给 SqglDataSource 组 件 。 

使 用 几 个 简单 的 鼠标 单 击 ， 就 能 配置 Gridview 使 其 自动 选择 、 更 新 和 删除 底层 数据 存储 的 记录 。 
虽然 这 个 零 编 码 使 样本 文件 代码 的 数量 变 得 非常 简单 ,但 要 明白 一 点 ,伴随 简单 而 来 的 是 控件 性 能 的 
降低 , 并 且 对 于 企业 级 应 用 程序 来 说 可 能 不 是 最 优 实现 方法 。 对 于 低 访 问 量 的 页 面 、 网 站 的 原型 制作 、 
小 的 内 部 应 用 程序 而 言 ， 这 个 模型 很 不 错 。 

为 了 演示 如 何以 声明 方式 使 用 Gridview ( 和 数据 访问 逻辑 )， 首 先 需 要 使 用 描述 性 Label 控 件 更 新 
Inventory.aspx 内 容 页 面 。 然后， 打开 Server Explorer ( 通过 View 菜 单 )， 并 且 确 保 添加 了 我 们 研究 
ADO.NET 时 创建 的 AutoLot 数 据 库 的 数据 连接 ( 对 于 增加 数据 连接 的 整个 过 程 , 可 参见 第 21 章 ), 现在 ， 
选择 Server Explorer 中 的 Inventory 表 并 且 将 它 拖 到 Inventory.aspx 文 件 的 内 容 区 域 中 。 完 成 后 ，IDE 就 
会 进行 如 下 的 步骤 。 

(1) web.config 文 件 已 经 使 用 新 的 <connectionstrings> 元 素 进 行 更 新 了 。 

(2) 一 个 SqlDataSource 组 件 已 经 配置 了 必要 的 Select、Insert、Update 和 Delete 逻 辑 。 
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(3) Gridview 的 DataSourceID 属 性 已 经 被 设置 为 新 的 SqlDataSource 组 件 。 
说 明 ”作为 将 表 拖 奥 到 Server Explorer 的 替代 方式 , 我 们 可 以 使 用 内 联 编辑 器 ( 右边 ) 来 配置 GridView 


组 件 。 从 Choose Data Source 下 拉 框 中 选择 New Data Source。 这 会 激活 一 个 向 导 ， 它 通过 一 系 
列 步 骤 来 把 这 个 组 件 连接 到 必要 的 数据 源 。 





如 果 研 究 GridView 控 件 开始 的 声明 ， 将 会 发 现 DatasourceID 属 性 已 经 被 设置 为 我 们 刚才 定义 的 
SqlDataSource， 如 下 所 示 : 


<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False" 
DataKeyNames="CarID" DataSourceID="SqlDataSource1" 
EmptyDataText="There are no data records to display."> 
<Columns> 
<asp:BoundField DataField="CarID" HeaderText="CarID" ReadOnly="True" 
SortExpression="CarID" /> 
<asp:BoundField DataField="Make" HeaderText="Make" SortExpression="Make" /> 
<asp:BoundField DataField="Color" HeaderText="Color" SortExpression="Color" /> 
<asp:BoundField DataField="PetName" HeaderText="PetName" 
SortExpression="PetName" /> 
</Columns> 
</asp:GridView> 


SqlDataSource 元 素 是 活动 发 生 的 主要 地 方 。 注 意 ， 在 其 后 的 标记 中 ， 这 个 元 素 记 录 了 必要 的 SQL 
语句 (不 少 参数 化 查询 ) 来 和 AutoLot 数 据 库 的 Inventory 表 进行 交互 。 同 样 ， 使 用 Connectionstring 
属性 的 $ 语 法 ， 这 个 组 件 可 以 自动 从 web.config 中 读 取 <connectionSstrings> 值 : 


<asp:SqlDataSource ID="SqlDataSource1" runat="server" 

ConnectionString="<%$ ConnectionStrings:AutoLotConnectionString1 %>" 
DeleteCommand="DELETE FROM [Inventory] WHERE [CarID] = @CarID" 
InsertCommand="INSERT INTO [Inventory] ([CarID], [Make], [Color], [PetName]) 

VALUES (@CarID, @Make, @Color, @PetName)" 
ProviderName="<%$ ConnectionStrings:AutoLotConnectionString1.ProviderName %> 
SelectCommand="SELECT [CarID], [Make], [Color], [PetName] FROM [Inventory]” 
UpdateCommand="UPDATE [Inventory] SET [Make] = @Make, 

[Color] = @Color, [PetName] = @PetName WHERE [CarID] = @CarID"> 
<DeletePparameters> 

<asp:Parameter Name="CarID" Type="Int32" /> 
</Deleteparameters> 
<UpdateParameters> 

<asp:Parameter Name="Make" Type="String" /> 

<asp:Parameter Name="Color" Type="String" /> 

<asp:Parameter Name="PetName" Type="String" /> 

<asp:Parameter Name="CarID" Type="Int32" /> 
</UpdatePparameters> 
<InsertParameters> 

<asp:Parameter Name="CarID" Type="Int32" /> 

<asp:Parameter Name="Make" Type="String” /> 

<asp:Parameter Name="Color" Type="String" /> 

<asp:Parameter Name="PetName" Type="String" /> 
</InsertParameters> 

</asp:SqlDataSource> 


此 刻 ， 可 以 运行 Web 程 序 了 ， 单 击 View Inventory 菜 单项 ， 然 后 查看 数据 ， 如 图 33-15 所 示 。( 还 要 
注意 ,我 用 统一 的 外 观 通过 内 联 设计 器 更 新 Gridview 网 格 。) 
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Ford Rust Rusty 
BMW Black Hik 
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Ferd ReE Snake 
Yugo Pink Pinky 





图 33-15 ”无 代码 的 SqglDataSource 组 件 


启用 排序 和 分 页 
pi eg 
行 配置 。 如 果 要 这 么 做 ,激活 内 联 编辑 器 ， 选 择 适 当 的 选项 ， 如 图 33-16 所 示 。 
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图 33-16 ”启动 分 页 和 排序 
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当 再 次 运行 页 面 时 , 经 由 分 页 链接 ( 假设 在 Inventory 表 里 有 足够 的 记录 ) 通过 单 击 列 名 并 从 头 至 
尾 滚动 数据 ， 你 就 能 够 对 数据 进行 排序 了 。 

2. 启用 现场 编辑 

这 个 页 面 的 最 后 一 个 细节 是 启用 Gridview 控 件 的 现场 编辑 功能 。 由 于 SqlDataSource 已 经 有 了 必需 的 
Delete 和 Update 逻 辑 ， 所 以 我 们 只 需要 检查 Gridview 的 Enable Deleting 和 Enable Editing 复 选 框 〈 相关 的 
位 置 请 参考 图 33-16 )。 可 以 肯定 的 是 ， 如 果 导 航 回 Inventory.aspx 页 面 的 话 ， 我 们 就 可 以 编辑 和 删除 记 








| Searche 5 Welcome to the ASP.NET Cars Super Site! 


7 Bookmerts Menu Want a Blue SLUG BUG? 
+ WB Recently Bookmarked 。 Come to Cars.com! 
+ BY Recent Tags es 


My suf 3 welceme! 
| 区 Unsorted Bookmarks i 





Welcome! : View Inventory 


Here is our current Inventory! 


EditDelete 
Edit Delete 
Edit Delete 
Edit Delete 





图 33-17 编辑 和 删除 功能 


说 明 要 为 GridView 启 用 现场 编辑 ,需要 为 数据 库 表 设 置 主键 。 如 果 看 到 这 些 选项 没有 启用 , 很 可 能 
是 因为 你 忘 了 将 AutoLot 数 据 库 Inventory 表 中 的 CarID 设 置 为 主键 。 


33.4.4 设计 Build-a-Cazr 内 容 页 面 


这 个 例子 的 最 后 任务 是 设计 BuildCaraspx 内 容 页 面 。 打 开 *.master 文 件 , 将 文件 插入 到 当前 项 目 ( 通 
过 Website 一 Add Content Page 菜 单项 )。 还 可 以 右键 单 击 项 目的 母 版 页 。 使 用 Solution Explorer 将 新 文件 
改名 为 BuildCar.aspx。 

这 个 新 页 面 将 利用 ASPNET 的 Wizard Web 控 件 ， 这 个 控件 提供 了 一 个 简单 的 方法 ， 使 得 我 们 通过 
一 系列 相关 步骤 就 可 以 得 到 终端 用 户 界面 。 本 例 中 的 步 又 将 模拟 创建 一 个 购买 汽车 的 行为 。 

向 内 容 区 域 放置 一 个 描述 性 的 Label 和 Wizard 控 件 。 接 下 来 ,激活 Wizard 的 内 联 编辑 器 并 单 击 Add/ 
Remove WizardSteps 链 接 。 一 共 添 加 4 步 ， 如 图 33-18 所 示 。 
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图 33-18 ”配置 向 导 


定义 这 些 步 又 之 后 ， 你 将 注意 到 ，Wizard 定 义 了 一 个 空 的 内 容 区 域 。 在 这 个 区 域 里 ， 你 现在 能 够 
为 当前 所 选择 的 步骤 拖 放 控 件 。 对 于 这 个 例子 来 说 ,使 用 下 面 的 UI 元 素 更 新 每 一 步 ( 确定 使 用 Properties 
窗口 为 每 项 提供 一 个 合适 的 ID 值 )。 

口 Pick Your Model: TextBox 控 件 。 

口 Pick Your Color: ListBox 控 件 。 

口 Name Your Car: TextBox 控 件 。 

口 Delivery Date: Calendar 控 件 。 

ListBox 控 件 是 Nizard 的 唯一 UI 元 素 ，Mizard 需 要 另外 一 些 步骤 。 在 设计 器 上 选择 此 项 ( 确定 你 首 
先 选择 了 Pick Your Color 链 接 )， 然 后 通过 Properties 窗 口 的 Items 属 性 使 用 一 套 颜 色 填 充 这 个 部 件 。 这 
时 你 将 发 现 ， 标 记 与 下 面 在 Wizard 定 义 作 用 域内 的 内 容 非常 相似 : 


<asp:ListBox ID="ListBoxColors" runat="server" Width="237px"> 
<asp:ListItem>Purple</asp:ListItem> 
<asp:ListItem>Green</asp:ListItem> 
<asp:ListItem>Red</asp:ListItem> 
<asp:ListItem>Yellow</asp:ListItem> 
<asp:ListItem>Pea Soup Green</asp:ListItemy> 
<asp:ListItem>Black</asp:ListItem> 
《asp:ListItem>Lime Green</asp:ListItem> 

</asp:ListBox> 


既然 已 经 定义 了 每 一 步 ， 你 就 能 够 为 自动 生成 的 Finish 按 钮 处 理 FinishButtonClick 事 件 了 。 但 要 
注意 的 是 ， 直 到 在 设计 器 中 选择 向 导 的 最 后 一 步 之 后 ， 才 会 看 到 这 个 Finish 按 钮 。 一 旦 选择 了 最 后 一 
步 ， 可 以 双击 Finish 按 钮 来 生成 事件 处 理 程序 。 在 服务 器 端的 事件 处 理 程序 内 ， 从 每 个 UI 元 素 中 获得 
选择 项 并 创建 一 个 描述 字符 串 ， 这 个 字符 串 被 分 配给 了 另外 一 个 名 为 lbl0rder 的 Label 类 型 的 Text 属 
性 ， 如 下 所 示 : 


public partial class BuildCarpPage : System.Web.UI.Page 


protected void Page Load(object sender, EventArgs e) 
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{ 
} 


protected void carWizard FinishButtonClick(object sender, 
WizardNavigationEventArgs e) 


// 得 到 每 一 个 值 

string order = string.Format("{0}, your {1} {2} will arrive on {3}.", 
txtCarPetName.Text, ListBoxColors.SelectedValue, 

txtCarModel .Text, 

carCalendar.SelectedDate.ToShortDateString()); 


// 赋值 给 标签 
lblOrder.Text = order; 
} 
} 


现在 AspNetCarsSite 就 完成 了 。 图 33-19 显 示 了 运行 中 的 Wizard。 





2? Welcome to the ASPNET Cars Super 
Site! 


Want a RED slug bug? 
Come to CarSuperSite.com 





walcomais Duidacar ss 
Use this Wizard to build 
your Dream Car 


Melvin, your Green BMW will arrive on 4/27/2012. 





图 33-19 ”运行 中 的 Wizard 


至 此 ， 对 各 种 ASPNET Web 控 件 、 母 版 页 、 内 容 页 和 站 点 地 图 导航 的 研究 就 结束 了 。 接 下 来 ,我 
们 看 看 ASPNET 验 证 控件 的 功能 。 为 了 使 本 章 话题 保持 独立 ， 我 们 将 构建 一 个 新 的 网 站 来 演示 验证 技 
术 。 不 过 ， 你 很 可 能 已 经 在 当前 项 目 中 添加 了 验证 控件 。 


源 代码 ”AspNetCarsSite 网 站 的 源 代码 位 于 Chapter 33 子 目录 下 。 
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33.5 ”验证 控件 的 作用 


我 们 将 研究 的 下 一 组 Web 窗 体 控件 统称 为 验证 控件 ( validation control ) 。 不 同 于 已 经 研究 过 的 其 
他 Web 窗 体 控件 , 验证 控件 并 不 是 用 来 生成 HTML 的 , 而 是 通过 客户 端 JavaScript 实 现 窗 体验 证 的 目的 。 
本 章 开始 已 经 提 到 了 ， 客 户 端 窗 体 验证 是 非常 有 用 的 ， 因 为 你 能 确保 在 回 传 到 Web 服 务 器 前 ， 将 各 种 
各 样 的 约束 放置 在 适当 的 位 置 上 ， 从 而 避免 代价 高 昂 的 往返 行程 。 表 33-3 简 要 列 出 了 一 些 ASPNET 验 
证 控件 。 
表 33-3 ”ASP.NET 验 证 控件 


控 件 作 用 
CompareValidator 验证 一 个 输入 控件 的 值 是 否 等 于 另 一 个 输入 控件 或 固定 常量 的 给 定 值 
CustomValidator 允许 创建 一 个 自 定义 的 验证 功能 ， 以 验证 给 定 的 控件 
RangeValidator 在 一 个 预先 确定 的 范围 内 确定 一 个 给 定 值 
RegularExpressionValidator 检查 相关 联 的 输入 控件 的 值 是 否 匹 配 一 个 正则 表达 式 的 模式 
RequiredFieldValidator 确保 一 个 给 定 输入 控件 包含 有 一 个 值 ( 即 非 空 ) 
ValidationSummary 使 用 一 个 列表 、 一 个 项 目 列表 或 一 个 段落 显示 网 页 上 所 有 验证 错误 的 概况 。 


这 些 错 误 可 以 在 一 行内 显示 或 在 弹出 的 信息 框 里 显示 


所 有 的 验证 控件 都 派生 于 名 为 System.Web.UI.WebControls.BaseValidator 的 公共 基 类 ( Validation 
Summary 除 外 )。 因 此 它们 拥有 一 套 公 共 的 特征 。 表 33-4 记 载 了 其 中 关键 的 成 员 。 


表 33-4 ASP.NET 验 证 程序 的 公共 属性 


成 员 作 用 
ControlToValidate 获取 或 设置 输入 控件 以 进行 验证 
Display 获取 或 设置 验证 控件 里 的 出 错 信 息 的 显示 方式 
EnableClientScript 获取 或 设置 指明 客户 端 验证 是 否 启动 的 值 
ErrorMessage 获取 或 设置 出 错 信 息 的 文本 
ForeColor 获取 或 设置 当 验 证 失败 时 信息 的 颜色 


为 了 演示 如 何 使 用 验证 控件 ,我们 创建 一 个 名 为 ValidatorCtrls 的 空 网 站 项 目 并 向 其 中 插入 一 个 名 
为 Default.aspx 的 新 Web 表 单 。 首先 , 在 页 面 上 放置 4 个 TextBox 控 制 ( 带 有 4 个 对 应 的 、 描 述 性 的 Label )。 
接 下 来 ， 在 邻近 每 个 输入 字段 处 放置 RequiredFieldValidator、RangeValidator 、RegularExpression- 
Validator 和 CompareValidator 控 件 。 最 后 ， 添 加 一 个 Button 和 Label。 图 33-20 展 示 了 一 种 可 能 的 
布局 。 

现在 已 经 有 一 个 初始 UI， 让 我 们 完成 配置 所 有 验证 器 控件 的 全 过 程 并 查看 最 终 的 结果 。 不 过 在 此 
之 前 ,我们 需要 修改 当前 的 web.config 文 件 ， 来 允许 客户 端 处 理 验 证 控件 。 


33.5 ”验证 控件 的 作用 1147 


ValidationGroups.asp Default.aspx 呈 X 
|asp:Label#Labels| 


Fun with ASP.NET Validators [ 















Required Field: | 

[Please enter your name 。 A | 寻 

[RequredFieldValidator1] | 

Range 0 - 100: | 

[RangeValidator1] | 

‘ Enter your US SSN E 

| [RegularExpressionValidator1] | 

' Value < 20 | 
[CompareValidator1] 


Post back_| [lbIValidationComplete] 
‘ Here are the things you must correct. 


® Error message 1. 
e。 Error message 2. 


B Design ] = Split |@ source | |4|[<av>| pebass BG 
图 33-20 ASP.NET 验 证 控件 保证 在 回 传 前 表单 数据 是 正确 的 


33.5.1 开启 客户 端 JavaScript 验 证 支持 


从 ASPNET 4.5 开 始 ， 微 软 引 入 了 新 的 设置 ， 可 以 在 运行 时 控制 验证 控件 的 响应 。 打 开 web.config 
文件 ， 可 以 找到 下 面 的 设置 : 
<appSettings> 


cadd key="ValidationSettings:UnobtrusiveValidationMode" value="WebForms" /> 

</appSettings> 

如 果 配 置 文件 中 包含 这 段 配 置 ， 那 么 网 站 将 使 用 不 同 的 HTML 5 数据 特性 来 处 理 验 证 ， 而 不 是 
发 回 客户 端 JavaScript 代 码 再 由 浏览 器 进行 处 理 。 由 于 本 书 不 会 深入 HTML 5 的 细节 ， 我 们 需要 将 这 
一 行 注 释 掉 ( 或 移 除 )， 以 使 当前 的 验证 示例 正确 工作 。 因 此 ， 简 单 地 注释 掉 <appSettings> 节 中 的 
该 节点 : 

<appSettings> 

a key="ValidationSettings:UnobtrusiveValidationMode" value="WebForms" /> 


--> 
</appSettings> 
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33.5.2 RequiredFieldValidator 


配置 RequiredFieldvalidator 很 简单 。 只 需要 使 用 Visual Studio 的 Properties 窗 口 相应 地 设置 
ErrorMessage 和 ControlToValidate 属 性 。 产 生 的 标记 能 确保 txtRequiredField 文 本 框 不 为 空 : 


<asp:RequiredFieldValidator ID="RequiredFieldValidator1" 
runat="server" ControlToValidate="txtRequiredField" 
ETYTOTMessage= "0ops! Need to enter data. > 

</asp:RequiredFieldValidator> 


RequiredFieldValidator 支 持 InitialValue 属 性 。 可 以 使 用 这 个 属性 确保 用 户 在 相关 的 TextBox 中 输 
入 任何 不 同 于 初始 值 的 值 。 例 如 , 当 用 户 首次 登录 到 一 个 页 面 时 ,你 可 能 希望 配置 一 个 包含 "Please enter 
your name” 值 的 文本 框 。 现 在 ， 如 果 不 设置 RequiredFieldValidator 的 InitialValue 属 性 ,运行 时 将 认 
为 字符 串 “Please enter your name” 是 有 效 的 。 这样, 为 了 确保 只 有 当 用 户 输入 任何 非 “Please enter your 
name” 的 内 容 时 TextBox 才 有 效 ， 按 如 下 代码 所 示 配 置 部 件 : 


<asp:RequiredFieldValidator ID="RequiredFieldValidator1" 
runat="server" ControlToValidate="txtRequiredField" 
ETTOTMessage="0ops! Need to enter data.”" 
InitialValue="Please enter your name"> 

</asp:RequiredFieldValidator> 


33.5.3 RegularExpressionValidator 


当 希 望 对 在 给 定 输入 字段 内 键入 的 字符 应 用 模式 时 ,RegularExpressionValidator 很 和 用。 为 了 确 
保 一 个 给 定 Textbox 包 含有 效 的 美国 社会 安全 号 ， 可 以 使 用 如 下 方法 定义 部 件 : 


<asp:RegularExpressionValidator ID="RegularExpressionValidator1" 
runat="server" ControlToValidate="txtRegExp" 
ErrorMessage="Please enter a valid US SSN.” 
ValidationExpression="\d{3}-\d{2}-\d{4}"> 

</asp:RegularExpressionValidator> 


注意 ，RegularExpressionValidator 是 如 何 定 义 ValidationExpression 属 性 的 。 如 果 你 以 前 从 未 使 
用 过 正则 表达 式 ， 对 这 个 例子 需要 关心 的 就 是 正则 表达 式 用 来 匹配 一 个 给 定 的 字符 串 模 式 。 这 里 ， 表 
达 式 "\d{3}-\df2}-\d{f4} "表示 获取 一 个 结构 为 xxx-xx-xxxx ( 这 里 x 表示 任何 阿拉 伯 数 字 ) 的 标准 美国 
社会 安全 号 码 。 

这 个 特殊 的 正则 表达 式 比 较 容 易 理 解 ， 然 而 ， 如 果 你 希望 测试 一 个 有 效 的 日 本 电话 号 码 ， 正 确 的 
表达 式 就 变 得 复杂 得 多 了 : "(o\d{1,4}-|\(o\df1,4}\) ?)?\d{1,4}-\d{4}"。 好 消息 是 当 使 用 Properties 
窗口 选择 ValidationExpression 属 性 时 ， 你 能 从 一 套 预 定义 的 公共 正则 表达 式 中 选择 。 


说 明 如 果 对 正则 表达 式 感 兴趣 ， 你 将 高 兴 地 了 解 到 .NET 平 台 提供 两 个 命名 空间 ( System.Text . 
RegularExpressions 和 System.Web.RegularExpressions )， 专 用 于 这 类 模式 的 程序 处 理 。 


33.5.4 RangeValidator 
除了 MinimumValue 和 MaximumValue 属 性 外 ，RangeValidator 还 有 一 个 名 为 Type 的 属性 。 如 果 你 想 测 
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试用 户 输入 的 值 是 否 在 某 两 个 整数 之 间 ， 需 要 指定 Integer ( 该 项 非 默认 )， 如 下 所 示 : 


<asp:RangeValidator ID="RangeValidator1" 
runat="server" ControlToValidate="txtRange" 
ErrorMessage="Please enter value between 0 and 100." 


MaximumValue="100" MinimumValue="0" Type="Integer"> 
</asp:RangeValidator> 


RangeValidator 也 能 够 用 于 测试 给 定 值 是 否 在 一 个 货币 值 、 日 期 、 浮 点 数 或 者 字符 串 数据 之 间 ( 默 
认 的 设置 )。 


33.5.5 CompareValidator 
最 后 ， 注 意 CompareValidator 支 持 下 面 的 0perator 属 性 : 


<asp:CompareValidator ID="CompareValidator1" runat="server" 
ControlToValidate="txtComparison" 
ErrorMessage="Enter a value less than 20." Operator="LessThan" 
ValueToCompare="20" Type="Integer"> 

</asp:CompareValidator> 


上 面 这 个 验证 程序 的 作用 是 ， 使 用 二 元 操作 符 将 文本 框 内 的 值 和 另 一 个 值 进行 比较 ，0perator 属 
性 设置 为 像 LessThan 、GreaterThan 、Equal 和 NotEqual 那 样 的 值 就 不 会 让 人 感到 惊讶 了 。 同 时 注意 ， 
ValueToCompare 用 于 建立 一 个 用 来 比较 的 值 。 还 要 注意 我 们 将 Type 特 性 设置 成 了 Integer。 默认 情况 下 ， 
CompareValidator 验 证 的 是 字符 串 值 。 


说 明 ”CompareValidator 也 能 使 用 ControlToCompare 属 性 配置 ， 用 以 比较 另 一 个 Web 窗 体 控件 (而 非 
一 个 硬 编码 值 ) 内 的 值 。 


最 后 完成 这 个 页 面 的 代码 , 处 理 Button 控 件 的 Click 事 件 , 并 通知 用 户 他 已 经 成 功 地 进行 了 验证 膛 
辑 ， 如 下 所 示 : 


public partial class Default : System.Web.UI.Page 


protected void Page Load(object sender, EventArgs e) 


} 
protected void btnPostback Click(object sender, EventArgs e) 
lblValidationComplete.Text = "You passed validation!"; 


} 

现在 ， 使 用 你 的 浏览 器 导航 到 该 页 面 。 此 刻 ， 你 不 应 该 看 到 任何 显著 的 变化 。 然 而 ， 当 试图 在 输 
入 错误 数据 后 单 击 Submit 按 钮 时 ， 错 误 信 息 立 刻 就 显现 出 来 了 。 如 果 查 看 浏览 器 里 显示 的 HTML 源 代 
码 ， 将 看 见 验证 控件 生成 了 一 个 客户 端 JavaScript 函 数 ， 这 个 函数 使 用 自动 下 载 到 用 户 计 算 机 的 
JavaScript 函 数 的 指定 库 。 一 旦 客户 端 验证 通过 ， 表 单数 据 就 回 传 到 服务 器 ,其 中 ASPNET 运 行 时 将 执 
行 在 Web 服 务 器 上 的 相同 的 验证 测试 ( 以 确保 表单 数据 在 传送 到 服务 器 的 过 程 中 没有 人 算 改 )。 
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相关 提示 : 如 果 HTTP 请 求 被 一 个 不 支持 客户 端 JavaScript 的 浏览 器 发 送 ， 所 有 的 验证 将 会 发 生 在 
服务 器 上 。 使 用 这 种 方式 就 能 针对 验证 控件 编程 而 不 必 考 虑 目标 浏览 器 ， 返 回 的 HTML 页 面 将 错误 处 
理 重 定向 到 Web 服 务 需 。 


33.5.6 ”创建 ValidationSummary 


我 们 要 研究 的 下 一 个 与 验证 相关 的 话题 是 ValidationSsummary 部 件 的 使 用 。 目 前 ， 每 个 验证 控件 都 
在 准确 的 位 置 显 示 了 它 的 错误 信息 ， 这 个 位 置 在 设计 时 定位 。 在 许多 情况 下 ， 这 也 许 正 是 你 正在 寻找 
的 东西 。 然 而 ,在 一 个 有 着 大 量 输入 部 件 的 复杂 窗 体 上 ， 你 可 能 不 希望 有 随机 的 红色 文本 斑点 时 不 时 
地 蹦 出 来 。 使 用 validationsummary 类 型 ， 能 够 指示 所 有 的 验证 类 型 在 页 面 的 特定 位 置 处 显示 它们 的 错 
误 信息 。 ， 
第 一 步 是 在 *.aspx 文 件 上 放置 一 个 ValidationSummary。 你 可 以 选择 设置 这 个 类 型 的 HeaderText 属 性 
和 DisplayMode 属 性 ， 默 认 情 况 下 这 个 控件 使 用 项 目 列表 列 出 所 有 错误 信息 : 


<asp:ValidationSummary id="ValidationSummary1" 
runat="server" Width="353px" 
HeaderText="Here are the things you must correct."> 
</asp:ValidationSummary> 


接 下 来 ,把 页 面 上 每 个 单独 的 验证 程序 ( 例如 , RequiredFieldValidator、RangeValidator 等 ) 的 Display 
属性 设置 为 None。 这 将 确保 不 会 出 现 验 证 失败 的 重复 错误 信息 (一 个 在 摘要 窗 格 里 ， 另 一 个 在 验证 控 
件 的 位 置 )。 图 33-21 显 示 了 运行 中 的 摘要 窗 格 。 
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| | Untitied Page 4 
| 
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se Please enter a valid US SSN 

e Enter avaiue less than 20 















图 33-21 使 用 验证 摘要 
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最 后 ， 如 果 你 更 愿意 使 用 客户 端 提示 框 显示 错误 信息 ， 可 以 将 ValidationSsummary 控 件 的 Show- 
MessageBox 属 性 设置 为 true， 将 ShowSummary 属 性 设置 为 false。 


33.5.7 ”定义 验证 分 组 

我 们 还 可 以 定义 验证 器 程序 所 属 的 分 组 。 如 果 页 面 区 域 作为 一 个 整体 一 起 工作 的 话 , 这 就 很 有 用 。 
例如 ， 在 一 个 Pane1 对 象 中 ， 可 以 有 一 组 控件 允许 用 户 输入 他 或 她 的 邮件 地 址 ， 另 外 一 个 Pane1 包 含 了 
UI 元 素 ， 用 来 收集 信用 卡 信息 。 使 用 分 组 ， 我 们 可 以 配置 每 一 个 控件 组 来 独立 验证 。 

将 一 个 新 的 Validation.aspx 页 面 插入 到 当前 项 目 中 , 它 定 义 了 两 个 panel。 第 一 个 Pane1 对 象 需要 有 
一 个 TextBox 来 包含 一 些 用 户 的 输入 (通过 RequiredFieldvalidator )， 而 第 二 个 Panel 需 要 一 个 美国 社 
会 安全 号 ( 通过 RegularExpressionValidator )。 图 33-22 显 示 了 每 一 个 可 能 的 UI。 


ValidationGroups.aspx 二 X Defau 


| *Required feldl_Validate | 








asp:Text56cxs=tbdtSSN 


Need SSN _Validate | 


B Design | 口 Splt | 回 Source | 加 <asp:TextBox#txtSSN> 四 
图 33-22 ”这 些 Panel 对 象 会 独立 配置 它们 的 输入 区 域 


为 了 确保 这 些 验 证 程序 独立 工作 , 只 需要 使 用 ValidationGroup 属 性 为 每 一 个 验证 程序 和 要 验证 的 
控件 设置 唯一 的 分 组 名 。 下 面 是 可 能 的 标记 ( 注意 ， 这 里 用 的 Click 事 件 在 代码 文件 中 是 空 的 ， 它 们 
只 是 用 来 允许 在 Web 服 务 器 上 产生 回 发 ): 

<form id="form1i" runat="server"> 


<asp:Panel ID="Panel1" runat="server" Height="83px" Width="296px"> 
<asp:TextBox ID="txtRequiredData" runat="server" 
ValidationGroup="FirstGroup"> 

</asp:TextBox> 

<asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" 
ErrorMessage="*Required field!" ControlToValidate="txtRequiredData" 
ValidationGroup="FirstGroup"> 

</asp:RequiredFieldValidator> 

<asp:Button ID="bntValidateRequired" runat="server" 
OnClick="bntValidateRequired Click" 
Text="Validate" ValidationGroup="FirstGroup" /> 
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</asp:Panel> 


«asp:Panel ID="Panel2" runat="server" Height="119px" Width="295px"> 
<asp:TextBox ID="txtSSN" runat="server" 
ValidationGroup="SecondGroup"> 
</asp:Text8ox> 
<asp:RegularExpressionValidator ID="RegularExpressionValidator1" 
runat="server" ControlToValidate="txtSSN" 
ErrorMessage="*Need SSN" ValidationExpression="\d{3}-\d{2}-\d{4}" 
ValidationGroup="SecondGroup"> 
</asp:RegularExpressionValidator>&nbsp; 
<asp:Button ID="btnValidateSSN" runat="server" 
OnClick="btnValidateSSsN Click” Text="Validate" 
ValidationGroup="SecondGroup”/> 
</asp:Panel> 


</form> 
现在 ， 右 击 页 面 设计 器 ， 然 后 选择 View In Browser 菜 单项 ， 验 证 每 一 个 面板 组 件 是 否 以 独立 的 方 
式 进行 工作 。 


源 代码 ” ValidatorCtrls 网 站 的 源 代码 位 于 Chapter 33 子 目录 下 。 


33.6 ”使 用 主题 


至 此 , 我 们 已 经 使 用 了 许多 ASPNET Web 控 件 。 你 已 经 看 到 了 , 每 一 个 控件 都 公开 了 一 组 属性 (很 
多 都 是 从 System.Web.UI.WebControls.WebControl 继 承 而 来 )， 用 来 让 我 们 创建 某 个 UI 外 观 (背景 色 、 
文字 大 小 、 边 框 样式 等 )。 当 然 ， 在 多 页 面 的 网 站 中 ， 网 站 整体 为 各 种 类 型 的 控件 定义 公共 的 外 观 是 
很 正常 的 。 例如， 所 有 的 TextBox 都 可 能 被 配置 为 支持 某 个 字体 ， 所 有 Button 都 有 自 定义 的 图 像 ， 所 有 
Calendar 都 有 浅 蓝 色 的 边框 。 

很 明显 ， 为 网 站 每 一 个 页 面 的 每 一 个 部 件 创 建 相 同 的 属性 的 劳动 强度 很 大 ， 而 且 可 能 出 错 。 即 使 
手动 为 每 个 页 面 上 的 每 一 个 UI 组 件 更 新 属性 ， 想 象 一 下 为 每 一 个 TextBox 改 变 背 景 颜色 是 多 么 痛苦 啊 。 
显然 ， 肯定 有 更 好 的 方式 来 应 用 网 站 级 别 的 UI 设置 。 

一 种 可 以 用 来 简化 应 用 公共 UI 外 观 的 方式 就 是 定义 样式 表 。 如 果 你 有 Web 开 发 背景 ， 就 知道 样式 
表 定 义 的 一 组 UI 相关 的 设置 是 应 用 在 浏览 器 上 的 。 就 像 你 期 望 的 那样 ， 可 以 通过 设置 Cssstyle 属 性 来 
为 ASP.NET Web 控 件 设置 样式 。 

然而 ，ASPNET 还 提供 了 另外 一 种 叫做 主题 的 技术 来 定义 公共 的 UI。 和 样式 表 不 同 ， 主 题 应 用 在 
Web 服 务 器 上 ( 而 不 是 浏览 器 )， 并 且 可 以 以 编程 或 声明 方式 实现 。 由 于 主题 应 用 在 Web 服 务 器 上 ， 所 
以 它 可 以 访问 网 站 上 所 有 服务 器 端的 资源 。 此 外 ， 通 过 编写 在 任何 *.aspx 文 件 中 能 找到 的 相同 标记 来 
定义 主题 ( 你 可 能 也 会 同意 ， 样 式 表 的 语法 更 简洁 )。 

回忆 一 下 第 32 章 ，ASPNET Web 应 用 程序 可 以 定义 许多 “特殊 的 ” 子 目 录 ， 其 中 一 个 就 是 
App_Theme。 这 个 子 目 录 可 以 再 分 成 其 他 子 目录 , 每 一 个 都 表示 网 站 上 可 能 的 主题 。 例 如 ， 如 图 33-23 
所 示 ， 它 显示 了 一 个 包含 3 个 子 目录 的 App_Theme 文 件 夹 ， 每 一 个 都 是 构成 主题 的 一 组 文件 。 


33.6 使 用 主题 1153 


Holiday_Theme Dramatic_Theme 


~ Holiday.skin Premadonna.skin SimpleCtris.skin 
~ Holidaylmages.xml ,TheScream.tif GridViewData.skin 
Snow.tif | CompanyLogo.tif 





图 33-23 一 个 App_Theme 文 件 夹 可 能 定义 许多 主题 


33.6.1 *.skin 文 件 


每 一 个 主题 子 目 录 都 必 有 的 文件 就 是 *.skin 文 件 。 这 些 文件 定义 了 各 种 Web 控 件 的 外 观 。 为 了 举例 
说 明 ， 新 建 一 个 Empty Web Site， 命 名 为 FunWithThemes， 然 后 插入 一 个 名 为 Default.aspx 的 Web Form。 
在 这 个 页 面 中 ， 添 加 Calendar 、TextBox 和 Button 控 件 。 对 于 这 些 控件 ， 我 们 不 需要 特别 的 配置 ， 而 且 
它们 的 名 称 也 与 当前 示例 无 关 。 这 些 控 件 将 作为 我 们 自 定义 皮肤 的 对 象 。 

然后 ， 插 入 一 个 新 的 *.skin 文 件 BasicGreen.skin ( 使 用 WebSite 一 Add New Item 菜 单项 )， 如 图 33-24 
所 示 。 


Search Instalied Termplates 


“Type: Visual CO# 
A file used to define an ASP.NET theme 


了 Silverlight Application Visual C# 


Silverlight-enabled WCF ServiceVisual C# 


Site Map Wisual C# 


SQL Server Compact 40 Lowar 


SQL Server Database 





| place code in separate file 
| Select master page 


图 33-24 ”插入 *.skin 文 件 
Visual Studio 会 提示 你 确认 这 个 文件 是 否 可 以 加 到 App_Theme 文 件 夹 ( 其 实 我 们 就 希望 这 么 做 )。 
如 果 我 们 现在 查看 Solution Explorer， 确 实 会 发 现 App_Theme 文 件 夹 中 的 BasicGreen 子 文件 夹 包 含 了 新 
的 BasicGreen.skin 文 件 。 
回忆 一 下 ,*#.skin 文 件 是 我 们 使 用 ASPNET 控 件 声明 语法 定义 各 种 组 件 外 观 的 地 方 。 可 惜 的 是 , IDE 
没有 为 *.skin 文 件 提 供 设计 器 支持 。 一 个 减少 输入 时 间 的 方法 就 是 将 一 个 临时 的 *.aspx 文 件 插入 到 程序 
中 (如 temp.aspx )， 它 可 以 用 来 通过 Visual Studio 页 面 设计 器 构建 组 件 的 UI 控 件 。 
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最 后 的 标记 可 以 复制 并 粘贴 到 *.skin 文 件 中 。 然 而 ， 此 后 我 们 必须 删除 每 一 个 web 控件 的 ID 特性 。 
这 是 有 意义 的 ， 因 为 我 们 不 是 想 为 某 个 Button ( 例如 ) 而 是 想 为 所 有 Button 定 义 UI 外 观 。 
下 面 是 BasicGreen.skin 的 标记 ， 它 为 Button、TextBox 和 Calendar 类 型 定义 了 默认 的 外 观 : 


<asp:Button runat="server" BackColor="#80FF80"/> 
<asp:TextBox runat="server" BackColor="#80FF80"/> 
<asp:Calendar runat="server" BackColor="#80FF80"/> 


注意 ， 每 一 个 控件 仍然 有 runat="server" 属 性 (强制 的 )， 并 且 任 何 组 件 都 没有 ID 特性 。 

现在 ， 让 我 们 定义 第 二 个 主题 CrazyOrange。 使 用 解决 方案 资源 管理 器 , 右 击 App_Themes 文 件 夹 ， 
并 且 新 增 一 个 CrazyOrange 主 题 。 这 会 在 网 站 的 App_Theme 文 件 夹 中 新 增 一 个 子 目 录 。 

然后 , 在 Solution Explorer 中 右 击 新 的 CrazyOrange 文 件 夹 并 且 选 择 Add New 项 。 从 结果 对 话 框 中 新 
增 *.skin 文 件 。 更 新 CrazyOrange.skin 文 件 来 为 相同 的 Web 控 件 定 义 独特 的 UI 外 观 。 例 如 : 


<asp:Button runat="server" BackColor="#FF8000"/> 
<asp:TextBox runat="server" BackColor="#FF8000"/> 
<asp:Calendar BackColor="White" BorderColor="Black" 
BorderStyle="Solid" CellSpacing="1" 
Font-Names="Verdana" Font-Size="9pt" ForeColor="Black" Height="250px" 
NextPrevFormat="ShortMonth" Width="330px" runat="server"> 
<SelectedDayStyle BackColor="#333399" ForeColor="White" /> 
<OtherMonthDayStyle ForeColor="#999999" /> 
<TodayDayStyle BackColor="#999999" ForeColor="White" /> 
<DayStyle BackColor="#CCCCCC" /> 
<NextPrevStyle Font-Bold="True" Font-Size="8pt" ForeColor="White" /> 
<DayHeaderStyle Font-Bold="True" Font-Size="8pt" 
ForeColor="#333333" Height="8pt" /> 
<TitleStyle BackColor="#333399" BorderStyle="Solid" 
Font-Bold="True" Font-Size="12pt" 
ForeColor="White" Height="12pt" /> 
</asp:Calendar> 


至 此 ， 我 们 的 Solution Explorer 和 窗口 如 图 33-25 所 示 。 


2 SOLUTION EXPLORER :和 让 x 
全 说 2m|Ir|Nm|PD| 

Search Solution Explorer (Ctrls+;} 也- 
图 Solution 'FunWithThemes' (1 project) 


4 1) App Themes 
4 wh BasicGreen 
只 BasicGreen.skin 
4 Wm CrazyOrange 
DH CrazyOrange.skin 
bp @ Default.aspx 
但 Web.config 





SOLUTION EXPLORER TEAM EXPLORER 
图 33-25 一 个 具有 多 个 主题 的 网 站 


既然 我 们 的 网 站 定义 了 一 些 主题 ， 下 一 步 就 是 如 何 把 它们 应 用 到 页 面 上 。 你 可 能 会 想到 ， 这 有 很 
多 方式 。 


33.6 使 用 主题 1155 


说 明 ”可 以 肯定 的 是 ， 这 些 示例 主题 很 一 般 ( 为 了 减 小 篇 幅 )， 尽 管 按 照 你 喜欢 的 去 调整 吧 。 


33.6.2 ”应 用 网 站 级 别 的 主题 


如 果 你 希望 确保 网 站 的 所 有 页 面 都 遵循 相同 的 主题 ， 最 简单 的 方式 就 是 更 新 web.config 文 件 。 打 
开 当 前 的 web.config 文 件 并 且 找 到 <system.web> 根 元 素 中 的 <pages> 元 素 。 如 果 你 为 <cpages> 元 素 增加 了 
主题 特性 ， 它 就 会 确保 网 站 每 一 个 页 面 都 分 配 了 所 选 的 主题 ( 当然 ， 就 是 App_Theme 中 一 个 子 目录 的 
名 字 )。 下 面 是 关键 的 更 新 : 


<configuration> 
<system.web> 


<pages controlRenderingCompatibilityVersion="4.5" 
theme="BasicGreen"> 
</pages> 
</system.web> 
</configuration> 


如 果 运 行 该 页 面 ,将 会 发 现 每 个 组 件 都 有 BasicGreen 的 UTI 了。 如果 将 主题 特性 更 新 为 CrazyOrange 
并 且 再 次 运行 这 个 页 面 ， 就 会 发 现 使 用 的 是 由 这 个 主题 定义 的 UI。 


33.6.3 ”在 页 面 级 别 应 用 主题 


还 可 以 在 页 面 级 别 主题 ， 这 在 很 多 情况 下 都 很 有 用。 例如 ， 可 能 web.config 文 件 定义 了 网 站 级 别 
的 主题 (之 前 描述 的 ), 但 我 们 希望 为 某 个 页 面 分 配 不 同 的 主题 。 要 这 么 做 , 我 们 只 需要 更 新 <%@Page%> 
指令 。 如 果 使 用 Visual Studio 的 话 ， 就 会 发 现 智 能 感知 会 显示 App_Theme 文 件 夹 中 定义 的 每 一 个 主题 : 


<%@ Page Language="C#" AutoEventWireup="true" 
CodeFile="Default.aspx.cs" Inherits=" Default" Theme ="CrazyOrange" %> 


由 于 为 这 个 页 面 分 配 了 CrazyOrange 主 题 ， 而 web.config 文 件 指定 了 BasicGreen 主 题 ， 除 了 这 个 页 
面 之 外 的 所 有 页 面 都 会 使 用 BasicGreen 进 行 呈 现 。 


33.6.4 SkinID 属 性 


有 时 你 会 希望 为 一 个 组 件 定义 一 组 可 能 的 UI 外 观 。 例如 , 为 CrazyOrange 主 题 中 的 Button 类 型 定义 
两 个 可 能 的 UI。 这 时 你 可 以 使 用 *.skin 文 件 中 的 SkinID 属 性 分 别 设 置 每 一 个 的 外 观 ， 如 下 所 示 : 


<asp:Button runat="server" BackColor="#FF8000"/> 
<asp:Button runat="server" SkinID = "BigFontButton" 
Font-Size="30pt" BackColor="#FF8000"/> 


现在 , 如 果 有 一 个 页 面 使 用 CrazyOrange 主 题 , 每 一 个 Button 都 会 被 默认 赋值 为 未 命名 的 Button 皮 肤 。 
如 果 你 希望 *.aspx 文 件 中 各 种 按钮 都 使 用 BigFontButton 皮 肤 的 话 ， 只 需要 在 标记 中 指定 SkinID 属 性 ; 


<asp:Button ID="Button2" runat="server" 
SkinID="BigFontButton" Text="Button" /><br /> 
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33.6.5 ”以 编程 方式 分 配 主题 


最 后 ， 还 可 以 在 代码 中 分 配 主题 。 当 希望 提供 一 种 方式 让 最 终 用 户 为 当前 会 话 选择 主题 时 ， 这 很 
有 有 用。 当然, 我 们 还 没有 研究 如 何 构建 有 状态 的 Web 应 用 程序 , 因此 当前 主题 的 选择 会 在 回 发 后 丢失 。 
在 产品 级 别 的 网 站 中 ， 你 可 能 希望 把 用 户 当 前 的 主题 设置 保存 在 会 话 变量 中 或 持久 化 在 数据 库 中 。 

为 了 说 明 如 何以 编程 方式 分 配 主题 ， 我 们 使 用 3 个 新 的 Button 控 件 更 新 Default.aspx 文 件 的 UI， 如 
图 33-26 所 示 。 完 成 后 ， 为 每 一 个 Button 处 理 Click 事 件 。 
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图 33-26 ”主题 示例 更 新 后 的 UI 


现在 你 只 可 以 在 页 面 生命 周期 的 某 个 阶段 以 编程 方式 分 配 主 题 。 这 通常 在 Page_PreInit 事 件 中 完 
成 ， 按 如 下 所 示 更 新 我 们 的 代码 文件 : 


partial class Default : System.Web.UI.Page 


protected void btnNoTheme Click(object sender, System.EventArgs e) 
{ é 
// 空 的 字符 事 导 致 不 应 用 主题 


Session["UserTheme"] = ""; 
// 再 一 次 触发 PreInit 事 件 
Server.Transfer(Request.FilePath); 
protected void btnGreenTheme Click(object sender, System.EventArgs e) 
Session["UserTheme"] = "BasicGreen"; 
// 再 一 次 触发 PreInit 事 件 


Server.Transfer(Request.Filepath); 


} 
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protected void btnOrangeTheme Click(object sender, System.EventArgs e) 
Session["UserTheme"] = "CrazyOrange"; 


// 再 一 次 触发 PreInit 事 件 
Server.Transfer(Request.FilePath); 


} 


protected void Page PreInit(object sender, System.EventArgs e) 
try 
Theme = Session["UserTheme"].ToString(); 
catch 


Theme = ""; 


} 
} 


注意 , 我 们 把 所 选 的 主题 保存 在 了 叫 UserTheme 的 会 话 变量 中 (参见 第 34 章 ), 它 在 Page_PreInit() 
事件 处 理 程序 中 被 正式 赋值 。 还 要 注意 ， 当 用 户 单 击 某 个 按钮 时 ， 我 们 以 编程 方式 通过 调用 
Server.Transfer() 再 次 请 求 当 前 页 面 来 强制 触发 PreInit 事 件 。 如 果 你 运行 这 个 页 面 ， 就 会 发 现 我 们 
可 以 通过 各 种 Button 单 击 来 创建 主题 。 


源 代 码 ”FunWithThemes 网 站 的 源 代码 位 于 Chapter 33 子 目录 下 。 


33.7 ”小结 


本 章 研究 了 如 何 使 用 各 种 ASPNET Web 控 件 。 我 们 首先 研究 了 Control 和 WebControl 基 类 的 作用 ， 
然后 研究 了 如 何 与 面板 的 内 部 控件 集合 动态 交互 。 随 后 我 们 又 研究 了 新 的 网 站 导航 模型 (*#.sitemap 文 
件 和 SiteMapDataSource 组 件 )、 新 的 数据 绑 定 引擎 ( 通过 SqlDataSource 组 件 和 Gridview 控 件 ) 和 各 种 验 
证 控件 。 

本 章 的 后 半 部 分 研究 了 母 版 页 和 主题 的 作用 。 回 忆 一 下 ， 母 版 页 可 以 为 网 站 的 一 组 页 面 定义 公 
共 的 框架 。*#.master 文 件 定义 了 许多 内 容 占 位 符 来 让 内 容 页 插入 它们 的 自 定 义 UI 内 容 。 最 后 ， 我 们 
了 解 到 ， 通 过 ASPNET 主 题 引 擎 ， 可 以 以 声明 方式 或 编程 方式 在 Web 服 务 器 端 为 组 件 应 用 公共 的 UI 
外 观 。 
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一 人 两 章 主 要 讨论 ASPNET 页 面 的 构成 和 行为 ， 以 及 它们 所 包含 的 控件 。 本 章 在 此 基础 上 学 习 

月 | Global.asax 文 件 和 HttpApplication 类 型 的 作用 。HttpApplication 支 持 处 理 大 量 的 事件 ， 而 
事件 则 将 Web 应 用 程序 连接 成 一 个 内 聚 单元 ， 使 其 不 再 是 一 堆 彼此 独立 由 母 版 页 驱动 的 *.aspx 文 件 。 

除了 探讨 HttpApplication 类 型 之 外 ， 本 章 也 将 讨论 非常 重要 的 状态 管理 话题 ， 如 视图 状态 、 会 话 
级 变量 和 应 用 程序 级 变量 ( 包括 应 用 程序 缓存 )、cookie 数 据 和 ASP.NET 用 户 配置 API 的 作用 。 


34.1 状态 问题 


第 32 章 的 开始 指出 了 HTTP 是 一 个 无 状态 的 联网 协议 。 这 个 事实 使 Web 开 发 与 构建 一 个 可 执行 程序 
集 的 过 程 截然 不 同 。 例 如 ， 在 创建 Windows 桌 面 UI 应 用 程序 时 ， 你 能 确定 任何 定义 在 Form 派 生 类 中 的 
成 员 变量 通常 将 存在 于 内 存 中 ， 直 到 用 户 显 式 地 关闭 可 执行 程序 : 


public partial class MainWindow : Window 


// 状态 数据 


private string userFavoriteCar = "Yugo"; 


然而 ， 在 万 维 网 领域 中 ， 不 允许 提供 同样 奢侈 的 假设 。 为 了 证 明 这 一 点 , 创建 一 个 新 的 空 网 站 项 
目 (命名 为 SimpleStateExample ) 并 且 插 和 人 一 个 新 的 Web 表 单 。 在 *.aspx 文 件 的 代码 隐藏 文件 中 ， 定 义 
一 个 名 为 userFavoriteCar 的 页 面 级 字符 串 变量 ， 如 下 所 示 : 

public partial class Default : System.Web.UI.Page 


// 状态 数据 


private string userFavoriteCar = "Yugo"; 
protected void Page Load(object sender, EventArgs e) 


1 
} 


接 下 来 ， 构 造 如 图 34-1 显 示 的 简单 Web UI。 
服务 器 端 用 于 Set 按 钮 ( 名 为 btnsetCar ) 的 Click 事 件 处 理 程序 将 允许 用 户 使 用 TextBox 内 的 值 (名 
为 txtFavCar ) 分 配 字 符 串 变量 : 


protected void btnGetCar Click(object sender, EventArgs e) 
{ 
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// 在 成 员 变 量 中 存储 用 户 最 喜欢 的 车 


userFavoriteCar = txtFavCar.Text; 
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图 34-1 简单 状态 页 的 UI 


而 用 于 Get 按 钮 (btnGetCar ) 的 Click 事 件 处 理 程序 将 展示 页 面 Label 部 件 (lblFavCar ) 内 的 成 员 变 
量 的 当前 值 ， 如 下 所 示 : 


protected void btnGetCar Click(object sender, EventArgs e) 
{ 


// 显示 成 员 变 量 的 值 


lblFavCar.Text = userFavoriteCar; 


现在 ， 如 果 你 正在 构建 一 个 Windows GUI 应 用 程序 ， 可 以 假设 一 旦 用 户 设置 了 初始 值 ， 它 将 在 桌 
面 应 用 程序 的 生命 期 中 被 保存 。 遗 憾 的 是 ， 当 运行 这 个 Web 应 用 程序 时 ， 你 将 发 现 ， 每 次 回 传 到 Web 
服务 器 ( 通过 单 击 任何 按钮 ), userFavoriteCar 字 符 串 变量 的 值 都 被 设置 回 初始 值 “Yugo”, 因此 , Label 
文本 总 是 固定 值 。 

由 于 发 送 HTTP 响 应 时 ，HTTP 无 法 自动 保存 数据 ， 这 就 是 Page 对 象 被 立即 销毁 的 原因 。 因 此 ， 当 
客户 端 回 传 到 *.aspx 文 件 时 ， 一 个 新 的 Page 对 象 即 被 建立 ， 它 将 重 置 任何 页 面 级 的 成 员 变 量 。 这 无 疑 
是 一 个 进退 两 难 的 问题 。 想 象 一 下 ， 如 果 在 线 购物 时 每 次 都 要 回 传 到 Web 服 务 器 端 ， 并 且 先 前 输入 的 
(例如 你 想 要 购买 的 项 目 ) 任何 一 个 或 者 所 有 的 信息 都 丢失 的 话 ， 将 是 多 么 痛苦 。 当 希望 保存 登录 到 
站 点 的 用 户 信息 时 ， 你 需要 利用 各 种 状态 管理 技术 。 


说 明 不 只 是 ASPNET 要 面 对 这 个 问题 ，JavaWeb 应 用 程序 、CGI 应 用 、 传 统 ASP 和 PHP 应 用 程序 都 必 
须 面 对 状态 管理 这 个 令 人 痛苦 的 问题 。 


为 了 在 两 次 回 传 之 间 保 存 userFavoriteCar 字 符 串 类 型 的 值 , 需要 在 会 话 变量 内 存储 这 个 字符 串 类 
型 的 值 。 在 后 面 我 们 会 去 了 解 会 话 状态 的 确切 细节 。 为 了 完成 这 个 过 程 ， 下 面 提供 了 当前 页 必需 的 更 
新 代码 ( 注意， 这 里 不 再 使 用 私有 字符 串 成 员 变量 ， 因 此 可 以 随意 注释 掉 或 删除 前 面 定 义 的 字符 串 
变量 ): 
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public partial class Default : System.Web.UI.Page 


// 状态 数据 
// 私有 字符 囊 userFavoriteCar 值 为 “Yugo” 


protected void Page Load(object sender, EventArgs e) 


} 
protected void btnSetCar Click(object sender, EventArgs e) 


{ 
// 保存 将 要 存储 在 会 话 变量 中 的 值 


Session["UserFavCar"] = txtFavCar.Text; 


protected void btnGetCar Click(object sender, EventArgs e) 


{ 
// 获取 会 话 变量 值 


lblFavCar.Text = (string)Session["UserFavCar"]; 


lj 
} 


如 果 现 在 运行 这 个 应 用 程序 ， 你 最 喜欢 的 汽车 的 值 将 在 各 次 回 传 中 被 保存 起 来 ， 这 要 归功 于 
HttpSessionState 对 象 , 它 巧 妙 利用 了 继承 的 session 属性 。 会 话 数据 ( 本 章 后 面 将 详细 介绍 ) 只 是 “ 记 
住 ”网 站 信息 的 一 种 方式 。 在 下 面 几 节 中 ， 我 将 介绍 ASPNET 支 持 的 几 种 主要 方式 。 


源 代码 ”SimpleStateExample 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 


34.2 ASP.NET 状态 管理 技术 


ASPNET 提 供 了 几 个 可 以 用 来 在 Web 应 用 程序 中 维持 状态 信息 的 机 制 。 确 切 地 说 ， 你 有 如 下 几 个 
选项 : 

口 利用 ASPNET 视 图 状态 ; 

口 利用 ASPNET 控 件 状态 ; 

口 定义 应 用 程序 级 变量 ; 

口 利用 缓存 对 象 ; 

口 定义 会 话 级 变量 ; 

口 定义 cookie 数 据 。 

除了 这 些 技术 之 外 ，ASPNET 还 提供 了 现成 的 用 户 配置 API 来 以 永久 的 方式 保存 用 户 数据 。 我 们 
会 依次 研究 每 一 个 方式 ， 首 先 从 ASPNET 视 图 状态 开始 。 


34.3 ASP.NET 视图 状态 的 作用 


此 前 术语 视图 状态 ( view state ) 已 经 使 用 了 多 次 ， 但 并 未 正式 定义 ， 所 以 这 里 我 们 来 揭 开 这 个 术 
语 的 神秘 面纱 。 如 果 没 有 框架 的 支持 , 在 构建 即将 输出 的 HTTP 响 应 时 ，Web 开 发 者 需要 手动 为 传 入 的 
窗 体 部 件 重 新 填充 值 。 
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在 ASPNET 下 ， 我 们 不 再 需要 手动 删除 和 重新 填充 位 于 HTML 部 件 内 的 值 ， 因 为 ASPNET 运 行 时 
将 自动 嵌入 一 个 隐藏 的 表单 字段 ( 名 为 _VIEWSTATE )， 其 范围 是 浏览 器 和 一 个 指定 的 页 面 之 间 。 分 配 
到 这 个 字段 的 数据 是 一 个 64 位 编码 的 字符 串 ， 它 包括 一 个 描述 当前 页 面 上 每 个 GUI 部 件 值 的 名 称 / 值 
对 集 。 

System.Web.UI.Page 基 类 的 Init 事 件 处 理 程序 是 一 个 实体 ， 它 负责 读 取 在 _VIEWSTATE 字 段 内 发 现 
的 传 入 值 ， 以 在 派生 类 中 填充 适当 的 成 员 变 量 。( 这 就 是 为 什么 在 一 个 页 面 的 Init 事 件 处 理 程序 的 作 
用 域内 访问 Web 部 件 的 状态 最 冒险 。) 

同时 ， 恰 恰 在 输出 响应 被 提交 回 发 出 请 求 的 浏览 器 之 前 ，_VIEWSTATE 数 据 被 用 来 重新 填充 窗 体 部 
件 。 显 然 ， ASPNET 最 大 的 优点 就 是 不 需要 任何 用 户 参 与 。 当 然 ， 如 果 愿 意 的 话 ， 用 户 总 是 能 够 与 默 
认 功 能 交互 ， 以 及 改变 或 者 禁用 默认 功能 。 为 了 理解 如 何 实现 这 些 ， 我 们 来 看 一 下 具体 的 视图 状态 
示例 。 


34.3.1 演示 视图 状态 


首先 ,创建 一 个 新 的 空 网 站 应 用 程序 ,名 为 ViewStateApp 并 插入 一 个 新 的 Web 窗 体 。 在 初始 的 *.aspx 
页 面 上 添加 一 个 ASPNET ListBox Web 控 件 myListBox 和 一 个 Button 类 型 控件 btnPostback。 

现在 ， 使 用 Visual Studio Properties 窗 口 ， 访 问 Items 属 性 ， 并 通过 相关 的 对 话 框 向 ListBox 添 加 4 个 
ListItem。 结 果 将 为 如 下 形式 : 


<asp:ListBox ID="myListBox" runat="server"> 
<asp:ListItem>Item One</asp:ListItem> 
《asp:ListItem>Item Two</asp:ListItem> 
<asp:ListItem>Item Three</asp:ListItem> 
<asp:ListItem>Item Four</asp:ListItem> 
</asp:ListBox> 


注意 ， 你 是 在 *.aspx 文 件 中 直接 硬 编码 了 ListBox 内 的 项 。 你 已 经 知道 ， 所 有 在 ASPNET Web Form 
内 的 <asp:> 定 义 将 在 最 后 的 HTTP 响 应 前 自动 提交 回 它们 的 HTML 代 码 (假如 它们 有 runat="server" 
特性 )。 

<%@page%> 指 令 有 一 个 可 选 的 特性 , 名 为 Enableviewstate, 它 在 默认 时 设置 为 true。 要 禁用 这 个 行 
为 ， 只 需 更 新 <%@Page%> 指 令 即 可 ， 如 下 所 示 : 


‘<%@ Page Language="C#" AutoEventWireup=" ‘true" 
CodeFile="Default.aspx.cs" Inherits=" Default" 
EnableViewState ="false" %> 


那么 禁用 状态 视图 的 确切 意义 是 什么 呢 ? 这 要 看 情况 。 考 虑 先前 术语 的 定义 ， 你 可 能 会 认为 ， 如 
果 禁 用 *.aspx 文 件 的 视图 状态 ， 那 么 在 到 Web 服 务 器 的 各 次 回 传 间 ，ListBox 内 的 值 将 不 再 被 保存 。 然 
而 ， 如 果 要 照 现 在 这 个 样子 运行 这 个 应 用 程序 ， 你 也 许 会 惊讶 地 发 现 ， 无 论 你 回 传 到 页 面 多 少 次 ， 
ListBox 内 的 信息 都 被 保留 了 。 

事实 上 ， 如 果 检 查 返 回 到 浏览 器 的 源 HTML (通过 右 击 浏览 器 中 的 页 面 并 选择 View Source )， 你 
也 许 更 惊讶 地 看 到 隐藏 的 _VIEWSTATE 字 段 仍然 存在 : 


<input type=" "hidden" name=" VIEWSTATE" id=" VIEWSTATE" 
value="/wEPDwUKLTMAMTM2MDMANGRkqGC6gjEV25jnddkJiRmoIc10SIA=" /> 
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但 这 里 假设 ListBox 被 动态 填充 在 代码 隐藏 文件 内 ， 而 不 是 HTML <form> 定 义 内 。 首 先 ， 从 当前 的 
*.aspx 文 件 中 移 除 casp:ListItem> 声 明 ， 如 下 所 示 : 


<asp:ListBox ID="myListBox" runat="server"> 
</asp:ListBox> 


接着 ,填写 代码 隐藏 文件 中 Load 事 件 处 理 程序 内 的 ListBox 项 : 


protected void Page Load(object sender, EventArgs e) 
if (!IsPostBack) 


// 动态 填写 ListBox 
myListBox.Items.Add("Item One"); 
myListBox.Items.Add("Item Two"); 
myListBox.Items.Add("Item Three"); 
myListBox.Items.Add("Item Four"); 
} 
} 


如 果 展 示 这 个 被 更 新 的 页 面 ,你 将 发 现 , 浏览 器 第 一 次 请 求 页 面 时 ，ListBox 内 的 值 是 存在 的 , 并 且 
是 被 占用 的 。 然 而 ， 在 回 传 后 ，ListBox 内 的 值 却 突然 没有 了 。ASPNET 视 图 状态 的 第 一 个 规则 是 ， 只 有 
在 你 拥有 其 值 是 通过 代码 动态 生成 的 部 件 时 , 才能 实现 视图 状态 效果 。 如 果 在 *.aspx 文 件 的 <form> 标 签 内 
硬 编码 值 ， 这 些 项 的 状态 总 是 通过 回 传 被 保存 ( 即使 当 为 给 定 页 面 设置 EnableViewState 为 false 时 )。 

如 果 禁 用 全 部 的 *.aspx 文 件 的 视图 状态 看 起 来 有 点 太 激 进 的 话 ， 回 想 一 下 ， 每 个 System.Web.UI. 
Control 基 类 的 派生 类 都 继承 了 EnableViewstate 属 性 ， 这 个 属性 使 得 一 个 控件 接 一 个 控件 地 禁用 视图 
状态 非常 容易 : 


<asp:GridView id="myHugeDynamicallyFilledGridofData" runat="server" 
EnableViewState="false"> 
</asp:GridView> 


说 明 从 .NET 4.0 开 始 ， 较 大 的 视图 状态 数据 将 自动 被 压缩 ， 以 减少 该 隐藏 表单 字段 的 大 小 。 


34.3.2 ”添加 自 定义 视图 状态 数据 


除了 EnableViewSstate 属 性 外 ，System.Web.UI.Control 基 类 也 提供 了 一 个 名 为 Viewstate 的 继承 属 
性 。 实 际 上 ， 这 个 属性 提供 了 对 System.Web.UI.StateBag 类 型 的 访问 ， 该 类 型 描述 了 _VIEWSTATE 字 段 
内 的 所 有 数据 。 使 用 StateBag 类 型 的 索引 器 , 能 够 使 用 一 套 名 称 / 值 对 在 隐藏 的 _VIEWSTATE 表 单字 段 内 
嵌入 自 定义 信息 。 下 面 是 一 个 简单 的 例子 : 


protected void btnAddToVS Click(object sender, EventArgs e) 


ViewState["CustomViewStateItem"] = "Some user data"; 
lblVSValue.Text = (string)ViewState["CustomViewStateItem"]; 
} 


因为 System.Web.UI.StateBag 类 型 被 设计 用 于 操作 System.0bject 类 型 的 值 ,所 以 当 希 望 访问 一 个 给 
定 键 值 时 ， 你 需要 显 式 地 把 它 转 换 为 正确 的 数据 类 型 ( 在 这 个 例子 中 是 System.String )。 然 而 要 注意 
的 是 ， 被 放置 在 _VIEWSTATE 字 段 内 的 值 不 能 是 任何 字面 上 的 对 象 。 要 特别 注意 的 是 ， 有 效 的 类 型 只 
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有 String、Integer、Boolean、ArrayList 、HashTable 或 者 这 些 类 型 的 一 个 数组 。 

所 以 ， 由 于 *.aspx 能 够 向 _VIEWSTATE 字 符 串 搬入 一 些 自 定义 信息 ， 所 以 下 一 步 就 是 搞 清 楚 什 么 
时 候 需要 这 么 做 。 大 多 数 情况 下 ， 自 定义 视图 状态 数据 对 有 特定 需要 的 用 户 最 适合 。 例 如 ， 你 可 以 
建立 视图 状态 数据 ， 它 指定 用 户 希 望 显示 GridView ( 例如 一 个 分 类 订单 ) 的 UI 方式 。 视 图 状态 数据 
并 不 太 适 用 于 保存 完整 的 用 户 数据 , 例如 购物 车 中 的 项 目 或 缓存 的 Dataset。 当 你 需要 存储 这 个 综合 
言 息 的 类 别 时 ， 必 须 使 用 会 话 数据 或 应 用 程序 数据 。 在 介绍 它们 之 前 ， 你 需要 理解 Global.aspx 文 件 
的 作用 。 


vo orto 
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到 目前 为 止 , ASP.NET 应 用 程序 可 能 看 起 来 还 是 一 堆 *.aspx 文 件 和 它们 各 自 的 Web 控 件 。 虽然 能 够 
通过 简单 地 链接 一 套 相 关 的 网 页 建立 一 个 Web 应 用 程序 ， 但 你 可 能 更 倾向 于 与 作为 整体 的 Web 应 用 程 
序 交互 。 为 此 ，ASPNET 应 用 程序 会 通过 Web Site 一 Add New Item 菜 单项 选择 包含 一 个 可 选 的 
Global.asax 文 件 ， 如 图 34-2 所 示 ( 注意 ， 你 选择 的 是 Global Application Class 图 标 )。 
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图 34-2 ”Globalasax 文 件 
简单 地 说 ，Global.asax 与 我 们 在 ASPNET 中 能 够 获得 的 传统 的 、 可 双击 的 *.exe 很 相近 ， 这 意味 着 
这 种 类 型 表示 站 点 自身 的 运行 时 行为 。 一 旦 将 Globalasax 文 件 插入 到 Web 项 目 中 ， 你 将 注意 到 它 与 一 
个 包含 一 套 事 件 处 理 程序 的 <script> 块 差不多 ， 如 下 所 示 : 
<%@ Application Language="C#" %> 


<script runat="server"> 
void Application Start(object sender, EventArgs e) 
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void Application End(object sender, EventArgs e) 


{ 
1 // 运行 应 用 程序 关闭 的 代码 


void Application Error(object sender, EventArgs e) 


{ 
} // 当 一 个 未 处 理 过 的 错误 发 生 时 运行 的 代码 


void Session Start(object sender, EventArgs e) 
// 当 一 个 新 的 会 话 被 启动 时 运行 的 代码 

void Session End(object sender, EventArgs e) 

1/ 六 和 滴 二 来 的 时 秉 迁 生 的 人 


// 说 明 : 只 有 当 web.config 文 件 中 的 sessionstate 模 式 设置 为 InProc 的 时 候 ， 
// Session_End 事 件 才 会 触发 。 如 果 会 话 模式 设置 为 StateServer 或 5QLServer， 事 件 就 不 会 触发 


</script> 

然而 ， 外 表 是 具有 欺骗 性 的 。 在 运行 时 ，<script> 块 内 的 代码 被 装载 进 一 个 派生 自 System.Web 
HttpApplication 的 类 类 型 。 因 此 ， 在 任何 这 些 事 件 处 理 程序 中 ， 你 都 可 以 通过 this 或 base 关 键 字 访问 
父 类 成 员 。 

前 面 提 到 过 ， 定 义 在 Global.asax 内 的 成 员 是 事件 处 理 程序 ， 这 些 事件 处 理 程序 允许 你 与 应 用 程序 
级 ( 以 及 会 话 级 ) 事件 交互 。 表 34-1 列 出 了 每 个 成 员 的 作用 。 


表 34-1 System.Web 命 名 空间 的 核心 类 型 


事件 处 理 程序 作 用 

Application Start() 该 事件 处 理 程序 在 Web 应 用 程序 被 启动 后 立刻 被 调用 。 因此, 该 事件 在 一 个 Web 
应 用 程序 的 整个 生命 周期 内 仅仅 触发 一 次 。 这 是 定义 Web 应 用 程序 全 程 所 用 到 
的 应 用 程序 级 数据 的 理想 位 置 

Application End() 该 事件 处 理 程序 在 应 用 程序 关闭 时 被 调用 。 这 会 在 最 后 一 个 用 户 超 时 或 者 通过 
IIS 手 动 关闭 了 应 用 程序 的 情况 下 出 现 

Session Start() 当 新 用 户 登录 到 你 的 应 用 程序 时 ， 该 事件 处 理 程序 会 触发 。 这 里 你 可 以 确定 回 
传 期 间 你 想 保存 的 特定 于 用 户 的 数据 点 

Session End() 当 用 户 的 会 话 已 经 终止 时 ,该 事件 处 理 程序 会 触发 (通常 情况 下 在 预定 义 超时 
时 发 生 ) 

Application Error() 这 是 一 个 全 局 错误 处 理 程序 ， 在 Web 应 用 程序 抛 出 一 个 未 经 处 理 的 异常 时 被 
调用 


34.4.1 全 局 最 后 异常 事件 处 理 程 序 


首先 ， 介 绍 Application_Error() 事 件 处 理 程序 的 作用 。 回 想 一 下 ， 特 定 的 页 面 可 以 处 理 Error 事 
件 ， 以 处 理 任 何 未 处 理 的 、 出 现在 页 面 自身 作用 域 的 异常 。 同 样 ，Application_Error() 事 件 处 理 程序 
是 处 理 未 被 指定 页 面 处 理 的 异常 的 最 后 关卡 。 对 于 页 面 级 Error 事 件 来 说 ， 你 能 够 使 用 继承 的 Server 
属性 访问 指定 的 System.Exception， 如 下 所 示 : 
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void Application Error(object sender, EventArgs e) 


// 获得 未 处 理 的 Error 
Exception ex = Server.GetLastError(); 


// 在 这 里 处 理 Error 


// 处 理 结束 后 消除 ErTor 
Server.ClearError(); 


由 于 Application_Error() 事 件 处 理 程序 是 Web 应 用 程序 处 理 异常 最 后 的 机 会 。 通 常 我 们 会 实现 这 
个 方法 ,把 用 户 重 定向 到 服务 器 上 预定 义 的 错误 页 面 。 这 个 方法 另外 一 个 常见 的 职责 可 能 会 包含 发 送 
电子 邮件 给 Web 管 理 员 或 写 一 个 外 部 错误 日 志 。 


34.4.2 ”HttpApplication 基 类 


上 文 已 经 提 及 Global.asax 脚 本 动态 地 生成 为 一 个 从 System.Web.HttpApplication 基 类 派生 的 类 , 这 
个 基 类 提供 与 System.Web.UI.Page 类 型 同样 的 功能 ( 用 户 界 面 不 可 见 )。 表 34-2 列 出 了 其 中 的 一 些 主要 
成 员 。 


表 34-2 System.Web.HttpApplication 类 型 定义 的 主要 成 员 


属 性 作 用 
Application 该 属性 允许 使 用 公开 的 HttpApplicationState 类 型 与 应 用 程序 级 变量 进行 交互 
Request 该 属性 允许 与 传人 的 HTTP 请 求 ( 通过 HttpRequest 底 层 对 象 ) 进行 交互 
Response 该 属性 允许 与 传人 的 HTTP 响 应 ( 通过 HttpResponse 底 层 对 象 ) 进行 交互 
Server 该 属性 对 当前 的 请 求 获取 内 在 的 服务 器 对 象 (通过 HttpServerUtility 底 层 对 象 ) 
Session 该 属性 允许 使 用 HttpSessionState 类 型 与 会 话 级 数据 进行 交互 


同样 , 虽然 Global.asax 文 件 没有 显 式 说 明 HttpApplication 是 底层 的 基 类 , 但 还 是 要 记 住 所 有 “is-a” 
关系 确实 适用 。 
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在 ASPNET 下 ， 应 用 程序 状态 由 HttpApplicationState 类 型 的 一 个 实例 维护 。 这 个 类 使 你 可 以 在 
所 有 登录 到 ASP.NET 应 用 程序 的 用 户 ( 和 所 有 页 面 ) 之 间 分 享 全 局 信息 。 不 仅 应 用 程序 数据 能 被 所 有 
站 点 上 的 用 户 分 享 ， 而 且 如 果 一 个 用 户 改变 了 一 个 应 用 程序 级 数据 点 的 值 ， 在 下 一 个 回 传 中 这 个 变化 
能 够 被 所 有 其 他 用 户 看 见 。 

男 一 方面 ， 会 话 状 态 用 来 为 一 个 指定 用 户 ( 例如 ， 购 物 车 中 的 项 ) 记忆 成 员 信息 。 用 户 的 会 话 状 
态 物 理 上 由 HttpSessionState 类 类 型 描述 。 当 一 个 新 用 户 登 录 到 一 个 ASPNET Web 应 用 程序 时 ， 运 行 
库 将 自动 分 配给 这 个 用 户 一 个 新 的 会 话 ID ， 默 认 状 态 下 ， 它 将 在 20 分 钟 静止 状态 之 后 超时 。 这 样 ， 如 
果 20 000 个 用 户 登 录 到 了 该 站 点 ， 你 就 拥有 20 000 个 不 同 的 HttpSessionState 对 象 ， 每 个 对 象 自动 分 配 
一 个 唯一 的 会 话 ID。Web 应 用 程序 和 Web 会 话 之 间 的 关系 如 图 34-3 所 示 。 
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34.5.1 维护 应 用 程序 级 的 状态 数据 


HttpApplicationState 类 型 允许 开发 人 员 在 一 个 ASPNET 应 用 程序 中 的 多 个 会 话 之 间 分 享 全 局 信 
息 。 表 34-3 描 述 了 这 个 类 型 的 一 些 核心 成 员 。 


表 34-3 HttpApplicationState 类 型 的 成 员 





成 ” 员 作 用 

Add() 该 方法 允许 为 HttpApplicationState 对 象 增加 一 个 新 的 名 称 / 值 对 。 注意 , 这 个 方法 通常 
不 方便 HttpApplicationState 类 的 索引 器 使 用 

Allkeys 该 属性 返回 string 对 象 的 一 个 数组 ， 该 string 对 象 表示 HttpApplicationState 类 型 里 的 
所 有 名 字 

Clear() 该 方法 删除 HttpApplicationstate 类 型 里 的 所 有 项 。 在 功能 上 这 相当 于 RemoveAl1() 方 法 

Count 该 属性 获取 HttpApplicationSstate 类 型 里 对 象 的 数目 

Lock() 和 Unlock() 这 两 个 方法 用 于 当 和 希望 以 线程 安全 的 方式 修改 一 套 应 用 程序 变量 时 

RemoveAl1() 、Remove() 和 这些 方 法 去 除 HttpApplicationSstate 对 象 内 一 个 特定 的 项 ( 通过 字符 串 名 字 )。 

RemoveAt () RemoveAt () 通 过 一 个 数值 索引 器 去 除 项 


为 了 演示 如 何 使 用 应 用 程序 状态 创建 一 个 新 的 空 网 站 项 目 AppState， 并 插入 一 个 新 的 Web 窗 体 。 
然后 插入 一 个 新 的 Global.asax 文 件 。 在 创建 可 以 被 所 有 用 户 共享 的 数据 成 员 时 ， 需 要 建立 一 套 名 称 / 
值 对 。 大 多 数 情况 下 ， 最 好 在 Global.asax.cs 中 的 Application_Start() 事 件 处 理 程序 内 建立 这 些 成 员 ， 
例如 : 

void Application Start(Object sender, EventArgs e) 

ee 


Application["SalesPersonOfTheMonth"] = "Chucky"; 
Application["CurrentCarOnSale"] = "Colt"; 
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Application["MostPopularColorOnLot"] = "Black"; 


在 Web 应 用 程序 的 生命 周期 内 ( 也 就 是 说 ， 直 到 Web 应 用 程序 被 手动 关闭 或 直到 最 后 一 个 用 户 超 
时 )， 如 果 需 要 的 话 ， 任 何 用 户 (在 任何 页 面 上 ) 都 可 以 访问 这 些 值 假设 你 拥有 一 个 页 面 ， 它 将 通 
过 一 个 按钮 的 Click 事 件 处 理 程序 展现 Label 内 当前 的 汽车 折扣 ， 如 下 所 示 : 


protected void btnShowCarOnSale Click(object sender, EventArgs arg) 


lblCurrCarOnSale.Text = string.Format("Sale on {0}'s today!", 
(string)Application["CurrentCarOnSale" ]); 


与 ViewState 属 性 类 似 ， 注 意 如 何必 须 将 HttpApplicationSstate 对 象 返回 的 值 转换 为 正确 的 底层 类 
型 ， 因 为 Application 属 性 在 一 般 的 System.0bject 类 型 上 操作 。 

现在 , 假设 Application 属 性 能 够 保存 任何 类 型 , 那么 显然 能 够 在 站 点 的 应 用 程序 状态 内 放置 自 定 
义 类 型 (或 任何 .NET 对 象 )。 假设 你 希望 使 用 一 个 名 为 CarLotInfo 的 强 类 型 对 象 来 维护 当前 的 3 个 应 用 
程序 变量 ， 如 下 所 示 : 


public class CarLotInfo 
public CarLotInfo(string s, string c, string m) 


salesPersonOfTheMonth = s; 
currentCarOnSale = c; 
mostPopularColorOnLot = mi 


public string SalesPerson0OfTheMonth { get; set; }; 

public string currentCarOnSale { get; set; }; 

public string mostPopularColorOnLot { get; set; }; 
J 


利用 这 个 辅助 类 ， 可 以 修改 Application_start() 事 件 处 理 程序 ， 如 下 所 示 : 


void Application Start(Object sender, EventArgs e) 
{ 


// 在 应 用 程序 数据 段 中 放置 一 个 自 定义 的 对 象 
Application["CarSiteInfo"] = 
new CarLotInfo("Chucky", "Colt", "Black"); 
} 


然后 在 一 个 Button 控 件 (btnShowAppVariables ) 的 服务 器 端 Click 事 件 处 理 程序 内 使 用 公开 字段 
数据 访问 信息 ， 如 下 所 示 : 


protected void btnShowAppVariables Click(object sender, EventArgs e) 


CarLotInfo appVars = 
((CarLotInfo)Application["CarSiteInfo"]); 

string appState = 
string.Format("<li>Car on sale: {0}</1i>", 
appVars.CurrentCarOnSale); 

appState += 
string.Format("<li>Most popular color: {0}</l1i>", 
appVars .MostPopularColorOnLot); 

appState += 
string.Format("<li>Big shot SalesPerson: {0}</1i>", 
appVars.SalesPersonOfTheMonth); 
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lblAppVariables.Text = appState; 


由 于 当前 要 销售 的 汽车 数据 由 自 定义 的 类 类 型 表示 ， 我 们 的 btnshowCar0nSsaliesalie_Click Click 
事件 处 理 程序 还 需要 如 下 进行 更 新 : 


protected void btnShowCarOnSale Click(object sender, EventArgs e) 


lblCurrCarOnSale.Text = String.Format("Sale on {0}'s today!", 
((CarLotInfo)Application["CarSiteInfo"]).CurrentCarOnSale); 


34.5.2 ”修改 应 用 程序 数据 


在 Web 应 用 程序 执行 期 间 , 可 以 使 用 HttpApplicationState 类 型 的 成 员 通 过 编程 更 新 或 删除 任何 或 
全 部 应 用 程序 级 数据 项 。 例 如 ， 要 删除 一 个 指定 项 ， 只 需要 调用 Remove() 方 法 即 可 。 如 果 你 希望 销毁 
所 有 应 用 程序 级 数据 ， 调 用 RemoveA11() : 

private void CleanAppData() 


// 通过 字符 囊 名 字 删 除 一 个 项 
Application.Remove("SomeItemIDontNeed"); 


// 销毁 全 部 应 用 程序 数据 
Application.RemoveAll(); 


如 果 你 只 希望 改变 一 个 已 存在 的 应 用 程序 级 数据 项 的 值 ， 就 只 需要 对 相应 的 数据 项 进行 新 的 赋 
值 。 假 设 页 面 现在 支持 一 个 新 的 Button 类 型 ,该 类 型 允许 用 户 通过 读 入 名 为 txtNewSP 的 TextBox 的 值 来 
用 户 改 变 当 前 的 最 佳 销 售 员 。click 事 件 处 理 程序 如 下 : 

protected void btnSetNewSP Click(object sender, EventArgs e) 

// 设置 新 的 销售 员 
((CarLotInfo)Application["CarSiteInfo"]).SalesPersonOfTheMonth 


= txtNewSP.Text; 
} 


如 果 运 行 这 个 Web 应 用 程序 ， 你 将 发 现 这 个 应 用 程序 级 数据 项 已 经 被 更 新 了 。 此 外 ， 由 于 应 用 
程序 变量 对 于 所 有 的 用 户 会 话 来 说 都 是 可 访问 的 ， 如 果 要 登录 3 个 或 4 个 Web 浏 览 器 实例 ， 那 么 当 一 
个 实例 改变 了 当前 的 销售 员 时 ， 其 他 的 每 个 浏览 器 都 会 在 回 传 时 显示 新 值 。 图 34-4 显 示 了 可 能 的 输 
出 结果 。 

需要 理解 一 点 : 如 果 出 现 一 组 应 用 程序 级 变量 必须 作为 一 个 单元 更 新 的 情况 ， 你 可 能 会 面临 数据 
损坏 的 风险 〈 当 另 一 个 用 户 企图 访问 一 个 应 用 程序 级 数据 点 时 ， 从 技术 上 讲 ， 它 可 能 被 改变 )。 你 能 
够 使 用 System.Threading 命 名 空间 的 线程 手动 锁 住 逻辑 , 但 这 个 HttpApplicationstate 类 型 有 如 下 的 两 
个 方法 一 一 Lock() 和 Unlock()， 它 们 能 够 自动 确保 线程 安全 性 : 


// 安全 访问 相关 应 用 程序 数据 

Application.Lock(); 

Application["SalesPersonOfTheMonth"] = "Maxine"; 

Application[ "CurrentBonusedEmployee"] = Application["SalesPersonOfTheMonth"]; 
Application.UnLock(); 
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图 34-4 ”显示 应 用 程序 数据 


34.5.3 ”处 理 Web 应 用 程序 的 关闭 


HttpApplicationState 类 型 可 维护 其 所 包含 项 的 值 ， 直 到 下 列 一 种 情形 发 生 : 最 新 登录 到 站 点 的 
用 户 超时 ( 或 手动 退出 ) 或 者 某 人 通过 IIS 手 动 关闭 了 站 点 。 在 每 种 情况 中 ， 都 将 自动 调用 派生 自 
HttpApplication 类 型 的 Application_End() 方 法 。 在 这 个 事件 处 理 程序 中 , 你 能 够 执行 任何 种 类 的 必要 
的 清理 代码 : 

void Application End(Object sender, EventArgs e) 


) // 向 一 个 数据 库 或 其 他 任何 需要 的 位 置 写 当前 应 用 程序 变量 





源 代码 ”AppState 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 





34.6 ”使 用 应 用 程序 缓存 


ASPNET 提 供 了 另 一 个 更 灵活 的 处 理应 用 程序 级 数据 的 方式 。 如 前 文 所 述 ，HttpApplication- 
State 对 象 内 的 值 在 Web 应 用 程序 处 于 活动 状态 并 且 正 被 访问 时 一 直 驻 留 在 内 存 中 。 然而 有 时 , 你 可 能 
只 希望 在 某 个 时 段 维护 一 些 应 用 程序 数据 。 例 如 ， 你 可 能 希望 获得 一 个 只 在 5 分 钟 内 有 效 的 ADO.NET 
DataSet。 在 这 段 时 间 过 后 ， 你 可 能 想 要 获得 一 个 最 新 的 Dataset 来 获知 可 能 的 数据 库 更 改 。 虽 然 从 技 
术 上 讲 ， 使 用 HttpApplicationstate 和 某 种 手工 监视 器 创建 这 个 结构 是 可 行 的 ， 但 是 使 用 ASPNET 应 
用 程序 缓存 可 以 使 你 的 工作 变 得 简单 。 
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顾名思义 ， 这 个 ASPNET System.Web.Caching.Cache 对 象 ( 它 可 以 通过 Context.Cache 属 性 访问 ) 
允许 你 定义 一 个 在 设 定时 间 内 可 以 被 所 有 用 户 〈 从 所 有 页 面 ) 访问 的 对 象 。 在 最 简单 的 情况 下 ， 与 绥 
存 交 互 和 与 HttpApplicationState 类 型 交互 是 一 样 的 : 


// 向 缓存 添加 一 个 项 
// 这 个 项 不 会 失效 


Context.Cache["SomeStringItem"] = "This is the string item"; 


// 从 缓存 中 获得 项 
string s = (string)Context.Cache["SomeStringItem"]; 


说 明 如 果 你 希望 在 Global.asax 内 访问 Cache， 需 要 使 用 Context 属 性 。 尽 管 如 此 ， 如 果 你 正 位 于 一 个 
派生 自 System.Web.UI.Page 的 类 型 作用 域内 , 就 能 够 通过 页 面 的 Cache 属 性 直接 访问 Cache 对 象 。 


在 类 型 索引 器 的 基础 上 ，System.Web.Caching.Cache 类 只 定义 了 很 少数 量 的 成 员 。 例 如 ，Add() 方 
法 用 来 将 一 个 当前 未 定义 的 新 项 插入 缓存 ( 如 果 这 个 指定 项 已 经 存在 了 ,Add() 就 什么 也 不 做 )。 Insert() 
方法 也 将 向 缓存 中 放置 一 个 成 员 。 然 而 ， 如 果 该 项 在 当前 已 定义 了 ，Insert() 将 用 一 个 新 的 对 象 替 换 
当前 项 。 因 为 这 是 经 常 发 生 的 行为 ， 我 将 专门 研究 Insert() 方 法 。 


34.6.1 使 用 数据 缓存 


让 我 们 看 一 个 例子 。 首 先 ， 创 建 一 个 新 的 空 网 站 项 目 Cachestate， 然 后 插 人 一 个 Web 窗 体 和 一 个 
Globalasax 文 件 。 就 像 一 个 被 HttpApplicationSstate 类 型 维护 的 应 用 程序 级 数据 项 一 样 ， 这 个 Cache 可 
以 保存 任何 派生 自 System.0bject 的 类 型 , 并 且 能 够 频繁 地 在 Application_start() 事 件 处 理 程序 内 被 填 
充 。 这 个 例子 的 目的 是 每 15 秒 自动 更 新 一 次 某 个 DataSet 的 内 容 。 这 个 Dataset 将 包含 一 组 我 们 讨论 
ADO.NET 时 创建 的 AutoLot 数 据 库 的 Inventory 表 的 记录 。 

现在 ,设置 对 AutoLotDAL.dll 的 引用 ( 见 第 21 章 )， 并 更 新 Globalasax 文 件 ， 如 下 所 示 ( 随后 分 析 
代码 ): 


<%@ Application Language="C#" %> 
<%@ Import Namespace = "AutoLotConnectedLayer"” %> 
<%@ Import Namespace = "System.Data" %> 


<script runat="server"> 
// 定义 一 个 静态 级 的 Cache 成 员 变 量 
static Cache theCache; 


void Application Start(Object sender, EventArgs e) 


// 首先 分 配 静 态 'theCache' 变量 
theCache = Context.Cache; 


// 当 启 动 应 用 程序 时 ， 在 AutoLot 数 据 库 的 Inventory 表 中 读 取 当前 记录 
InventoryDAL dal = new InventoryDAL(); 
dal.0penConnection(@"Data Source=(local)\SQLEXPRESS;" + 

"Initial Catalog=AutoLot;Integrated Security=True"); 
DataTable theCars = dal.GetAllInventoryAsDataTable(); 
dal.CloseConnection(); 
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// 现在 ， 在 缓存 中 存储 DataSet 
theCache. Insert("AppDataTable", 
theCars, 
null, 
DateTime.Now.AddSeconds(15), 
Cache.NoSlidingExpiration, 
CacheItempriority.Default, 
new CacheItemRemovedCallback(UpdateCarInventory)); 


} 


// CacheItemRemovedCallback 委 托 的 目标 
static void UpdateCarInventory(string key, object item, 
CacheItemRemovedReason reason) 


{ 
InventoryDAL dal = new InventoryDAL(); 


dal.0penConnection(@"Data Source=(local)\SQLEXPRESS;" + 

"Initial Catalog=AutoLot;Integrated Security=True"); 
DataTable theCars = dal.GetAllInventoryAsDataTable(); 
dal.CloseConnection(); 


// 现在 存储 在 缓存 中 

theCache. Insert("AppDataTable", 
theCars, 
null, 
DateTime.Now.AddSeconds(15), 
Cache.NoSlidingExpiration, 
CacheItempriority.Default, 
new CacheItemRemovedCallback(UpdateCarInventory)); 


} 

</script> 

首先 ， 注 意 我 们 定义 了 一 个 静态 的 Cache 成 员 变 量 。 理 由 是 ， 你 也 定义 了 两 个 需要 访问 Cache 对 象 
的 静态 成 员 。 回 想 一 下 ， 静 态 方法 不 访问 继承 的 成 员 ， 因 此 你 不 能 使 用 Context 属 性 。 

在 Application_start() 事 件 处 理 程序 中 ， 填 充 一 个 DataTable， 然 后 把 对 象 放置 在 应 用 程序 组 
存 内 。 你 会 想到 ，Context .Cache.Insert() 方 法 已 经 重 载 了 多 次 。 这 里 ， 为 每 个 可 能 的 参数 提供 一 个 
值 。 看 看 下 面 被 注释 掉 的 对 Insert() 的 调用 : 

theCache.Insert("AppDataTable",， // 用 来 识别 缓存 中 各 项 的 名 字 


theCars, // 放置 在 缓存 中 的 对 象 
null, // 这 个 对 象 的 任何 依赖 
DateTime.Now.AddSeconds(15), // 绝对 超时 值 
Cache.NoSlidingExpiration, // 不 要 使 用 滑动 期 限 (如 下 ) 
CacheItempriority.Default, // 缓存 项 的 权限 级 别 


// 用 于 CacheItemRemove 事 件 的 委托 
new CacheIltemRemovedCallback(UpdateCarInventory)); 


前 两 个 参数 简单 编辑 了 项 的 名 称 / 值 对 ， 第 三 个 参数 允许 定义 一 个 CacheDependency 对 象 (在 这 个 
例子 里 ， 它 是 空 的 ， 因 为 DataTable 不 依赖 任何 东西 )。 

参数 DateTime.Now.AddSeconds(15) 指 定 了 绝对 过 期 时 间 。 这 意味 着 缓存 项 将 在 15 秒 之 后 从 缓存 
中 被 完全 清除 。 绝 对 过 期 对 于 那些 需要 经 常 刷新 的 数据 项 ( 如 股票 行情 ) 来 说 ， 是 十 分 有 用 的 。 

Cache.NoslidingExpiration 参 数 指定 了 缓存 项 不 使 用 可 调 过 期 。 可 调 过 期 可 以 使 缓存 中 的 项 至 
少 保存 一 个 固定 的 时 间 。 例如 , 设置 某 个 缓存 项 的 可 调 过 期 为 60 s, 那么 它 可 以 在 缓存 中 至 少 存活 60 s。 
如 果 任 何 Web 页 面 在 这 个 时 间 内 访问 该 缓存 项 ， 时 钟 将 被 重 置 ， 该 缓存 项 可 以 再 存活 60s。 如 果 60s 
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内 没有 Web 页 面 访问 该 项 , 将 从 缓存 中 移 除 它 。 可 调 过 期 对 于 那些 生成 代价 高 (时间 上 ) 但 并 不 被 Web 
页 面 频繁 使 用 的 数据 来 说 ， 是 十 分 有 用 的 。 

注意 ， 你 不 能 同时 为 给 定 的 缓存 项 指定 绝对 过 期 和 可 调 过 期 。 设 置 绝对 过 期 时 ， 要 使 用 
Cache.NoSlidingExpiration; 设置 可 调 到 期 时 ， 要 使 用 Cache.NoAbsoluteExpiration。 最 后 ， 正 如 
UpdateCarInventory() 方 法 的 签名 所 示 , CacheItemRemovedCallback 委 托 只 能 调用 匹配 如 下 签名 的 方法 : 


void UpdateCarInventory(string key, object item, CacheItemRemovedReason reason) 

{ 

} 

至 此 ， 当 启动 应 用 程序 时 ，DataTable 就 被 填充 和 缓存 了 。 每 阳 15 秒 ，DataTable 就 被 清除 、 更 新 ， 
然后 再 插入 到 缓存 中 。 为 了 看 到 这 么 做 的 结果 ， 需 要 创建 一 个 允许 一 定 程度 的 用 户 交互 的 Page。 


34.6.2 ”修改 *.aspx 文 件 


在 图 34-5 中 可 以 看 到 ， 我 构建 了 一 个 允许 用 户 输入 必要 数据 来 向 数据 库 插入 新 记录 的 UI ( 通过 4 
个 TextBox 控 件 )。 这 一 个 Button 控 件 的 Click 事 件 将 处 理 数据 库 操 作 。 最 后 ， 除 了 一 些 描 述 性 的 Label 控 
件 外 ， 页 面 底部 的 Gridview 将 用 来 显示 Inventory 表 中 的 当前 记录 。 
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[& besign ] Sp Source glaivs] <asp:GndViewecarsGridView > | 
图 34-5 ”缓存 应 用 程序 GUI 


在 页 面 的 Load 事 件 处 理 程序 中 , 配置 Gridyview 以 显示 用 户 首次 访问 页 面 时 缓存 的 DataTable 的 内 容 
(确保 在 代码 文件 中 导入 了 System.Data 和 AutoLotConnectedLayer 命 名 空间 ): 
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protected void Page Load(object sender, EventArgs e) 
if (!IsPostBack) 


carsGridView.DataSource = (DataTable)Cache["AppDataTable"]; 
carsGridView.DataBind(); 
} 
在 Add This Car 按 钮 的 Click 事 件 处 理 程序 里 , 使 用 InventoryDAL 类 型 向 AutoLot 数 据 库 中 插入 新 的 
记录 。 一旦 插入 了 记录 ， 调 用 名 为 RefreshGrid() 的 辅助 函数 ， 它 将 更 新 UI: 
protected void btnAddCar Click(object sender, EventArgs e) 
// 更 新 Inventory 表 ， 调 用 RefreshGrid() 
InventoryDAL dal = new InventoryDAL(); 
dal.OpenConnection(@"Data Source=(local)\SQLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 
dal.InsertAuto(int.Parse(txtCarID.Text), txtCarColor.Text, 
txtCarMake. Text, txtCarPetName.Text); 
dal.CloseConnection(); 
RefreshGrid(); 
} 


private void RefreshGrid() 


InventoryDAL dal = new InventoryDAL(); 
dal.0penConnection(@"Data Source=(local)\SQLEXPRESS;" + 
"Initial Catalog=AutoLot;Integrated Security=True"); 
DataTable theCars = dal.GetAllInventoryAsDataTable(); 

dal.CloseConnection(); 


carsGridView.DataSource = theCars; 
carsGridView.DataBind(); 


} 

现在 , 为 了 测试 缓存 的 使 用 ， 首 先 运 行当 前 的 程序 ( Ctrl+F5 ) 并 且 将 浏览 器 中 的 URL 复 制 到 剪贴 
板 上 。 然 后 ， 运 行 第 二 个 IE 浏 览 器 的 实例 (使 用 Start 按 钮 ) 并 且 将 URL 粘 贴 到 这 个 实例 上 。 现 在 我 们 
应 该 有 两 个 Web 浏 览 器 的 实例 ， 都 查看 了 Defaultaspx 并 显示 了 相同 的 数据 。 

在 浏览 器 的 一 个 实例 中 ， 新 增 一 个 汽车 条 目 。 很 明显 ， 可 以 从 更 新 后 的 Gridyview 上 看 到 结果 ， 并 
且 浏览 器 也 回 发 了 。 

在 第 二 个 浏览 器 实例 中 ， 单 击 Refresh 按 钮 (F5 )。 看 不 见 新 的 项 ， 因 为 Page_Load 事 件 处 理 程序 正 
在 直接 从 缓存 中 读 取 。( 如 果 你 确实 看 见 了 这 个 值 ， 那 么 15 秒 已 经 到 期 了 。 刻 击 快 一 点 或 增加 时 长 都 
可 以 使 DataTable 驻 留 在 缓存 中 。) 等 待 几 秒 , 然后 从 第 二 个 浏览 器 实例 中 再 次 单 击 Refresh 按 钮 。 现 在 ， 
你 将 看 到 新 的 项 了 ， 因 为 缓存 内 的 DataTable 已 经 过 期 并 且 CacheItemRemovedCallback 委 托 目 标 方法 已 
经 自动 更 新 了 缓存 的 DataTable。 

可 见 ，Cache 类 型 的 主要 优点 是 ， 它 能 确保 当 一 个 成 员 被 删除 后 有 机 会 做 出 反应 。 在 这 个 例子 中 ， 
你 当然 能 够 避免 使 用 Cache， 只 是 让 Page_Load() 事 件 处 理 程 序 始终 直接 从 AutoLot 数 据 库 中 读 取 数据 
〈 但 这 比 缓存 方法 慢 )。 不 过 ， 有 一 点 应 该 清楚 : 缓存 允许 使 用 .NET 委托 自动 刷新 数据 。 





源 代码 ”CacheState 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 
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34.7 ”维护 会 话 数 据 


对 应 用 程序 级 数据 和 缓存 数据 的 介绍 就 到 这 里 。 接 下 来 ,我们 讨论 按 用 户 存储 数据 的 作用 。 像 先 
前 提 过 的 ， pe ( session ) 就 是 给 定 用 户 与 Web 应 用 程序 之 间 的 交互 ,会 话 由 HttpSessionState 对 象 表 
示 。 为 了 维护 一 个 特定 用 户 的 状态 信息 ， 可 以 使 用 网 页 类 或 Global.asax 中 的 Session 属 性 。 在 线 购物 车 
是 必须 按 用 户 维 护 数据 的 典型 例子 。 如 果 10 个 人 全 部 登录 到 一 个 在 线 商 场 ， 每 个 个 体 都 将 有 一 组 她 
(他 ) 想 要 购买 的 项 并 且 这 个 数据 需 维护 。 

当 新 的 用 户 登 录 到 Web 应 用 程序 时 ，.NET 运 行 库 将 自动 给 这 个 用 户 分 配 一 个 唯一 的 会 话 ID, 用 来 
识别 这 个 用 户 。 每 个 会 话 ID 被 分 配 一 个 自 定义 的 HttpSessionState 类 型 实例 ， 以 保存 该 用 户 的 数据 。 
插入 或 获取 会 话 数据 与 操作 应 用 程序 数据 从 语法 上 来 说 是 一 样 的， 例如 : 

// 为 当前 用 户 添加 /获取 一 个 会 话 

Session["DesiredCarColor"] = "Green"; 

string color = (string) Session["DesiredCarColor"]; 

在 Global.asax 中 ， 人 允许 通过 Session_Start() 和 Session_End() 事 件 处 理 程序 来 拦截 会 话 的 起 始点 和 
结束 点 。 通 过 Session_Start(), 你 可 以 随意 创建 用 户 的 数据 项 ,而 Session_End() 人 允许 在 用 户 会 话 结 束 
时 执行 任何 想 执 行 的 任务 : 

<%@ Application Language="C#" %> 

void Session Start(Object sender, EventArgs e) 

| 


void Session End(Object sender, EventArgs e) 


{ 
// 用 户 登 出 /超时 。 如 果 需 要 ， 就 销 裔 


就 像 应 用 程序 状态 一 样 , 会 话 状态 会 保存 任何 派生 自 System.0bject 的 类 型 , 包括 自 定 义 类 。 例如 ， 
假设 你 拥有 一 个 新 的 空 网 站 项 目 (名 为 SessionState )， 它 定义 了 名 为 UserShoppingCart 的 辅助 类 ， 如 下 
所 示 : 

public class UserShoppingCart 


public string DesiredCar { get; set; }; 
public string DesiredCarColor { get; set; }; 
public float DownPayment { get; set; }; 
public bool IsLeasing { get; set; }; 

public DateTime DateOfPickUp { get; set; }; 


public override string ToString() 


return string.Format 
("Car: {0}<br>Color: {1}<¢br>$ Down: {2}<br>Lease: {3}<br>Pick-up Date: {4}", 
DesiredCar, DesiredCarColor, DownPayment, IsLeasing, 
DateOfPickUp.ToShortDateString()); 
} 
} 
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现在 ,插入 Global.asax 文 件 。 在 这 个 session_Start() 事 件 处 理 程序 中 ， 你 现在 能 够 分 配给 每 个 用 
户 一 个 新 的 UserShoppingCart 类 的 实例 ， 如 下 所 示 : 
void Session Start(Object sender, EventArgs e) 


Session["UserShoppingCartInfo"]= new UserShoppingCart(); 


当 用 户 浏览 完 所 有 Web 页 面 时 ， 你 可 以 获取 UserShoppingCart 实 例 ， 然 后 用 针对 每 个 用 户 的 具体 
数据 填充 该 实例 的 字段 。 例 如 ， 假 设 有 一 个 简单 的 *.aspx 页 面 ， 它 定义 了 一 组 输入 控件 ， 分 别 对 应 于 
UserShoppingCart 类 型 的 每 个 字段 .一 个 用 于 设置 值 的 Button 和 两 个 用 来 显示 用 户 会 话 ID 和 会 话 信 息 的 
Label ( 如 图 34-6 所 示 )。 


De ep 7 i 
Fun with Session State 
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图 34-6 会话 应 用 程序 GUI 


Button 控 件 的 服务 器 端 Click 事 件 处 理 程序 非常 简单 ( 从 TextBox 中 把 值 取 出 ， 然 后 在 一 个 Label 控 
件 上 显示 购物 车 数据 ): 


protected void btnSubmit Click(object sender, EventArgs e) 


// 设置 当前 用 户 设 定 

UserShoppingCart cart = 
(UserShoppingCart)Session["UserShoppingCartInfo"]; 

cart.dateOfPickUp = myCalendar.SelectedDate; 


cart.DesiredCar = txtCarMake.Text; 
cart.DesiredCarColor = txtCarColor.Text; 34 
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cart.DownPayment = float.Parse(txtDownPayment.Text); 
cart.IsLeasing = chkIsLeasing.Checked; 
lblUserInfo.Text = cart.ToString(); 
Session["UserShoppingCartInfo"] = cart; 


} 

在 Session_End() 中 ， 你 可 能 希望 把 UserShoppingCart 字 段 的 值 持 久保 存在 数据 库 或 者 其 他 地 方 。 
( 然而， 在 本 章 结束 的 部 分 我 们 会 看 到 ，ASP.NET 用 户 配置 API 会 自动 完成 这 些 。) 同样 ,我 们 可 能 希 
望 实现 Session_Error() 来 捕获 任何 错误 输入 (或 者 可 以 在 Default.aspx 页 面 中 使 用 各 种 验证 控件 来 处 理 
这 样 的 用 户 错 误 )。 

不 管 怎 么 样 ， 如 果 启 动 两 个 或 三 个 你 喜欢 的 浏览 器 实例 指向 相同 URL ( 像 数据 缓存 示例 一 样 进行 复 
制 、 粘 贴 操 作 ) ， 你 就 会 发 现 每 个 用 户 都 可 以 构建 映射 到 其 唯一 的 HttpSessionstate 实 例 的 购物 车 。 


HttpSessionState 的 其 他 成 员 


HttpSessionState 类 在 类 型 索引 器 上 定义 了 一 些 其 他 成 员 。 首 先 ，SessionID 属 性 将 返回 当前 用 户 
的 唯一 ID。 如 果 要 查看 本 例 中 自动 赋值 的 会 话 ID， 可 以 像 下 面 这 样 处 理 页 面 的 Load 事 件 : 


protected void Page Load(object sender, EventArgs e) 


lblUserID.Text = string.Format("Here is your ID: {0}", 
Session.SessionID); 


Remove() 和 RemoveAl1() 方 法 可 以 用 来 清除 用 户 的 HttpSessionstate 实 例 的 项 ， 例 如 : 

Session.Remove("SomeItemWeDontNeedAnymore" ); 

HttpSessionState 类 型 也 定义 了 一 组 控制 当前 会 话 的 过 期 策略 的 成 员 。 在 HttpSessionSstate 对 象 销 
筑前 ,假定 默认 每 个 用 户 拥有 20 分 钟 的 静止 状态 。 这 样 ， 如 果 一 个 用 户 进入 Web 应 用 程序 ( 因此 获得 
一 个 唯一 的 会 话 ID )， 但 是 没有 在 20 分 钟 内 返回 到 站 点 ， 运 行 库 将 假设 用 户 不 再 感 兴趣 并 且 销 毁 那 个 
用 户 的 所 有 会 话 数 据 。 使 用 Timeout 属 性 可 以 逐个 用 户 地 改变 这 个 默认 的 20 分 钟 过 期 时 间 。 这 个 设置 通 
常 位 于 Session_Start() 方 法 的 作用 域内 ， 如 下 所 示 : 


void Session Start(Object sender, EventArgs e) 
// 每 个 用 户 有 5 分 钟 的 静止 时 间 
Session.Timeout = 5; 


Session["UserShoppingCartInfo"] 
= new UserShoppingCart(); 


说 明 ”如果 你 不 需要 改变 每 个 用 户 的 Timeout 值 ， 可 以 通过 web.config 文 件 内 <sessionState> 元 素 的 
timeout 特 性 为 所 有 用 户 改变 默认 的 20 分 钟 设置 ( 详 见 本 章 末 尾 )。 


Timeout 属 性 的 优点 是 你 可 以 为 每 个 用 户 分 别 分 配 特 定 的 超时 值 。 例 如 ， 想 象 你 已 经 创建 了 一 个 
Web 应 用 程序 ， 它 允许 用 户 支付 现金 获得 一 定 级 别 的 会 员 资格 。 你 可 能 说 金 卡 成 员 应 该 允许 一 个 小 时 
的 超时 ， 但 普通 成 员 应 该 只 允许 30 秒 。 这 个 假设 遇 到 了 问题 ， 如 何在 Web 访 问 那 边 保存 用 户 特定 的 信 
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息 (例如 当前 会 员 级 别 ) ? 一 个 可 能 的 答案 是 通过 HttpCookie 类 型 的 用 户 。( 这 里 谈 到 了 cookie…… ) 


源 代码 ”SessionState 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 


34.8 cookie 


这 里 研究 的 最 后 一 个 状态 管理 技术 是 在 cookie 内 保持 数据 的 动作 ， 它 总 是 在 用 户 的 计算 机 上 呈现 
为 一 个 文本 文件 ( 或 文件 集 )。 当 用 户 登 录 到 一 个 给 定 站 点 时 ， 浏 览 器 检查 用 户 的 机 器 是 否 有 一 个 相 
应 的 URL 的 cookie 文 件 ， 如 果 有 ， 会 将 这 个 数据 追加 到 HTTP 请 求 中 。 

然后 负责 接收 的 服务 器 端 网 页 就 能 够 读 取 cookie 数 据 ， 创 建 一 个 可 能 适合 当前 用 户 偏好 的 GUI。 
相信 你 已 经 注意 到 ， 当 你 访问 最 喜欢 的 站 点 时 ， 它 竟然 知道 你 希望 看 到 的 内 容 。( 部 分 ) 原因 是 由 于 
存储 在 你 的 电脑 中 的 cookie， 其 中 包含 了 指定 网 站 的 信息 。 


说 明 cookie 文件 的 确切 位 置 取决 于 所 使 用 的 浏览 器 和 操作 系统 。 


给 定 cookie 文 件 的 内 容 将 由 于 URL 的 不 同 而 发 生 明 显 变化 ， 但 是 说 记 : 它们 最 终 都 是 文本 文件 。 
因此 , 当 你 希望 维护 关于 当前 用 户 的 敏感 信息 时 ( 例如 信用 卡号 、 密 码 等 ), cookie 是 一 个 可 怕 的 选择 。 
即使 你 花 时 间 加 密 数据 ， 狭 独 的 黑客 仍 能 够 破解 这 些 值 并 且 恶 意 利 用 。 但 无 论 如 何 ，cookie 在 Web 
应 用 程序 的 开发 中 都 扮演 着 重要 角色 ， 所 以 下 面 研 究 ASPNET 如 何 处 理 这 个 特殊 的 状态 管理 技术 。 


34.8.1 创建 cookie 


首先 理解 一 点 ，ASPNET cookie 既 可 以 配置 成 永久 的 也 可 以 配置 成 临时 的 。 一 个 持久 的 cookie 通 
常 当成 是 cookie 数 据 的 传统 定义 ， 因 为 名 称 / 值 对 集 在 物理 上 保存 在 用 户 的 硬盘 。 临 时 的 cookie (术语 
也 称 为 会 话 cookie ) 与 持久 的 cookie 包 含 同 样 的 数据 ， 但 是 名 称 / 值 对 从 不 保存 在 用 户 的 硬盘 中 ， 它 们 
仅 存在 于 HTTP 首 部 里 。 一 旦 用 户 关闭 浏览 器 ， 包 含 在 会 话 cookie 内 的 所 有 数据 都 被 销毁 。 

System.Web.HttpCookie 类 型 是 表示 (永久 的 和 临时 的 ) cookie 数 据 的 服务 器 端的 类 。 当 希望 在 网 
页 代码 中 创建 一 个 新 的 cookie 时 ， 可 以 访问 Response.Cookies 属 性 。 一 旦 这 个 新 的 HttpCookie 插 和 人 到 内 
部 集合 内 ， 名 称 / 值 对 就 跟随 HTTP 首 部 返回 到 浏览 器 。 

为 了 直接 查看 cookie 行 为 ， 创 建 一 个 新 的 空 网 站 项 目 ( CookieStateApp )， 然 后 如 创建 如 图 34-7 所 
示 的 第 一 个 Web 窗 体 〈 需要 你 插入 ) 的 UI。 

在 第 一 个 按钮 的 Click 事 件 处 理 程 序 内 ， 创 建 一 个 新 的 HttpCookie ， 并 且 把 它 插入 到 由 
HttpRequest.Cookies 属 性 提供 的 Cookie 集 合 里 。 注 意 ， 数 据 将 不 持久 在 用 户 的 硬盘 里 ， 除 非 你 明确 
使 用 HttpCookie.Expires 属 性 设置 一 个 到 期 日 。 这 样 ， 下 列 代码 将 创建 一 个 临时 的 cookie， 当 用 户 关 
闭 浏 览 器 时 被 销毁 : 


protected void btnCookie Click(object sender, EventArgs e) 


E 
// 创建 一 个 新 的 (临时 的 ) cookie 
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HttpCookie theCookie = 
new HttpCookie(txtCookieName.Text, 
txtCookieValue.Text); 
Response.Cookies.Add(theCookie); 


} 
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图 34-7 CookieStateApp 的 UI 
然而 下 列 代码 将 生成 一 个 从 今天 起 3 个 月 后 过 期 的 持久 性 cookie: 


protected void btnCookie Click(object sender, EventArgs e) 


HttpCookie theCookie = 
new HttpCookie(txtCookieName.Text, 
txtCookieValue.Text); 


theCookie.Expires = DateTime.Now.AddMonths(3); 
Response.Cookies.Add(theCookie); 


34.8.2” 读 取 传 入 的 cookie 数 据 


回想 一 下 ， 当 导航 到 一 个 以 前 访问 过 的 页 面 时 ， 浏 览 器 是 负责 访问 持久 化 cookie 的 实体 。 如 果 浏 
览 器 决定 向 服务 器 发 送 cookie, 需 要 通过 HttpRequest.Cookies 属 性 访问 *.aspx 页 面 中 传人 的 数据 。 举 例 说 
明 ， 实 现 第 二 个 按钮 的 Click 事 件 处 理 程序 : 
protected void btnShowCookie Click(object sender, EventArgs e) 
: string cookieData = ""; 
foreach (string s in Request.Cookies) 


cookieData += 


string.Format("<li><b>Name</b>: {0}, <b>Value</b>: {1}</1i>", 
s, Request.Cookies[s].Value); 


lblCookieData.Text = cookieData; 


} 
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如 果 现 在 运行 这 个 应 用 程序 并 且 单 击 新 的 按钮 ， 你 将 发 现 cookie 数 据 已 经 真正 地 被 浏览 器 发 送 了 
并 且 可 以 在 服务 器 端 *.aspx 代 码 中 成 功 访问 。 


源 代码 ”CookieStateApp 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 


34.9 “sessionSstate> 元 素 的 作用 


至 此 ， 我们 已 经 研究 了 各 种 记 住 用 户 信 息 的 方式 。 我 们 已 经 看 到 了 ， 维 护 视图 状态 和 应 用 程序 、 
缓存 、 会 话 以 及 cookie 数 据 的 方式 (通过 类 索引 器 ) 都 差不多 。 我 们 还 看 到 了 ，Global.asax 的 方法 通 
常用 于 在 Web 应 用 程序 生命 周期 中 对 事件 进行 拦截 和 响应 。 

默认 情况 下 ，ASP.NET 会 存储 进程 中 的 会 话 状态 。 好 处 是 可 以 尽快 访问 信息 。 然 而 ， 缺 点 是 如 果 
应 用 程序 域 月 省 了 【不 管 什么 原因 ) ， 用 户 的 所 有 状态 数据 就 没有 了 。 此 外 ， 如 果 我 们 以 进程 中 *.dll 
方式 保存 数据 的 话 ， 就 不 能 和 联网 Web 场 进行 交互 。 如 果 我 们 的 Web 应 用 程序 由 一 个 Web 服 务 器 承载 
的 话 , 这 个 默认 的 存储 方式 就 可 以 。 然而 , 你 可 能 会 想 , 这 个 模型 对 于 Web 服 务 器 场 来 说 不 是 很 理想 ， 
因为 会 话 状 态 会 仅仅 局 限 在 某 个 应 用 程序 域 中 。 


34.9.1 在 ASP.NET 会 话 状态 服务 器 中 保存 会 话 数 据 


在 ASP.NET 下 ， 我 们 可 以 让 运行 库 在 叫做 ASP.NET 会 话 状态 服务 器 ( aspnet state.exe ) 的 辅助 进 
程 中 承载 会 话 状 态 *.dll。 这 样 的 话 ， 我 们 就 可 以 把 *.dll 从 aspnet_wp.exe 拆 分 到 单独 的 *.exe 中 ， 它 可 以 
位 于 Web 场 的 任何 机 器 上 。 即使 我 们 希望 在 和 Web 服 务 器 相同 的 机 器 上 运行 aspnet_state.exe 进 程 , 我 们 
也 可 以 获得 把 状态 数据 划分 在 单独 进程 中 的 优势 ( 因为 这 样 能 更 持久 ) 。 

要 使 用 会 话 状态 服务 器 ， 第 一 步 就 是 启动 目标 机 器 上 的 aspnet state.exe Windows 服 务 。 只 要 在 
Developer Command Prompt 窗 口中 输入 下 面 的 代码 就 可 以 了 : 

net start aspnet state 

或 者 , 我 们 可 以 从 控制 面板 中 的 管理 工具 文件 夹 使 用 服务 小 程序 来 启动 aspnet_state.exe, 如 图 34-8 
所 示 。 
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图 34-8 ”使 用 服务 小 程序 开启 aspnet_state.exe 
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这 个 方式 最 主要 的 优势 是 ， 我 们 可 以 使 用 Properties 窗 口 配 置 aspnet state.exe， 让 它 在 机 器 启动 的 
时 候 自动 启动 。 不 管 怎么 样 ， 只 要 会 话 服务 器 在 运行 ， 就 需要 按 如 下 所 示 为 web.config 文 件 增加 
<sessionState> 元 素 : 


<System.web> 
<sessionState 
mode="StateServer" 
stateConnectionString="tcpip=127.0.0.1:42626" 
sqlConnectionString="data source=127.0.0.1;Trusted Connection=yes" 
cookieless="false" 
timeout="20" 
/> 
¢/system.web> 
就 这 么 简单 ! 至 此 ，CLR 就 可 以 在 aspnet_state.exe 中 承载 会 话 相 关 的 数据 了 。 这 样 ， 如 果 承 载 Web 
应 用 程序 的 应 用 程序 域 崩 演 了 ,会话 状态 就 会 保留 下 来 。 还 要 注意 ，<sessionState> 元 素 还 可 以 支持 
stateConnectionstring 特 性 。 默 认 的 TCP/P 地 址 值 ( 127.0.0.1 ) 指向 本 机 。 如 果 希 望 让 .NET 运 行 库 使 
用 另 一 个 联网 机 器 上 的 aspnet_state.exe 服 务 ( 同样 ， 考 虑 一 下 Web 场 )， 完 全 可 以 更 新 这 个 值 。 


34.9.2 ”把 会 话 数 据 保存 在 专门 的 数据 库 中 


最 后 ， 如 果 需 要 Web 应 用 程序 具有 高 度 的 隔离 性 和 持久 性 ， 可 以 让 运行 库 把 所 有 的 会 话 状态 数据 
都 保存 在 微软 SQL Server 中 。 对 于 web.config 的 更 新 相当 简单 : 


<sessionState 
mode="SQLServer" 
stateConnectionString="tcpip=127.0.0.1:42626" 
sqlConnectionString="data source=127.0.0.1;Trusted Connection=yes" 
cookieless="false" 
timeout="20" 

/> 


然而 ， 在 尝试 运行 相关 的 Web 应 用 程序 之 前 ， 我 们 需要 确保 目标 机 器 ( 由 sqlConnectionString 特 
性 指定 ) 已 经 进行 了 正确 的 配置 。 安 装 .NET Framework 4.5 SDK ( 或 适当 的 Visual Studio ) 的 时 候 ， 我 
们 会 得 到 两 个 文件 InstallSqlState.sql 和 UninstallSqlState.sql ， 它 们 默认 位 于 C:\Windows\Microsoft.NET\ 
Framework\<version> 下。 在 目标 机 器 上 ， 我们 必须 使 用 诸如 微软 SQL Server Management Studio ( 微软 
SQL Server 自 带 的 ) 的 工具 来 运行 InstallSqlState.sql 文 件 。 

在 运行 InstallSqlState.sqt 之 后 ， 我 们 就 会 发 现 创 建 了 一 个 新 的 SQL Server 数 据 库 ( ASPState )， 
它 包 含 了 许多 由 ASPNET 运 行 库 调 用 的 存储 过 程 以 及 一 组 用 于 存储 会 话 数 据 本 身 的 表 ( 同样 ， 为 了 
交换 数据 ，tempdb 数 据 库 也 新 增 了 一 组 表 )。 你 可 能 会 狂想， 配置 Web 应 用 程序 把 会 话 数据 保存 在 
SQL Server 中 是 所 有 选项 中 最 慢 的 一 种 。 但 是 其 优势 是 用 户 数据 是 非常 持久 的 (即使 Web 服务 咒 重 
新 启动 )。 





说 明 如 果 你 使 用 ASPNET 会 话 状态 服务 器 或 SQL Server 来 保存 会 话 数据 的 话 ， 必 须 确保 任何 放 在 
HttpSessionState 中 的 自 定义 类 型 都 标记 了 [Serializable] 特 性 。 
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34.10 ASPNET 用 户 配 置 API 


到 这 里 ,我 们 已 经 研究 了 许多 能 让 我 们 记 住 用 户 级 别 或 应 用 程序 级 别 数据 的 技术 。 但 是 ,许多 网 
站 需要 具备 跨 会 话 持 久 用 户 信息 的 能 力 。 例 如 ， 可 能 需要 为 用 户 提供 在 网 站 上 构建 账号 的 能 力 ， 需 要 
跨 会 话 持久 化 ShoppingCart 类 的 实例 ( 对 于 网 上 商店 网 站 ) 也 可 能 希望 持久 化 基本 的 用 户 喜好 ( 主 
题 等 )。 

虽然 我 们 可 以 构建 自 定义 的 数据 库 ( 以 及 一 些 存储 过 程 ) 来 保存 此 类 信息 ， 而 且 还 需要 构建 自 定 
义 代 码 库 来 和 这 些 数据 库 对 象 进行 交互 。 这 不 是 一 个 复杂 的 任务 ， 但 是 不 管 怎么 样 我们 需要 自己 实现 
这 样 的 基础 设施 。 

为 了 简化 这 个 事情 ，ASP.NET 自 带 了 现成 的 用 户 配 置 管 理 API 以 及 数据 库 系统 来 解决 这 个 问题 。 
除了 提供 必要 的 基础 设施 ， 用 户 配 置 API 还 允许 我 们 直接 在 web.config 文 件 中 定义 要 保存 的 数据 ( 为 了 
简单 )。 然 而 ,我 们 也 可 以 持久 保存 任何 [Serializable] 类 型 。 在 我 们 进行 深入 研究 之 前 先 来 看 看 用 户 
配置 API 会 把 指定 数据 保存 在 哪里 。 


34.10.1 ASPNETDB.mdf 数 据 库 


每 一 个 使 用 Visual Studio 构 建 的 ASPNET 网 站 都 自动 提供 了 一 个 App_Data 子 目录 。 默 认 情 况 下 ， 
用 户 配 置 API (以 及 其 他 诸如 ASPNET 角 色 成 员 管 理 API 等 服务 ) 被 配置 为 使 用 本 地 的 叫 
ASPNETDB.mdf 的 SQL Server 数 据 库 ， 这 个 数据 库 位 于 App_Data 文 件 夹 中 。 这 个 默认 行为 在 当前 机 
需 .NET 安 装 目录 中 的 machine.config 文 件 中 进行 配置 。 其 实 ， 如 果 代 码 使 用 任何 需要 App_Data 文 件 夹 
的 ASPNET 服 务 的 话 ，ASPNETDB.mdf 数 据 文件 都 会 在 不 存在 副本 的 时 候 自 动 创建 。 

如 果 你 更 希望 ASPNET 运 行 库 和 位 于 其 他 网 络 计算 机 的 ASPNETDB.mdf 进 行 通信 ， 或 者 希望 在 
SQL Server 7.0 ( 或 更 高 版 本 ) 实例 上 安装 这 个 数据 库 ， 就 需要 使 用 aspnet_regsql.exe 命 令 行 工具 来 手动 
构建 ASPNETDB.mdf。 和 其 他 好 的 命令 行 工 具 相 似 ，aspnet_ regsql.exe 提 供 了 许多 选项 ， 然 而 ， 如 果 我 
们 按 如 下 所 示 不 带 参数 运行 这 个 工具 (通过 Developer Command Prompt 窗 口 ) 的 话 : 

aspnet regsql 

就 会 启动 一 个 基于 GUI 的 向 导 来 帮助 我 们 在 所 选 机 器 上 创建 安装 SQL Server 版 本 的 ASPNETDB.mdf。 

现在 ， 假 设 我 们 的 网 站 没有 使 用 App_Data 文 件 夹 下 数据 库 的 本 地 副本 ， 最 后 一 步 就 是 更 新 
web.config 文 件 来 指出 ASPNETDB.mdf 的 确切 位 置 。 假 设 我 们 在 一 个 叫 ProductionServer 的 机 器 上 安装 
ASPNETDB.mdf。 下 面 的 (部 分 ) web.config 文 件 可 以 用 来 告诉 用 户 配置 API 在 默认 位 置 可 以 找到 必要 
的 数据 库 项 ( 你 可 以 添加 自 定义 的 web.config 来 更 改 默 认 设置 ): 


<configuration> 
<connectionStrings> 
<add name="LocalSqlServer" 
connectionString ="Data Source=ProductionServer;Integrated 
Security=SSPI;Initial Catalog=aspnetdb;" 
providerName="System.Data.SqlClient"/> 
</connectionStrings> 
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«system.web> 
<profile> 
<providers> 
<clear/> 
<add name="AspNetSqlProfileProvider" 
connectionStringName="LocalSqlServer" 
applicationName="/" 
type="System.Web.Profile.SqlProfileProvider, System.Web, 
Version=4.0.0.0, 
Culture=neutral, PublicKkeyToken=b0o3f5f7f11d50a3a"” /> 
</providers> 
</profile> 
</system.web> 
</configuration> 


和 大 多 数 *.config 文 件 相似 ,不 过 这 个 看 上 去 更 复杂 。 基 本 上 我 们 会 使 用 必要 的 数据 定义 一 个 
<connectionString> 元 素 , 后 面 是 SqlProfileProvider 的 具名 实例 ( 不管 ASPNETDB.mdf 的 物理 路 径 是 什 
么 ， 这 是 默认 使 用 的 提供 程序 )。 


ws 





说 明 为 了 简单 , 假设 只 使 用 位 于 我 们 Web 应 用 程序 的 App_Data 子 目录 中 自动 生成 的 ASPNETDB.mdb 
数据 库 。 





34.10.2 ”在 web.config 中 定义 用 户 配 置 


之 前 提 过 ， 用 户 配 置 定 义 在 web.config 文 件 中 。 这 个 方式 的 优势 是 我 们 可 以 使 用 继承 的 Profile 属 
性 以 强 类 型 形式 和 用 户 配置 交互 。 例 如 ， 新 建 一 个 叫 FunWithProfiles 的 空 网 站 ， 添 加 一 个 新 的 *.aspx 
文件 ， 然 后 打开 web.config 文 件 进 行 编辑 。 

我 们 的 目标 是 创建 一 个 用 户 配置 来 模拟 会 话 中 用 户 的 地 址 以 及 这 些 用 户 花 在 网 站 上 的 时 间 。 不足 
为 奇 ， 定 义 在 <profile> 元 素 中 的 用 户 配 置 数 据 使 用 一 组 名 称 / 数 据 类 型 对 。 考 虑 如 下 的 用 户 配置 ， 它 
创建 在 csystem.web> 元 素 区 域 中 : 


<profile> 
<properties> 
<add name="StreetAddress" type="System.String" /> 
<add name="City" type="System.String” /> 
<add name="State" type="System.String"” /> 
<add name="TotalPost" type="System.Int32" /> 
</properties> 
</profile> 


在 这 里 ， 我 们 为 用 户 配置 中 的 每 一 个 项 都 指定 了 名 字 和 CLR 数 据 类 型 ( 当然 ,我 们 也 可 以 增加 邮 
编 、 名 称 等 项 目 , 你 应 该 知道 怎么 做 了 ), 严格 地 说 , type 特 性 是 可 选 的 , 然而 默认 值 是 system.String。 
就 像 你 期 望 的 那样 ， 可 以 在 用 户 配置 条 目 中 指定 很 多 其 他 特性 ， 以 进一步 限制 这 些 信息 如 何 保存 在 
ASPNETDB.mdf 中 。 表 34-4 展 示 了 一 些 核心 特性 。 


34.10 ASPNET 用 户 配置 API 1183 


表 34-4 ”用户 配置 数据 的 部 分 特性 


特 性 示 例 值 作 用 

allowAnonymous true | false 限制 或 允许 对 值 的 匿名 访问 。 如 果 设 置 为 false， 匿 名 
用 户 就 不 能 访问 用 户 配置 值 

defaultValue String 如 果 属 性 没有 被 显 式 设置 ， 则 返回 这 个 值 

Name String 这 个 属性 的 唯一 标识 

Provider String 用 于 管理 这 个 值 的 提供 程序 。 它 重 写 web.config 或 
machine.config 中 的 defaultProvider 

readonly true | false 限制 或 允许 写 操作 ( 默认 值 为 false， 即 不 可 读 ) 

serializeAs String | XML | Binary 持久 保存 到 数据 库 中 时 值 的 格式 

type 基本 类 型 | 用户 定义 的 类 型 .NET 基 本 类 型 或 类 。 类 名 必须 完全 限定 (如 MyApp. 


UserData.ColorPrefs ) 


在 修改 当前 用 户 配置 时 ,我 们 会 在 实战 中 研究 其 中 一 些 特性 。 但 是 现在 让 我 们 来 看 如 何以 编程 方 
式 访 问 这 些 数据 。 


34.10.3 ”以 编程 方式 访问 用 户 配 置 数据 


回忆 一 下 ，ASP.NET 用 户 配 置 API 的 主要 目的 是 自动 化 向 专门 数据 库 写 入 (或 者 从 中 读 取 ) 数据 
的 过 程 。 为 了 测试 ， 更 新 我 们 的 Default.aspx 文 件 的 UI 来 增加 一 组 收集 街道 地 址 、 城 市 和 用 户 状态 的 
TextBox ( 和 描述 性 的 Label )。 同 样 ， 增 加 一 个 Button 类 型 ( 命名 为 btnsubmit ) 和 最 后 一 个 Label ( 叫 
做 lblUserData )， 它 们 用 来 显示 持久 化 的 数据 ， 如 图 34-9 所 示 。 
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忆 Design | 口 Split | 回 Source H <formsforml>] <asp:Button#btnSubmit> 上 


图 34-9 FunWithProfiles Default.aspx 页 面 的 UI 
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现在 ,在 按钮 的 Click 事 件 处 理 程序 中 ,使 用 继承 的 Profile 属 性 来 根据 用 户 在 相关 的 TextBox 中 输 
入 的 内 容 来 持久 化 各 种 用 户 配 置 数据 。 在 ASPNETDB.mdf 中 每 持久 化 保存 一 个 数据 ， 就 从 数据 库 读 取 
一 个 数据 并 且 格 式 化 成 string 显 示 在 lblUserData Label 类 型 上 。 最 后 ， 处 理 页 面 的 Load 事 件 ， 并 且 在 
Label 类 型 上 显示 相同 的 信息 。 这 样 ， 当 用 户 访问 这 个 页 面 的 时 候 ， 就 可 以 看 到 它们 当前 的 设置 。 这 
里 是 完整 的 代码 文件 : 

public partial class Default : System.Web.UI.Page 

protected void Page Load(object sender, EventArgs e) 

GetUserAddress(); 
人 void btnSubmit Click(object sender, EventArgs e) 


// 这 里 发 生 数 据 库 写 入 操作 
Profile.StreetAddress = txtStreetAddress.Text; 
Profile.City = txtCity.Text; 

Profile.State = txtState.Text; 


// 从 数据 库 获 取 设 置 
GetUserAddress(); 


} 


private void GetUserAddress() 


1 昌 计 生生 业 让 计 呈 打 
lblUserData.Text = String.Format("You live here: {0}, {1}, {2}", 
Profile.StreetAddress, Profile.City, Profile.State); 
, } 

现在 运行 页 面 ， 就 会 注意 到 ， 第 一 次 请 求 Defaultaspx 的 时 候 会 有 一 段 时 间 的 延迟 。 原 因 是 
ASPNETDB.mdf 需 要 即时 创建 并 放 人 我 们 的 App_ Data 文件 夹 中 。( 我 们 也 可 以 通过 刷新 Solution 
Explorer 窗 体 并 查看 App_Data 文 件 夹 来 自行 验证 。 

我 们 还 会 发 现 ， 第 一 次 访问 这 个 页 面 的 时 候 ，lblUserData Label 没 有 显示 任何 用 户 配置 数据 ， 因 
为 我 们 还 没有 把 数据 输入 到 ASPNETDB.mdf 正 确 的 表 中 。 在 TextBox 控 件 中 输入 值 并 且 回 发 到 服务 器 之 
后 ， 我 们 就 会 发 现 Label 使 用 持久 化 的 数据 进行 格式 化 了 。 

现在 就 来 看 看 这 个 技术 最 有 趣 的 地 方 。 如 果 关 闭 浏 览 器 并 重新 打开 网 站 的 话 ， 就 会 发 现 之 前 输入 
的 用 户 配 置 数据 确实 被 持久 化 了 ， 因 为 Label1 显 示 了 正确 的 信息 。 问 题 是 ， 它 是 怎么 记 住 的 呢 ? 

对 于 这 个 示例 ， 用 户 配置 API 通 过 我 们 当前 的 登录 凭证 获取 并 使 用 了 我 们 的 Windows 网 络 标识 。 
然而 ， 如 果 构 建 的 是 公共 的 网 站 〈 用 户 不 属于 某 个 域 ) 的 话 也 没 问 题 ， 用 户 配 置 API 整 合 了 ASPNET 
表单 认证 模型 并 且 支 持 “ 匿 名 用 户 配 置 ”的 概念 ， 它 允许 我 们 为 当前 在 网 站 上 没有 活动 标识 的 用 户 持 
久 化 用 户 配 置 数 据 。 








说 明 本 书 不 会 讲述 ASP.NET 安 全 的 主题 ( 如 基于 表单 的 验证 或 匿名 用 户 配 置 )。 更 多 细节 请 参 
考 .NET Framework 4.5 SDK 文 档 。 
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34.10.4 ”分 组 用 户 配 置 数 据 并 且 持 久 化 自 定义 对 象 


在 结束 本 章 之 前 ， 再 介绍 一 下 用 户 配置 数据 是 如 何 定义 在 web.config 文 件 中 的 。 当 前 的 用 户 配置 
只 定义 了 4 个 数据 ， 并 且 直 接 由 用 户 配置 类 型 公开 。 如 果 和 希望 构建 更 复杂 的 用 户 配置 ， 可 以 将 相关 数 
据 分 组 到 独特 的 名 字 之 下 。 考 虑 如 下 的 更 新 : 


<profile> 
<properties> 
<group name ="Address"> 
<add name="StreetAddress" type="String" /> 
<add name="City" type="String" /> 
<add name="State" type="String” /> 
</group> 
<add name="TotalPost" type="Integer" /> 
</properties> 
</profile> 


这 次 我 们 定义 了 一 个 叫 Address 的 自 定义 组 来 公开 用 户 的 街道 地 址 、 城市 和 州 。 要 在 页 面 中 访问 这 
个 数据 ， 就 需要 更 新 代码 ， 通 过 指定 Profile.Address 来 获得 每 一 个 子 项 。 例 如 ， 这 里 是 更 新 后 的 
GetUserAddress() 方 法 ( Button 控 件 的 Click 事 件 处 理 程序 可 能 需要 以 相似 的 方式 进行 更 新 ): 


private void GetUserAddress() 


// 这 里 发 生 数 据 库 读 取 操作 

lblUserData.Text = String.Format("You live here: {0}, {1}, {2}", 
Profile.Address.StreetAddress, 
Profile.Address.City, Profile.Address.State); 


运行 该 示例 之 前 ， 你 需要 删除 App_Data 文 件 夹 下 的 ASPNETDB.mdf， 来 确保 数据 库 架 构 被 刷新 。 
这 样 ， 就 可 以 准确 无 误 地 运行 这 个 网 站 示例 了 。 


说 明 ”一 个 用 户 配置 可 以 有 任意 多 个 组 。 只 需要 在 <properties> 区 域 中 定义 多 个 <group> 元 素 即 可 。 


最 后 ， 值 得 指出 的 是 ， 用 户 配置 还 可 以 从 ASPNETDB.mdf 持 久 化 保存 ( 和 获取 ) 自 定 义 对 象 。 例 
如 ， 假 设 我 们 希望 构建 一 个 自 定义 类 (或 结构 ) 来 表示 用 户 的 地 址 数据 。 用 户 配置 API 的 唯一 需求 就 
是 将 类 型 标记 为 [Serializable] 特 性 ， 例 如 : 


[Serializable] 
public class UserAddress 


public string Street = string.Empty; 
public string City = string.Empty; 
public string State = string.Empty; 


有 了 这 个 类 ,用 户 配 置 定义 就 可 以 更 新 成 如 下 所 示 ( 注意 这 里 移 除 了 自 定义 组 ,但 这 不 是 必需 的 ): 


<profile> 
<properties> 
<add name="AddressInfo" type="UserAddress" serializeAs ="Binary"/> 
<add name="TotalPost" type="Integer" /> 
</properties> 
</profile> 
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如 果 为 用 户 配 置 引入 [Serializable] 类 型 ，type 特 性 就 是 要 持久 化 类 型 的 完全 限定 名 。 从 Visual 
Studio 智 能 感知 中 可 以 看 到 ， 我 们 可 以 选择 二 进 制 、XML 或 字符 串 数 据 。 既 然 已 经 把 街道 地 址 信息 封 
装 为 了 自 定义 类 类 型 ， 那么 就 需要 再 一 次 更 新 我 们 的 代码 ， 如 下 所 示 : 

private void GetUserAddress() 

// 这 里 发 生 数据 库 读 取 操 作 
lblUserData.Text = String.Format("You live here: {0}, {1}, {2}", 


profile.AddressInfo.Street, Profile.AddressInfo.City, 
Profile.AddressInfo.State); 


可 以 肯定 的 是 ， 用 户 配 置 API 还 有 很 多 内 容 这 里 没 介绍 。 例 如 ，Profile 属 性 其 实 封装 了 一 个 叫 
ProfileCommon 的 类 型 。 使 用 这 个 类 型 , 我 们 就 可 以 编程 方式 获取 某 个 用 户 的 所 有 信息 , 删除 (或 增加 ) 
用 户 配置 到 ASPNETDB.mdf、 更 新 用 户 配 置 的 某 个 方面 等 。 

同样 , 用户 配置 API 有 许多 可 扩展 点 , 可 以 允许 我 们 优化 用 户 配置 管理 器 如 何 访问 ASPNETDB.mdf 
数据 库 的 表 。 正 如 我 们 期 望 的 那样 ， 有 很 多 方式 可 以 减少 访问 数据 库 的 次 数 。 感 兴趣 的 读者 可 以 参 
考 .NET Framework 4.5 SDK 文 档 来 了 解 更 多 细节 。 


源 代码 ”FunWithProfiles 网 站 的 源 代码 位 于 Chapter 34 子 目录 下 。 





34.11 小结 


本 章 通过 研究 如 何 利用 HttpApplication 类 型 结束 了 对 ASPNET 知 识 的 学 习 。 你 已 看 到 ， 这 个 类 型 
提供 了 大 量 默认 的 事件 处 理 程序 ， 它 们 允许 截取 各 种 应 用 程序 级 和 会 话 级 的 事件 。 本 章 用 大 量 篇 幅 讲 
述 几 个 状态 管理 技术 。 其中, 视图 状态 用 来 在 向 指定 的 页 面 回 传 间 自动 重 填充 页 面 中 HTML 组 件 的 值 。 
接 下 来 介绍 了 应 用 程序 级 和 会 话 级 数据 的 区 别 、cookie 管 理 和 ASPNET 应 用 程序 缓存 。 

本 章 剩 余部 分 会 介绍 ASPNET 用 户 配置 API。 我 们 会 看 到 ， 这 个 技术 提供 了 现成 的 方案 解决 跨 会 
话 持久 化 用 户 数据 的 问题 。 使 用 网 站 的 web.config 文 件 ， 我 们 就 可 以 定义 许多 配置 文件 项 (包括 一 组 
项 以 及 [Serializable] 类 型 )， 它 们 会 被 自动 持久 化 到 ASPNETDB.mdf 中 。 
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461, 529, 729, 1095 

抽象 成 员 , 12, 168, 186, 223, 224, 225, 227, 234, 238, 253 

出 栈 , 116, 351, 532, 548, 550, 555 

初始 化 事件 , 1085 

初始 化 语法 , 102, 142, 159, 161, 162, 273, 341 

初始 类 类 型 , 727 

触发 器 ,959, 1048, 1049, 1050, 1053, 1054, 1056, 1057, 1058, 
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1075, 1078, 1081 
错误 代码 , 16, 56, 57, 201 
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Deserialize() 方 法 , 639, 642, 643, 645 

Dispose(), 394, 395, 396, 397, 398, 399, 625, 627, 659, 786 

do/while 循环 , 86, 87, 88, 692 

代码 分 离 , 1105 

代码 重用 , 144, 145, 168, 178, 412, 684 

单 文件 页 面 模型 , 1097, 1102 

导航 属性 , 765, 780, 781, 782, 785 

第 三 方 数据 提供 程序 , 657 

调用 线程 , 572, 573, 578, 606, 607, 609, 610, 611, 858, 860 

迭代 结构 , 57, 86, 713, 718 

动画 服务 , 938, 1042, 1058 

动态 程序 集 , 486, 521, 529, 555, 556, 557, 558, 560, 563, 564 

断 开 连接 层 , 658, 659, 684, 702, 703, 713, 754, 756, 757, 758, 
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对 象 初始 化 语法 , 5, 126, 160, 161, 162, 163, 167, 271, 272， 
341, 343, 353, 354, 356, 367, 380 

对 象 资 源 , 992, 1000, 1029, 1034, 1035, 1036, 1037, 1038, 
1039, 1041, 1049, 1050, 1056 

多 编程 语言 支持 , 26, 351 

多 维 数组 , 104, 105, 687 

多 线程 应 用 程序 , 19, 507, 513, 566, 576, 582, 585, 594, 595， 
598, 605 


ECMA-335, 24 

EndInvoke() 方 法 , 289, 319, 570, 571, 572, 575, 611, 860 

Entity Framework, 2, 357, 654, 686, 702, 751, 756, 757, 760, 
761, 762, 763, 764, 779, 781, 783, 786, 787, 993, 1096 

二 进 制 资源 , 762, 767, 913, 915, 1029, 1033, 1034, 1042, 
1056 
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Finalize() 方 法 , 388, 391, 392, 393, 394, 398, 403 
FlowDecision 活动 , 862, 865, 868, 869 
ForEach<T> 活 动 , 862, 870, 871 

Func<>, 301, 302, 355, 376, 377, 378, 379, 380, 402, 607 
发 行者 策略 程序 集 , 406, 443, 444 
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反射 , 5, 11, 25, 83, 104, 225, 281, 337, 342, 356, 357, 360， 
415, 449, 453, 454, 456, 457, 460, 461, 463, 464, 465, 
467, 469, 470, 472, 473, 474, 477, 478, 479, 480, 483, 
485, 486, 491, 493, 494, 495, 496, 560, 662, 674, 1061 

泛 型 集合 , 27, 257, 265, 270, 271, 273, 275, 285, 286, 369， 
596, 864, 894 

泛 型 委托 , 286, 300, 301, 313, 376, 402 

方法 组 转换 , 287, 298, 299, 307, 310, 319, 901 

访问 修饰 符 , 56, 127, 143, 147, 148, 157, 167, 212, 227, 237， 
392 

韭 泛 型 集合 , 257, 258, 260, 270, 286, 340, 366, 368, 369, 596 

分 配对 象 , 126, 128, 383, 384, 394 

封闭 类 , 336, 541 

封装 , 144 

服务 兼容 性 , 808 
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GetAllInventory(), 729, 730, 751, 879, 1102 

GetHashCode(), 67, 68, 115, 194, 195, 197, 198, 329, 341, 342, 
343, 344 

根 命名 空间 , 20, 195, 410, 411, 540, 746, 895, 912 

公共 类 型 系统 (CTS) ,2, 3, 12, 805 

公共 语言 规范 (CLS) ,2, 3, 64, 470, 475 

公共 语言 基础 设施 (CLI) ,24 

公共 语言 运行 库 (CLR) ,2, 3, 412 

共享 程序 集 , 406, 413, 430, 431, 433, 437, 439, 440, 441, 443， 
448, 461, 464, 1111 

构造 函数 , 129 

构造 函数 链 , 135, 137, 153 

关闭 事件 , 1085 

关键 成 员 , 274, 509, 560, 1044 

关键 帧 动画 , 1043, 1048 
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has-a 关系 , 145 

HttpApplication 基 类 , 1158, 1164, 1165, 1166, 1169, 1186 

核心 对 象 , 655 

黑 盒 编程 , 149 

回调 , 4, 231, 287, 297, 301, 303, 310, 573, 575, 576, 818, 
1060 

回 滚 , 697, 698, 700, 701, 705, 710 


会 话 状 态 , 1120, 1159, 1165, 1166, 1174, 1179, 1180 


ICloneable, 119, 224, 225, 228, 245, 246, 247, 258, 262, 290， 
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IComparable, 249, 250, 251, 252, 253, 269, 285, 329, 330 

IEnumerable, 87, 108, 241, 242, 243, 244, 258, 262, 264, 265, 
266, 267, 268, 269, 270, 321, 322, 339, 340, 359, 361, 
362, 365, 366, 367, 368, 376, 377, 378, 380, 596, 597, 
751, 754, 763, 793, 794 

IEnumerator, 241, 242, 243, 244, 245, 258, 264, 265, 269, 270, 
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if/else 语句 , 88 

ildasm.exe, 9, 22, 23, 24, 28, 85, 157, 261, 288, 292, 315, 343, 
383, 384, 393, 396, 418, 419, 421, 433, 438, 442, 449, 
450, 452, 454, 455, 470, 471, 474, 531, 533, 534, 536, 
539, 543, 550, 551, 589, 912 

Insert() 方 法 , 273, 321, 1170, 1171 

is-a 关系 , 145, 172 
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JIT 编译 器 , 2, 10, 415, 421, 531 

JVM (Java 虚拟 机 ) , 16 

基础 类 库 (BCL) ,3 

集合 初始 化 语法 , 271, 354 

继承 链 , 67, 192, 196, 197, 238, 284, 425, 478, 635, 760, 793， 
899, 943, 997, 1004, 1015, 1016, 1023, 1057, 1059, 1104, 
1111, 1112, 1121 

交错 数组 , 104, 105 

脚本 块 , 1093, 1102, 1108 

接口 , 223 

接口 类 型 , 12, 44, 92, 223, 224, 225, 226, 227, 228, 233, 239， 
240, 245, 253, 324, 480, 481, 482, 541, 542, 659, 701, 
808, 813, 817 

接口 实现 , 481 
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结构 化 异常 处 理 , 81, 192, 200, 201, 202, 203, 222, 229, 396， 
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进程 标识 符 (PID) , 506 

经 典 继承 , 168, 169, 180 

静态 构造 函数 , 14, 141, 142, 143, 165, 1058, 1059, 1065 

局 部 变量 , 64, 65, 66, 86 
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可 空 类 型 , 122, 123, 124 

可 扩展 标记 语言 (XAML) , 888, 908 

可 视 化 层 , 995, 996, 1022, 1025, 1027, 1028 

可 选 参数 , 4, 92, 97, 98, 99,.124, 135, 137, 402, 500, 502, 504， 
505, 546, 592, 690 

客户 端 程序 集 , 852 

客户 端 脚本 , 1084, 1091, 1092, 1102, 1121, 1123, 1124 

跨 语言 继承 , 425 

扩展 方法 , 5, 320, 336, 337, 338, 339, 340, 352, 353, 354, 355， 
356, 362, 364, 368, 370, 372, 373, 374, 375, 376, 377, 
378, 380, 491, 603, 604, 605, 752, 753, 754, 763, 777, 
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LayoutTransform 属性 , 1009, 1010, 1011, 1014, 1015 

List<T> 类 , 265, 266, 267, 268, 272, 273, 313, 355, 367, 543 

垃圾 收集 器 , 4, 19, 350, 351, 383, 387 

类 类 型 , 126, 127 

类 型 绑 定 , 705 

类 型 元 数据 , 7, 8, 10, 11, 22, 23, 28, 413, 415, 421, 422, 449， 
456, 529, 640, 1095 

立即 执行 , 364, 366, 567, 777 

路 由 策略 , 1067 

路 由 事件 , 895, 903, 943, 1057, 1066, 1067, 1068, 1070, 1082 
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Main() 方 法 ,355 一 65 
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Microsoft.SqlServerServer 658 

mscorlib.dll .程序 集 , 14, 16, 17, 21, 28, 32, 35, 138, 171, 271， 
301, 388, 401, 406, 412, 419, 430, 454, 456, 461, 466, 
517, 522, 535, 539, 552, 554, 612, 639, 866, 894, 923 
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MyTypeViewer, 456, 458, 459, 461 

冒 泡 事件 , 1067, 1068, 1069 
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枚 举 类 型 , 12, 13, 107, 110, 111, 112, 241, 266, 416, 440, 456， 
542, 543, 544, 545, 556, 560, 613 

面向 对 象 编程 (OOP) , 115, 144, 757, 1092 
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面向 服务 架构 (SOA) , 808 

命令 行 编译 器 , 29, 30, 31, 35, 41, 55, 346, 927 

命令 行 标志 , 31, 59, 480 

命令 行 参 数 ,30, 31, 34, 56, 57, 58, 59, 60, 320, 537, 538, 896， 
904, 905 

命名 参数 , 92, 98, 99, 137, 500, 502, 504, 505 

命名 和 迭代 器 , 244, 245 

命名 约定 , 224, 607, 608, 610, 611, 758, 1043 

默认 构造 函数 , 67, 114, 129, 130, 131, 132, 148, 161, 174, 
175, 176, 284, 285, 333, 343, 345, 402, 535, 559, 562, 
717, 718, 817, 910, 924, 1117, 1119 

默认 命名 空间 , 411 

目录 结构 , 436, 612, 613, 616, 1084, 1110 
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Notepad++, 29, 35, 36, 51 

内 容 页 面 , 1133, 1138, 1139, 1140, 1143 

匿名 方法 , 5, 287, 310, 311, 312, 313, 314, 315, 318, 319, 352, 
355, 377, 379, 380, 491, 596, 606, 609 

匿名 类 型 , 4, 5, 320, 340, 341, 342, 343, 344, 345, 352, 353， 
354, 355, 356, 372, 380, 486, 797 
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OfType<T>, 368, 369 


P 


Parallel.Invoke() 方 法 , 601, 603 
PrintDocument(), 10 

派生 类 , 191 

平台 调用 (PInvoke) ,388, 392, 541 
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Queue<T> 类 , 274, 275 

在 套 类 型 , 14, 147, 148, 149, 179, 180, 212, 456 

柳 套 命名 空间 , 20, 411, 540 

强 类 型 , 84, 85 

强制 转换 操作 , 79, 191, 192, 193 

全 局 程序 集 缓 存 (GAC),21,22, 36, 406, 413, 418, 430, 673， 
809 
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RenderTransform 属性 , 900, 998, 1009, 1012, 1014, 1045，, 
1052, 1079, 1081 

入 栈 , 532, 537, 548, 553, 555 

弱 类 型 , 750 
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Serialize() 方 法 ,470, 641, 645 

Silverlight, 788, 890, 894, 932, 1020 

Software Development Kit (SDK) ,29 

SortedSet<T> 类 , 275 

SQL Server Express, 38, 657, 665, 666, 673, 678 

SqlCommandBuilder, 728, 729, 732, 733 

Stack<T> 类 , 273, 532 

Storyboard, 938, 1047, 1048, 1049, 1054, 1063 

Swap<T> 方 法 , 285 

System.Array, 58, 67, 92, 97, 106, 107, 108, 111, 225, 241, 
242, 250, 253, 256, 265, 268, 340, 357, 358, 362, 368, 
373,:592 

System.Collections .Generic 命名 空间 , 19, 54, 242, 256， 
257, 259, 265; 266, 267, 268; 270; 271 272, 286, 313， 
322, 416, 417, 422, 438, 444, 446, 460, 462, 464, 476, 
477, 478, 481, 488, 543, 646, 859, 872 

System.Collections.0bjectModel 命名 空间 , 277 

System.Collections.Specialized 命名 空间 , 257, 259, 264 

System.Console, 20, 32, 55, 61, 138, 393, 459, 532, 533, 534, 
535, 536, 549, 558, 627, 866 

System.Data, 17, 19, 20, 41, 55, 211, 225, 324, 338, 356, 357, 
358, 653, 654, 655, 656, 657, 658, 659, 663, 672, 673, 
674, 675, 676, 677, 684, 687, 691, 697, 701, 702, 705, 
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System.Data.Common, 19, 655, 658, 663, 672, 673, 675, 701, 
726 

System.Data.OracleClient.dll 程序 集 , 657 

System.Data.Ssql, 19, 20, 55, 225, 357, 656, 657, 658, 663, 
672, 673, 676, 677, 684, 697, 725, 732, 740, 767, 770, 
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System.Drawing.Bitmap 类 型 , 21 1118, 1156, 1164, 1167, 1179 
System.EnterpriseServices 命名 空间 , 697, 804, 805, 809 声明 变量 , 21, 267, 354 
System.Enum 类 型 , 110, 452 实例 方法 , 115, 194, 281, 288, 293, 348, 446, 519, 558 
System.Environment 类 , 58, 59, 869, 923 实例 级 别 的 构造 函数 , 141, 142, 143 
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145, 191, 192, 193, 194, 195, 196, 197, 198, 199, 211, 数据 访问 逻辑 , 673, 684, 731, 736, 749, 1099, 1140 
224, 225, 226, 227, 228, 233, 240, 245, 256, 257, 260, 数据 库 设 计 器 , 36, 736 
261, 262, 263, 264, 269, 308, 309, 329, 331, 337, 341, 数据 适配器 , 324, 653, 654, 655, 659, 661, 664, 672, 681, 702， 
342, 343, 344, 345, 355, 356, 360, 369, 381, 391, 392, 703, 724, 725, 726, 727, 728, 729, 731, 732, 736, 738, 
393, 394, 403, 451, 452, 455, 459, 460, 461, 467, 487, 740, 743, 744, 746, 748, 749, 751, 752, 755, 756 
488, 504, 520, 534, 535, 536, 540, 541, 544, 549, 552, 数据 提供 程序 , 223, 653, 655, 656, 657, 658, 659, 660, 661, 
553, 554, 562, 570, 575, 576, 580, 583, 592, 593, 613, 662, 664, 672, 673, 674, 675, 676, 677, 678, 679, 680, 
631, 639, 642, 645, 646, 662, 900, 904, 1035, 1102, 1104, 681, 687, 697, 701, 702, 703, 713, 725, 728, 760, 761， 
1123, 1162, 1167, 1170, 1174 770, 775 
System.Reflection 命名 空间 , 51, 357, 449, 454, 456, 461， 数据 验证 例 程 , 1065 
464, 465, 466, 485, 494, 496, 519, 559 数值 数据 类 型 , 67, 69, 80, 93, 116, 122 
System. String, 14, 19, 54, 65, 67, 69, 72, 73, 75, 76, 77, 83, 数值 转换 , 331 
85, 104, 171, 197, 225, 280, 359, 456, 461, 472, 487, 488, 私有 程序 集 , 406, 413, 423, 425, 426, 427, 430, 437, 438, 439， 
544, 549, 553, 558, 562, 613, 624, 626, 773, 774, 794, 448, 456, 519, 1098, 1106, 1110 
936, 1128, 1162, 1182 隧道 事件 , 1067, 1068, 1069 
System.Threading.Tasks 命名 空间 , 595, 605, 607 索引 器 , 14, 227, 262, 273, 320, 321, 322, 323, 324, 325, 488， 
System.Threading 命名 空间 , 19, 54, 289, 416, 417, 422, 438， 662, 673, 676, 681, 708, 712, 713, 742, 750, 752, 753， 
444, 446, 459, 513, 526, 558, 566, 568, 570, 576, 577, 885, 904, 1038, 1162, 1166, 1170, 1176, 1179 
578, 579, 580, 581, 583, 584, 587, 589, 590, 592, 593, 索引 器 方法 , 320, 321, 322, 323, 324, 352, 681, 708 
594, 595, 596, 601, 603, 605, 606, 607, 610, 611, 838, 
860, 1168 下 
System.Transactions 命名 空间 , 697 
System.Web.UI.Control, 1117, 1123, 1124, 1125, 1162 TabControl, 941, 942, 970, 972, 982 
System.Web.UI.HtmlControls, 1131 TerminateWorkflow 活动 , 863, 868, 869 
System.Web.UI.WebControls, 1103, 1122, 1123, 1132, 1146, this[] 语 法 , 321 
1152 Thread.Sleep() 方 法 , 568, 587 
System.Windows.Forms.dll, 33, 34, 35, 42, 413, 464, 465, 481, TimerCallback 委托 , 577, 592 
536, 537, 552, 581, 888 ToString(), 67, 68, 77, 103, 110, 111, 115, 194, 195, 196, 197， 
System.Windows.Shapes 命名 空间 , 996 198, 203, 245, 246, 247, 263, 272, 278, 282, 283, 302, 
System.Xml.dll 程序 集 , 357, 639, 643, 788, 789, 790, 802 323, 326, 329, 332, 333, 334, 337, 341, 342, 343, 344, 
System.Xml.Linq 命名 空间 , 19, 358, 790, 791, 792, 793, 795， 350, 351, 370, 371, 372, 373, 374, 381, 382, 388, 390, 
800, 802 461, 526, 527, 553, 554, 593, 602, 630, 631, 674, 677, 
上 下 文 边界 , 506, 524, 525, 526, 527, 528, 567, 591 679, 682, 683, 694, 712, 713, 734, 747, 750, 754, 774, 
上 下 文 关键 字 , 152 775, 801, 883, 907, 932, 979, 980, 981, 1062, 1066, 1074, 
生命 周期 , 12, 67, 85, 115, 116, 381, 382, 391, 487, 506, 518, 1116, 1126, 1157, 1174, 1176 
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1192 索 引 





图 形 呈 现 服务 , 949, 995, 1016, 1028, 1042 

托管 代码 , 5, 6, 19, 28, 202, 509, 546, 1111 

托管 堆 , 75, 77, 117, 121, 195, 262, 381, 382, 383, 384, 385， 
386, 387, 388, 394, 395, 403, 531 
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Unload 事件 , 517, 523, 524, 1117, 1118, 1119 
UpdateInventory(), 729, 730 
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Visual C# Express, 29, 38, 39, 45, 46, 47, 665, 1087 
Visual State Manager, 1075 
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Windows Communication Foundation (WCF) ,447, 697, 788, 
857 

WorkflowInvoker, 857, 858, 859, 860, 861, 865, 872, 885, 886 

外 部 引用 程序 集 , 8, 506, 539 

完全 限定 名 , 21, 32, 104, 194, 195, 408, 409, 412, 455, 456， 
458, 459, 484, 535, 555, 640, 647, 648, 821, 876, 924, 
1073, 1186 

委托 , 287 一 319 

无 状态 协议 , 1085 
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宿主 应 用 程序 , 810, 826, 840 

显 式 接口 实现 , 223, 235, 236, 237, 240, 243 

显 式 类 型 , 82, 315, 320 

响应 文件 , 34, 35 

虚拟 执行 系统 (VES) ,24 

序列 化 , 11, 214, 385, 421, 449, 469, 470, 471, 506, 561, 612, 
634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 
645, 646, 647, 648, 649, 650, 651, 652, 704, 714, 715, 
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延迟 执行 , 363 
依赖 属性 , 895, 900, 923, 943, 992, 1043, 1045, 1051, 1057, 
1058, 1059, 1060, 1061, 1064, 1065, 1066, 1082 


异步 方法 , 14, 287, 289, 566, 570, 576, 593, 607, 609 

引用 程序 集 , 35, 41, 419, 438, 449, 1110 

隐 式 类 型 , 54, 82, 83, 84, 85, 86, 87, 91, 103, 315, 316, 320， 
342, 353, 354, 355, 356, 361, 362, 365, 366, 368, 372, 
378, 486, 490, 999 

隐 式 转换 , 192, 199, 237, 238, 246, 331, 332, 333, 334, 335， 
504 

应 用 程序 对 象 , 54, 55, 91, 896, 904 

语言 集成 查询 (LINQ) ,356 一 380 

元 数据 , 3, 4, 7, 8, 10, 11, 16, 23, 24, 110, 356, 357, 413, 414， 
415, 421, 432, 449, 450, 451, 452, 453, 454, 455, 456, 
460, 465, 466, 467, 468, 469, 470, 472, 473, 474, 476, 
484, 485, 494, 496, 497, 499, 502, 506, 556, 704, 712, 
728, 770, 825, 826, 851, 924, 1060, 1066 

元 数据 交换 , 823, 825, 831 

运行 时 异常 , 81, 82, 192, 200, 250, 257, 261, 275, 396, 600， 
651, 662, 685, 690, 698, 708, 710, 753, 776, 831, 849, 
864, 901, 1038 
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只 读 字段 , 14, 126, 149, 163, 164, 165, 168, 309, 343, 561， 
992, 1043, 1057, 1059 

指针 类 型 , 15, 346, 347, 352 

中 间 语 言 (IL) ,2, 7, 22, 415 

终结 器 , 14, 391, 392, 393, 394, 397, 399, 684 

重 载 操作 符 , 4, 122, 328, 330, 333, 335, 336, 352 

转换 , 991 

转 义 字 符 , 74, 75 

状态 管理 技术 , 808, 1158, 1159, 1160, 1177, 1186 

自 定 义 命 名 空间 , 195, 406, 539 

自 定义 依赖 属性 , 1058, 1059, 1060, 1061, 1070 

自 定义 状态 数据 , 575, 593 

自动 属性 , 156, 157, 158, 160, 162, 174, 333, 451, 452, 473， 
487 

组 件 对 象 模型 (COM) , 2, 804 
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一 一 最 前 沿 的 IT 类 电子 书 发 售 平台 


电子 出 版 的 时 代 已 经 来 临 。 在 许多 出 版 界 同 行 还 在 犹 物 簿 逢 的 时 候 ， 图 灵 社 区 已 经 采取 实际 行 
动 拥抱 这 个 出 版 业 巨变 。 作 为 国内 第 一 家 发 售 电子 图 书 的 IT 类 出 版 商 ， 图 灵 社 区 目前 为 读者 提供 两 种 
DRM-free 的 阅读 体验 :在线 阅 读 和 PDF。 

相 比 纸 质 书 ， 电 子 书 具 有 许多 明显 的 优势 。 它 不 仅 发 布 快 ， 更 新 容易 ， 而 且 尽 可 能 采用 了 彩色 图 
片 ( 即 使 有 的 书 纸 质 版 是 黑白 印刷 的 ) 。 读 者 还 可 以 方便 地 进行 搜索 、 剪 贴 、 复 制 和 打印 。 

图 灵 社 区 进一步 把 传统 出 版 流程 与 电子 书 出 版 业务 紧密 结合 ， 目 前 已 实现 作 译 者 网 上 交 稿 、 编 辑 
网 上 审 稿 、 按 章 发 布 的 电子 出 版 模式 。 这 种 新 的 出 版 模式 ,我 们 称 之 为 “敏捷 出 版 ”， 它 可 以 让 读者 . 
以 较 快 的 速度 了 解 到 国外 最 新 技术 图 书 的 内 容 ， 弥 补 以 往 翻 译 版 技术 书 “ 出 版 即 过 时 ”的 缺憾 。 同 
时 ， 敏 捷 出 版 使 得 作 、 译 、 编 、 读 的 交流 更 为 方便 ， 可 以 提前 消灭 书稿 中 的 错误 ， 最 大 程度 地 保证 图 
书 出 版 的 质量 。 


优惠 提示 : 现在 购买 电子 书 ， 读 者 将 获 赠 书 款 20% 的 社区 银子 ， 可 用 于 兑换 纸 质 样 书 。 


一 一 最 方便 的 开放 出 版 平台 


图 灵 社 区 向 读者 开放 在 线 写 作 功 能 ， 协 助 你 实现 自 出 版 和 开源 出 版 的 梦想 。 利 用 “合集 ”功能 ， 
你 就 能 联合 二 三 好 友 共 同 创作 一 部 技术 参考 书 ， 以 免费 或 收费 的 形式 提供 给 读者 。 ( 收费 形式 须 经 过 
图 灵 社 区 立项 评审 。 ) 这 极 大 地 降低 了 出 版 的 门槛 。 只 要 你 有 写作 的 意愿 ， 图 灵 社 区 就 能 帮助 你 实现 
这 个 梦想 。 成 熟 的 书稿 ， 有 机 会 入 选 出 版 计划 ， 同 时 出 版 纸 质 书 。 

图 灵 社 区 引进 出 版 的 外 文 图 书 ， 都 将 在 立项 后 马上 在 社区 公布 。 如 果 你 有 意 翻 译 哪 本 图 书 ， 欢 迎 
你 来 社区 申请 。 只 要 你 通过 试 译 的 考验 ， 即 可 签约 成 为 图 灵 的 译 者 。 当 然 ， 要 想 成 功 地 完成 一 本 书 的 
翻译 工作 ， 是 需要 有 坚强 的 毅力 的 。 


一 一 最 直接 的 读者 交流 平台 


在 图 灵 社 区 ,你 可 以 十 分 方便 地 写作 文章 、 提 交 勘 误 、 发 表 评 论 ， 以 各 种 方式 与 作 译 者 、 编 辑 人 
员 和 其 他 读者 进行 交流 互动 。 提 交 勘 误 还 能 够 获 赠 社区 银子 。 
你 可 以 积极 参与 社区 经 常 开 展 的 访谈 、 乐 译 、 评 选 等 多 种 活动 ， 赢 取 积 分 和 银子 ， 积 累 个 人 声望 。 
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新 重点 图 书 


本 书 重 在 介绍 Oracle 数据 库 的 性 能 调 优 方法 及 
相应 的 工作 思路 ， 但 并 不 拘泥 于 技术 细节 。 作 者 通 
过 大 量 真实 案例 ， 深 度 剖 析 了 相关 技术 原理 ， 同 时 
还 阐述 了 理论 知识 在 实践 中 的 应 用 方法 。 优 化 工作 
wt es rp na 
调 优 ， 正 所 谓 “ 思 路 是 道 ， 操 作 方法 是 技 "， 得 道 
是 极 大 的 提升 ， 也 是 DBA 的 思想 精 散 。 


DBA 的 思想 天 空 一 一 感悟 Oracle 数据 库 本 质 
书号 : 978-7-115-29443-2 

作者 : 白 鳝 储 学 荣 

定价 : 89.00 元 





Go 语言 编程 深入 浅 出 PhoneGap Unity 3D 游戏 开发 

书号 : 978-7-115-29036-6 书号 : 978-7-115-30155-0 书号 : 978-7-115-28381-8 
作者 : 许 式 伟 吕 桂 华 等 作者 : 饶 侠 张 坚 赵 莉 薄 作者 : 宣 雨 松 

定价 : 49.00 元 定价 : 59.00 元 定价 : 59.00 元 
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推荐 系统 实践 Node.js Kinect 人 机 交互 开发 实践 
书 书号 : 978- 1115-28158=6 书号 : 978-7-115-28399-3 书号 : 978-7-115-30029-4 
作者 : 项 亮 作者 : BYVoid 作者 : 吴 国 斌 李斌 间 骇 洲 
定价 : 49.00 元 定价 : 45.00 元 定价 : 39.00 元 


“要 想 玩 转 C#， 再 难 找到 比 这 本 书 更 好 的 资料 了 ! ” 
一 一 亚马逊 读 者 
“NET 与 C# 百 科 全 书 ， 每 个 C# 程 序 员 必 备 的 经 典 参 考 书 
一 一 | PROGRAMMER 
“难得 的 介绍 得 深入 浅 出 的 语言 类 图 书 ， 既 能 讲 明 自 各 种 语言 特性 ， 也 会 解释 清楚 设计 原理 及 需要 解决 的 问题 


一 一 豆 关 读者 





Pro C# 5.0 and the .NET 4.5 Framework 
Sixth Edition 


精通 C#m 


本 书 是 被 誉 为 “C# 圣 经 ”的 经 典 著作 ， 因 语言 生动 流畅 、 章 析 深 入 、 洒 盖 全 面 而 广 受 推崇 ， 畅 销 不 衰 。 曾 经 获 
得 Referenceware 编 程 图 书 大 奖 ， 并 入 选 Jolt 大 奖 提名 。 书 中 探讨 了 C# 语 言 和 .NET 平 台 的 各 种 特性 ， 包 括 面向 对 象 
编程 ， 委 托 、 事 件 和 Lambda 表 达 式 的 关系 ，LINQ 编 程 ， 多 线程 、 并 行 和 异步 编程 ，ADO.NET、WCF、WF、 
WPF 等 技术 。 新 版 更 透彻 前 述 了 C# 5.0 和 .NET 4.5 的 新 功能 。 

本 书 作者 为 世界 级 C# 专 家 、C# 超 级 畅销 书 作家 Andrew Troelsen ， 英 文 原版 一 出 即 成 为 亚马逊 销量 最 好 的 C# 图 
书 。 第 5 版 中 文 版 在 豆 闪 评分 高 达 9.1 分 ， 是 众多 C# 程 序 员 力荐 的 经 典 好 书 

不 论 是 从 零 开始 的 菜鸟 ， 还 是 小 有 水 平 的 中 级 程序 员 ， 抑 或 是 已 经 跻身 高 手 梯队 的 老 码 农 ， 都 需要 用 这 本 书 来 
武装 自己 ， 正 如 一 位 读者 所 说 ，“ 不 藏 此 书 ， 便 不 像 一 名 真正 的 C# 程 序 员 ”。 
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